Recently created accounts API

Get recently created accounts API

GET /v2/accounts/recent/created

Description:

This API request returns the recently created accounts.

API Limit:

300 requests per minute. Client receives 429 once over the limit.

Method Details:

HTTP method: GET

Response format: JSON

Headers:

useriq-api-key: Your valid API key generated from the site settings page

Content-Type: application/json

Parameters:

The accounts may not be returned in a single API call, i.e., the results are paged. The following parameters are used to customize the paging results.

Query Parameters:

• since: optional, only return accounts created after timestamp x. x must be a UNIX formatted timestamp in milliseconds. The default is the epochMilli 1 day ago. When since=0, it is equivalent to getting all accounts.

• count: optional, specify the number of recently created accounts that are returned in one API call. Default is 500. The max can be set is 1000.

• offset: optional, this is to get the next page of results. Each request returns an offset in the response, and you’d use that offset in the next request to get the next page of results.

Response:

Status code 200:

The body contains

• result: a list of accounts along with their mapped attributes.

• success: true or false.

• total: the number of accounts.

• offset: the offset to be used in the next api call.

• has_more: true or false. When true, it means there are more accounts.

Other Status codes:

400: Bad request

401: Unauthorized

429: Too many requests

Example GET Request:

   
1. Example Request:
GET https://api.useriq.com/v2/accounts/recent/created?since=1585070536000&offset=10&count=2
Example Response
{
    "has_more": true,
    "total": 2,
    "offset": 12,
    "success": true,
    "result": [
        {
            "account_id": "6eafc20a-cf20-460c-9067-46ec1bfc24a6",
            "account_name": "Donquadtech Co",
            "created_at": "2020-11-03 17:35:10.879",
            "attributes": [
                {
                    "name": "MRR",
                    "source": "sfdc",
                    "source_variable": "mrr__c",
                    "value": "936.59",
                    "data_type": "currency",
                    "created_a": "2020-11-03 17:35:10.886",
                    "updated_at": "2020-11-03 17:35:10.886"
                },
                {
                    "name": "ARR",
                    "source": "sfdc",
                    "source_variable": "arr__c",
                    "value": "27424.75",
                    "data_type": "currency",
                    "created_a": "2020-11-03 17:35:10.892",
                    "updated_at": "2020-11-03 17:35:10.892"
                },
                {
                    "name": "Last Communication Contact",
                    "source": "sfdc",
                    "source_variable": "last_comm_contact(auto)",
                    "value": "Jeremiah Hendricks",
                    "data_type": "string",
                    "created_a": "2020-11-03 17:35:10.931",
                    "updated_at": "2020-11-03 17:35:10.931"
                },
                {
                    "name": "Account Owner",
                    "source": "sfdc",
                    "source_variable": "CSM__c",
                    "value": "Avery Knapp",
                    "data_type": "string",
                    "created_a": "2020-11-03 17:35:10.941",
                    "updated_at": "2020-11-03 17:35:10.941"
                },
                {
                    "name": "Plan Type",
                    "source": "api",
                    "source_variable": "plan_type",
                    "value": "Platinum",
                    "data_type": "string",
                    "created_a": "2020-11-03 17:35:10.957",
                    "updated_at": "2020-11-03 17:35:10.957"
                },
                {
                    "name": "Stage",
                    "source": "api",
                    "source_variable": "stage",
                    "value": "Expansion",
                    "data_type": "string",
                    "created_a": "2020-11-03 17:35:10.963",
                    "updated_at": "2020-11-03 17:35:10.963"
                },
                {
                    "name": "Account ID",
                    "source": "cvar",
                    "source_variable": "account_id",
                    "value": "6eafc20a-cf20-460c-9067-46ec1bfc24a6",
                    "data_type": "integer",
                    "created_a": "2020-11-03 17:35:10.967",
                    "updated_at": "2020-11-03 17:35:10.967"
                },
                {
                    "name": "Account Name",
                    "source": "cvar",
                    "source_variable": "account_name",
                    "value": "Elior SA",
                    "data_type": "string",
                    "created_a": "2020-11-03 17:35:10.97",
                    "updated_at": "2020-11-03 17:35:10.97"
                },
                {
                    "name": "Historical",
                    "source": "cvar",
                    "source_variable": "is_historical",
                    "value": "false",
                    "data_type": "boolean",
                    "created_a": "2020-11-03 17:35:10.974",
                    "updated_at": "2020-11-03 17:35:10.974"
                },
                {
                    "name": "Trial",
                    "source": "cvar",
                    "source_variable": "is_trial",
                    "value": "false",
                    "data_type": "boolean",
                    "created_a": "2020-11-03 17:35:10.977",
                    "updated_at": "2020-11-03 17:35:10.977"
                },
                {
                    "name": "Renewal Date",
                    "source": "api",
                    "source_variable": "renewal_date",
                    "value": "2021-05-06",
                    "data_type": "date",
                    "created_a": "2020-11-03 17:35:10.947",
                    "updated_at": "2020-12-24 06:53:27.508"
                },
                {
                    "name": "Last Communication Date",
                    "source": "sfdc",
                    "source_variable": "last_account_comm_datetime(auto)",
                    "value": "2021-03-01T06:58:14.398518Z",
                    "data_type": "timestamp",
                    "created_a": "2020-12-01 13:45:54.59",
                    "updated_at": "2021-03-15 06:58:14.399"
                }
            ]
        },
        {
            "account_id": "640df4bd-0cac-49bb-a972-d4c78f4a501f",
            "account_name": "Nam-zim Co",
            "created_at": "2020-11-03 17:35:10.758",
            "attributes": [
                {
                    "name": "MRR",
                    "source": "sfdc",
                    "source_variable": "mrr__c",
                    "value": "807.4",
                    "data_type": "currency",
                    "created_a": "2020-11-03 17:35:10.767",
                    "updated_at": "2020-11-03 17:35:10.767"
                },
                {
                    "name": "ARR",
                    "source": "sfdc",
                    "source_variable": "arr__c",
                    "value": "25186.11",
                    "data_type": "currency",
                    "created_a": "2020-11-03 17:35:10.774",
                    "updated_at": "2020-11-03 17:35:10.774"
                },
                {
                    "name": "Last Communication Contact",
                    "source": "sfdc",
                    "source_variable": "last_comm_contact(auto)",
                    "value": "Taylor Fuentes",
                    "data_type": "string",
                    "created_a": "2020-11-03 17:35:10.814",
                    "updated_at": "2020-11-03 17:35:10.814"
                },
                {
                    "name": "Plan Type",
                    "source": "api",
                    "source_variable": "plan_type",
                    "value": "Gold",
                    "data_type": "string",
                    "created_a": "2020-11-03 17:35:10.835",
                    "updated_at": "2020-11-03 17:35:10.835"
                },
                {
                    "name": "Stage",
                    "source": "api",
                    "source_variable": "stage",
                    "value": "Expansion",
                    "data_type": "string",
                    "created_a": "2020-11-03 17:35:10.841",
                    "updated_at": "2020-11-03 17:35:10.841"
                },
                {
                    "name": "Account ID",
                    "source": "cvar",
                    "source_variable": "account_id",
                    "value": "640df4bd-0cac-49bb-a972-d4c78f4a501f",
                    "data_type": "integer",
                    "created_a": "2020-11-03 17:35:10.845",
                    "updated_at": "2020-11-03 17:35:10.845"
                },
                {
                    "name": "Account Name",
                    "source": "cvar",
                    "source_variable": "account_name",
                    "value": "Touax",
                    "data_type": "string",
                    "created_a": "2020-11-03 17:35:10.849",
                    "updated_at": "2020-11-03 17:35:10.849"
                },
                {
                    "name": "Historical",
                    "source": "cvar",
                    "source_variable": "is_historical",
                    "value": "false",
                    "data_type": "boolean",
                    "created_a": "2020-11-03 17:35:10.852",
                    "updated_at": "2020-11-03 17:35:10.852"
                },
                {
                    "name": "Trial",
                    "source": "cvar",
                    "source_variable": "is_trial",
                    "value": "false",
                    "data_type": "boolean",
                    "created_a": "2020-11-03 17:35:10.856",
                    "updated_at": "2020-11-03 17:35:10.856"
                },
                {
                    "name": "Account Owner",
                    "source": "sfdc",
                    "source_variable": "CSM__c",
                    "value": "Avery Knapp",
                    "data_type": "string",
                    "created_a": "2020-11-03 17:35:10.823",
                    "updated_at": "2020-11-03 19:36:10.278"
                },
                {
                    "name": "Renewal Date",
                    "source": "api",
                    "source_variable": "renewal_date",
                    "value": "2021-07-01",
                    "data_type": "date",
                    "created_a": "2020-11-03 17:35:10.829",
                    "updated_at": "2021-02-01 06:56:53.248"
                },
                {
                    "name": "Last Communication Date",
                    "source": "sfdc",
                    "source_variable": "last_account_comm_datetime(auto)",
                    "value": "2021-02-08T07:03:11.072582Z",
                    "data_type": "timestamp",
                    "created_a": "2020-12-01 13:45:54.487",
                    "updated_at": "2021-03-03 07:03:11.072"
                }
            ]
        }
    ]
}