Accounts

List Accounts

Gets a list of accounts.

GET
/accounts.list
AuthorizationBearer <token>

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

created_by?array<string>

Filters for accounts created by the specified user(s).

created_date.after?string

Filters for objects created after the provided timestamp (inclusive).

Formatdate-time
created_date.before?string

Filters for objects created before the provided timestamp (inclusive).

Formatdate-time
cursor?string

The cursor to resume iteration from. If not provided, then iteration starts from the beginning.

Formattext
display_name?array<string>

Array of display names of accounts to be filtered.

external_refs?array<string>

Array of references of accounts to be filtered.

limit?integer

The maximum number of accounts to return per page. The default is '50'.

Formatint32
mode?string

The iteration mode to use, otherwise if not set, then "after" is used.

Value in"after" | "before"
modified_date.after?string

Filters for objects created after the provided timestamp (inclusive).

Formatdate-time
modified_date.before?string

Filters for objects created before the provided timestamp (inclusive).

Formatdate-time
sort_by?array<string>

Fields to sort the accounts by and the direction to sort them in.

stage?array<string>

Filters for accounts on specified stages.

tier?array<string>

Tier of the accounts to be filtered.

websites?array<string>

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"
}