Overview

Returns all of the current users recently viewed records.

Request Arguments

Name Type Description Required
module_list String Comma delimited list of modules to return recently viewed records.
Example: Accounts,Contacts
True
fields String Comma delimited list of fields to return. The field date_modified will always be returned.
Example: id,name
False
date String The date expression. Filter recently viewed records from this date. False
limit Integer A maximum number of records to return. Default is 20. False
offset Integer The number of records to skip over before records are returned. Default is 0. False
view String Fetch all the fields for a specified view. Example: record/list. False
detailedFetch Boolean Fetch all the fields from the specified view (Example: record/list). It requires the `view` parameters. False
enforceFields String A list of fields to be fetched. Example: enforceFields: name,date_entered False

Request

http://{site_url}/rest/v10/recent?module_list=Accounts%2CContacts
Note: GET endpoint parameters are passed in the form of a query string.

Response Arguments

Name Type Description
next_offset String The next offset to start fetching additional records.
records Array An array of recently viewed records.

Response

{
   "next_offset":-1,
   "records":[
      {
         "my_favorite":false,
         "following":false,
         "id":"e4213959-35cd-119b-5cd6-5342e8be16f6",
         "name":"Leila Purifoy",
         "date_entered":"2014-04-07T13:58:50-04:00",
         "date_modified":"2014-04-07T13:58:50-04:00",
         "modified_user_id":"1",
         "modified_by_name":"Administrator",
         "created_by":"1",
         "created_by_name":"Administrator",
         "doc_owner":"",
         "description":"",
         "deleted":false,
         "assigned_user_id":"seed_will_id",
         "assigned_user_name":"Will Westin",
         "team_count":"",
         "team_name":[
            {
               "id":"East",
               "name":"East",
               "name_2":"",
               "primary":true
            },
            {
               "id":"West",
               "name":"West",
               "name_2":"",
               "primary":false
            }
         ],
         "email":[
            {
               "email_address":"support62@example.biz",
               "invalid_email":false,
               "opt_out":true,
               "primary_address":false,
               "reply_to_address":false
            },
            {
               "email_address":"sales39@example.com",
               "invalid_email":false,
               "opt_out":false,
               "primary_address":true,
               "reply_to_address":true
            }
         ],
         "email1":"sales39@example.com",
         "email2":"support62@example.biz",
         "invalid_email":false,
         "email_opt_out":false,
         "email_addresses_non_primary":"",
         "salutation":"",
         "first_name":"Leila",
         "last_name":"Purifoy",
         "full_name":"Leila Purifoy",
         "title":"President",
         "facebook":"",
         "twitter":"",
         "googleplus":"",
         "department":"",
         "do_not_call":false,
         "phone_home":"(841) 469-8223",
         "phone_mobile":"(286) 010-9553",
         "phone_work":"(369) 075-2809",
         "phone_other":"",
         "phone_fax":"",
         "primary_address_street":"345 Sugar Blvd.",
         "primary_address_street_2":"",
         "primary_address_street_3":"",
         "primary_address_city":"Santa Monica",
         "primary_address_state":"NY",
         "primary_address_postalcode":"52255",
         "primary_address_country":"USA",
         "alt_address_street":"",
         "alt_address_street_2":"",
         "alt_address_street_3":"",
         "alt_address_city":"",
         "alt_address_state":"",
         "alt_address_postalcode":"",
         "alt_address_country":"",
         "assistant":"",
         "assistant_phone":"",
         "picture":"",
         "email_and_name1":"",
         "lead_source":"Trade Show",
         "account_name":"Sea Region Inc",
         "account_id":"b1cd3a55-7e84-e53b-954e-5342e85b63f1",
         "dnb_principal_id":"",
         "opportunity_role_fields":"",
         "opportunity_role_id":"",
         "opportunity_role":"",
         "reports_to_id":"",
         "report_to_name":"",
         "birthdate":"",
         "portal_name":"LeilaPurifoy5",
         "portal_active":true,
         "portal_password":true,
         "portal_password1":null,
         "portal_app":"",
         "preferred_language":"",
         "campaign_id":"",
         "campaign_name":"",
         "c_accept_status_fields":"",
         "m_accept_status_fields":"",
         "accept_status_id":"",
         "accept_status_name":"",
         "accept_status_calls":"",
         "accept_status_meetings":"",
         "sync_contact":false,
         "mkto_sync":false,
         "mkto_id":null,
         "mkto_lead_score":null,
         "_acl":{
            "fields":{

            }
         },
         "_module":"Contacts",
         "_last_viewed_date":"2014-04-07T14:43:46-04:00"
      },
      {
         "my_favorite":false,
         "following":false,
         "id":"e8f7eb6d-2647-7e57-df30-5342e83c622d",
         "name":"Draft Diversified Energy Inc",
         "date_entered":"2014-04-07T13:58:50-04:00",
         "date_modified":"2014-04-07T13:58:50-04:00",
         "modified_user_id":"1",
         "modified_by_name":"Administrator",
         "created_by":"1",
         "created_by_name":"Administrator",
         "doc_owner":"",
         "description":"",
         "deleted":false,
         "assigned_user_id":"seed_max_id",
         "assigned_user_name":"Max Jensen",
         "team_count":"",
         "team_name":[
            {
               "id":"West",
               "name":"West",
               "name_2":"",
               "primary":true
            }
         ],
         "email":[
            {
               "email_address":"dev.kid.kid@example.de",
               "invalid_email":false,
               "opt_out":false,
               "primary_address":true,
               "reply_to_address":false
            },
            {
               "email_address":"info.sales@example.co.uk",
               "invalid_email":false,
               "opt_out":false,
               "primary_address":false,
               "reply_to_address":false
            }
         ],
         "email1":"dev.kid.kid@example.de",
         "email2":"info.sales@example.co.uk",
         "invalid_email":false,
         "email_opt_out":false,
         "email_addresses_non_primary":"",
         "facebook":"",
         "twitter":"",
         "googleplus":"",
         "account_type":"Customer",
         "industry":"Education",
         "annual_revenue":"",
         "phone_fax":"",
         "billing_address_street":"111 Silicon Valley Road",
         "billing_address_street_2":"",
         "billing_address_street_3":"",
         "billing_address_street_4":"",
         "billing_address_city":"Los Angeles",
         "billing_address_state":"CA",
         "billing_address_postalcode":"26022",
         "billing_address_country":"USA",
         "rating":"",
         "phone_office":"(790) 406-0049",
         "phone_alternate":"",
         "website":"www.phonesugar.de",
         "ownership":"",
         "employees":"",
         "ticker_symbol":"",
         "shipping_address_street":"111 Silicon Valley Road",
         "shipping_address_street_2":"",
         "shipping_address_street_3":"",
         "shipping_address_street_4":"",
         "shipping_address_city":"Los Angeles",
         "shipping_address_state":"CA",
         "shipping_address_postalcode":"26022",
         "shipping_address_country":"USA",
         "parent_id":"",
         "sic_code":"",
         "duns_num":"",
         "parent_name":"",
         "campaign_id":"",
         "campaign_name":"",
         "_acl":{
            "fields":{

            }
         },
         "_module":"Accounts",
         "_last_viewed_date":"2014-04-07T14:43:36-04:00"
      }
   ]
}

Change Log

Version API Change
7.2.0 v10 Added /recent GET endpoint.