List Account Statuses

Beta

GET/v1/sales/account-statuses

This endpoint is idempotent. Learn more

Returns a paginated list of account statuses. Global lookup values for setting account relationship statuses.

cursoroptional string

Cursor token used to retrieve the next or previous page of results.

limitoptional integer

Maximum number of results per page (default: 100, max: 1000).

qoptional string

Search query used to filter results.

include[]optional arrayenumValues:owner

Sub-objects to expand in the response. When omitted, sub-objects are returned as null.

objectstringenumValues:list

Resource type identifier.

page_infoobject

Pagination metadata.

next_page_urlstringnullable

URL to fetch the next page, null if no more pages.

previous_page_urlstringnullable

URL to fetch the previous page, null if on the first page.

has_next_pageboolean

Whether more results exist after this page.

has_prev_pageboolean

Whether results exist before this page.

dataarray of object

Resources in this page.

idstring

Account status ID.

objectstringenumValues:account_status

Resource type identifier.

codestringenumValues:normalpreferredhold_shipment

Machine-readable status code.

namestring

Display name.

ownerobjectExpandablenullable

Owner of this resource.

objectstringenumValues:owner

Resource type identifier.

typestringenumValues:systemaccount

The owner type: "system" for platform defaults, "account" for account-owned resources.

accountobjectnullable

The account that owns this resource. null if the object is system-owned.

Always returned as null in this endpoint.

created_atstring (date-time)

Creation timestamp.

updated_atstring (date-time)

Last updated timestamp.

Responses

200

Successful response for List Account Statuses

List Account Statuses

import Augno from '@augno/sdk';

const client = new Augno({
  bearerToken: 'YOUR_API_KEY', // Your API key goes here
});

const listAccountStatus = await client.sales.accountStatuses.list();

console.log(listAccountStatus.data);

import Augno from '@augno/sdk';

const client = new Augno({
  bearerToken: 'YOUR_API_KEY', // Your API key goes here
});

const listAccountStatus = await client.sales.accountStatuses.list();

console.log(listAccountStatus.data);

200 example

{
  "object": "list",
  "page_info": {
    "next_page_url": "/v1/sales/account-statuses?cursor=eyJjIjoiMjAyNi0wNS0xMFQwMDowMDowMFoiLCJzIjoiYWNzc18wMTAwNGY1MzJjNThkNjA1MTRiNjg1Y2IyNyIsImQiOiJmIn0.fp64pEts8RGGKM5MTz5Fvtssr7ejwkSXrQsZ3VfkK_c",
    "previous_page_url": null,
    "has_next_page": true,
    "has_prev_page": false
  },
  "data": [
    {
      "id": "acss_01004f532c58d60514b685cb27",
      "object": "account_status",
      "code": "normal",
      "name": "Normal",
      "owner": {
        "object": "owner",
        "type": "system"
      },
      "created_at": "2026-05-10T00:00:00Z",
      "updated_at": "2026-05-10T00:23:00Z"
    }
  ]
}

{
  "object": "list",
  "page_info": {
    "next_page_url": "/v1/sales/account-statuses?cursor=eyJjIjoiMjAyNi0wNS0xMFQwMDowMDowMFoiLCJzIjoiYWNzc18wMTAwNGY1MzJjNThkNjA1MTRiNjg1Y2IyNyIsImQiOiJmIn0.fp64pEts8RGGKM5MTz5Fvtssr7ejwkSXrQsZ3VfkK_c",
    "previous_page_url": null,
    "has_next_page": true,
    "has_prev_page": false
  },
  "data": [
    {
      "id": "acss_01004f532c58d60514b685cb27",
      "object": "account_status",
      "code": "normal",
      "name": "Normal",
      "owner": {
        "object": "owner",
        "type": "system"
      },
      "created_at": "2026-05-10T00:00:00Z",
      "updated_at": "2026-05-10T00:23:00Z"
    }
  ]
}

List Account Statuses

Query Parameters

Returns

Responses