Get recently created users API
GET /v2/users/recent/created
Description:
This API request returns the recently created users.
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 users 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 users 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 users.
-
count: optional, specify the number of recently created users 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 users along with their mapped attributes.
-
success: true or false.
-
total: the number of users.
-
offset: the offset to be used in the next api call.
-
has_more: true or false. When true, it means there are more users.
Other Status codes:
400: Bad request
401: Unauthorized
429: Too many requests
Example GET Request:
1. Example Request:
GET https://api.useriq.com/v2/users/recent/created?since=1585070536000&offset=10&count=2
Example Response
{
"has_more": true,
"total": 2,
"offset": 12,
"success": true,
"result": [
{
"user_name": "Sophia Wood",
"user_first_name": "Sophia",
"user_last_name": "Wood",
"user_id": "7cc507b4-d7f4-45f8-bec4-c6d04a695916",
"account_id": "01fc9bc7-bb6e-404d-a42d-5ee40c2eff49",
"created_at": "2020-11-03 17:35:23.618",
"attributes": [
{
"name": "User ID",
"source": "cvar",
"source_variable": "user_id",
"value": "7cc507b4-d7f4-45f8-bec4-c6d04a695916",
"data_type": "integer",
"created_a": "2020-11-03 17:35:23.629",
"updated_at": "2020-11-03 17:35:23.629"
},
{
"name": "User Name",
"source": "cvar",
"source_variable": "user_name",
"value": "Sophia Wood",
"data_type": "string",
"created_a": "2020-11-03 17:35:23.635",
"updated_at": "2020-11-03 17:35:23.635"
},
{
"name": "Email Address",
"source": "cvar",
"source_variable": "email",
"value": "[email protected]",
"data_type": "string",
"created_a": "2020-11-03 17:35:23.641",
"updated_at": "2020-11-03 17:35:23.641"
},
{
"name": "Phone(Office)",
"source": "cvar",
"source_variable": "office_phone",
"value": "983-724-5494",
"data_type": "string",
"created_a": "2020-11-03 17:35:23.646",
"updated_at": "2020-11-03 17:35:23.646"
},
{
"name": "On Account Since",
"source": "cvar",
"source_variable": "signup_date",
"value": "2020-07-18",
"data_type": "date",
"created_a": "2020-11-03 17:35:23.651",
"updated_at": "2020-11-03 17:35:23.651"
},
{
"name": "Signup Date",
"source": "cvar",
"source_variable": "signup_date",
"value": "2020-03-16",
"data_type": "date",
"created_a": "2020-11-03 17:35:23.657",
"updated_at": "2020-11-03 17:35:23.657"
},
{
"name": "Internal",
"source": "cvar",
"source_variable": "is_internal",
"value": "false",
"data_type": "boolean",
"created_a": "2020-11-17 16:19:04.924481",
"updated_at": "2020-11-17 16:19:04.924481"
},
{
"name": "Last Communication Date",
"source": "sfdc",
"source_variable": "last_user_comm_datetime(auto)",
"value": "2021-02-15T07:05:52.862981Z",
"data_type": "string",
"created_a": "2020-12-01 14:17:56.102",
"updated_at": "2021-02-19 07:05:52.863"
}
]
},
{
"user_name": "Andrew Valdez",
"user_first_name": "Andrew",
"user_last_name": "Valdez",
"user_id": "5c1a4d6b-fa2e-4d73-8f5b-326d1f2283a3",
"account_id": "01fc9bc7-bb6e-404d-a42d-5ee40c2eff49",
"created_at": "2020-11-03 17:35:23.561",
"attributes": [
{
"name": "User ID",
"source": "cvar",
"source_variable": "user_id",
"value": "5c1a4d6b-fa2e-4d73-8f5b-326d1f2283a3",
"data_type": "integer",
"created_a": "2020-11-03 17:35:23.569",
"updated_at": "2020-11-03 17:35:23.569"
},
{
"name": "User Name",
"source": "cvar",
"source_variable": "user_name",
"value": "Andrew Valdez",
"data_type": "string",
"created_a": "2020-11-03 17:35:23.574",
"updated_at": "2020-11-03 17:35:23.574"
},
{
"name": "Email Address",
"source": "cvar",
"source_variable": "email",
"value": "[email protected]",
"data_type": "string",
"created_a": "2020-11-03 17:35:23.579",
"updated_at": "2020-11-03 17:35:23.579"
},
{
"name": "Phone(Office)",
"source": "cvar",
"source_variable": "office_phone",
"value": "528-333-682",
"data_type": "string",
"created_a": "2020-11-03 17:35:23.584",
"updated_at": "2020-11-03 17:35:23.584"
},
{
"name": "On Account Since",
"source": "cvar",
"source_variable": "signup_date",
"value": "2020-05-29",
"data_type": "date",
"created_a": "2020-11-03 17:35:23.592",
"updated_at": "2020-11-03 17:35:23.592"
},
{
"name": "Signup Date",
"source": "cvar",
"source_variable": "signup_date",
"value": "2020-09-09",
"data_type": "date",
"created_a": "2020-11-03 17:35:23.598",
"updated_at": "2020-11-03 17:35:23.598"
},
{
"name": "Internal",
"source": "cvar",
"source_variable": "is_internal",
"value": "false",
"data_type": "boolean",
"created_a": "2020-11-17 16:19:04.924481",
"updated_at": "2020-11-17 16:19:04.924481"
},
{
"name": "Last Communication Date",
"source": "sfdc",
"source_variable": "last_user_comm_datetime(auto)",
"value": "2021-01-28T06:58:15.023420Z",
"data_type": "string",
"created_a": "2020-12-01 14:17:56.012",
"updated_at": "2021-02-04 06:58:15.023"
}
]
}
]
}
Comments
0 comments
Please sign in to leave a comment.