List Accounts
Gets a list of accounts.
All the DevRev APIs require a token to authenticate the user. Provide Authorization: Bearer <TOKEN>
as a header to every API request.
How do I find my token?
In: header
Query Parameters
Filters for accounts created by the specified user(s).
Filters for objects created after the provided timestamp (inclusive).
date-time
Filters for objects created before the provided timestamp (inclusive).
date-time
The cursor to resume iteration from. If not provided, then iteration starts from the beginning.
text
Array of display names of accounts to be filtered.
Array of references of accounts to be filtered.
The maximum number of accounts to return per page. The default is '50'.
int32
The iteration mode to use, otherwise if not set, then "after" is used.
"after" | "before"
Filters for objects created after the provided timestamp (inclusive).
date-time
Filters for objects created before the provided timestamp (inclusive).
date-time
Fields to sort the accounts by and the direction to sort them in.
Filters for accounts on specified stages.
Tier of the accounts to be filtered.
Array of websites of accounts to be filtered.
Response Body
curl -X GET "https://api.devrev.ai/accounts.list?created_by=string&created_date.after=2023-01-01T12%3A00%3A00.000Z&created_date.before=2023-01-01T12%3A00%3A00.000Z&cursor=string&display_name=string&external_refs=string&limit=0&mode=after&modified_date.after=2023-01-01T12%3A00%3A00.000Z&modified_date.before=2023-01-01T12%3A00%3A00.000Z&sort_by=string&stage=string&tier=string&websites=string"
{
"accounts": [
{
"created_by": {
"type": "dev_user",
"display_id": "string",
"id": "string",
"display_name": "string",
"display_picture": {
"display_id": "string",
"id": "string",
"file": {
"type": "string",
"name": "string",
"size": 0
}
},
"email": "string",
"full_name": "string",
"state": "active"
},
"created_date": "2023-01-01T12:00:00.000Z",
"display_id": "string",
"id": "string",
"modified_by": {
"type": "dev_user",
"display_id": "string",
"id": "string",
"display_name": "string",
"display_picture": {
"display_id": "string",
"id": "string",
"file": {
"type": "string",
"name": "string",
"size": 0
}
},
"email": "string",
"full_name": "string",
"state": "active"
},
"modified_date": "2023-01-01T12:00:00.000Z",
"display_name": "string",
"description": "string",
"domains": [
"string"
],
"external_refs": [
"string"
],
"owned_by": [
{
"type": "dev_user",
"display_id": "string",
"id": "string",
"display_name": "string",
"display_picture": {
"display_id": "string",
"id": "string",
"file": {
"type": "string",
"name": "string",
"size": 0
}
},
"email": "string",
"full_name": "string",
"state": "active"
}
],
"primary_account": {
"display_id": "string",
"id": "string",
"display_name": "string"
},
"tier": "string",
"websites": [
"string"
]
}
],
"next_cursor": "string",
"prev_cursor": "string"
}
{
"detail": "string",
"message": "string",
"type": "artifact_already_attached_to_a_parent",
"existing_parent": "string",
"is_same": true
}
{
"detail": "string",
"message": "string",
"type": "unauthenticated"
}
{
"detail": "string",
"message": "string",
"type": "forbidden"
}
{
"detail": "string",
"message": "string",
"type": "not_found"
}
{
"detail": "string",
"message": "string",
"type": "too_many_requests",
"retry_after": 0
}
{
"detail": "string",
"message": "string",
"type": "internal_error",
"reference_id": "string"
}
{
"detail": "string",
"message": "string",
"type": "service_unavailable"
}