List accounts

GET /api/v2/accounts Returns active organization containers and accounts you can select. Add includeArchived=true on the account-management screen to include archived child accounts so an administrator can restore them. Archived accounts cannot be selected until restored.

Request

curl

curl "https://api.apostra.com/api/v2/accounts?includeArchived=true" \
  -H "Authorization: Bearer $SCOPE3_API_KEY"

Parameters

Parameter	Type	Required	Description
`includeArchived`	boolean	No	Defaults to `false`. Set to `true` for the management list that includes lifecycle-archived child accounts.

Accounts include the authenticated user’s memberships. When an organization administrator requests the management view with includeArchived=true, the result also includes that organization’s direct child accounts even when the administrator has no separate membership on a child. This parent authority never exposes accounts from another organization.

Response

{
  "accounts": [
    {
      "id": 100,
      "company": "Northwind Media",
      "name": "Northwind",
      "role": "ADMIN",
      "accountType": null,
      "customerType": "PARENT",
      "parentId": null,
      "active": true,
      "status": "ACTIVE",
      "archivedAt": null
    },
    {
      "id": 200,
      "company": "Northwind Retail",
      "name": "Retail",
      "role": "ADMIN",
      "accountType": "SELLER",
      "customerType": "CHILD",
      "parentId": 100,
      "active": false,
      "status": "ARCHIVED",
      "archivedAt": "2026-09-25T12:00:00.000Z"
    }
  ]
}

Field	Type	Notes
`accounts[]`	array	One entry per account you have access to
`accounts[].id`	integer	Account ID
`accounts[].company`	string	Company name
`accounts[].name`	string	Display name
`accounts[].role`	string	Your role on this account (`MEMBER`, `ADMIN`, `SUPER_ADMIN`). May be omitted
`accounts[].accountType`	string \| null	`BUYER` or `SELLER`; `null` for an organization container
`accounts[].customerType`	string	`STANDALONE`, `PARENT`, or `CHILD`
`accounts[].parentId`	integer \| null	Parent organization ID for a child account
`accounts[].active`	boolean	Whether the account can be selected and used
`accounts[].status`	string	`ACTIVE` or `ARCHIVED`
`accounts[].archivedAt`	string \| null	Time of the most recent archive

Errors

401 UNAUTHORIZED — missing or invalid API key.

See Errors for the full error contract.

Account tasks

All account operations

Get current account

The account you are operating as

Start building

Core Concepts

Buyer operations

Seller operations

Cross-Cutting Reference

Buyer API reference

Seller API reference

Release Notes

Request

Parameters

Response

Errors

Account tasks

Get current account

​Request

​Parameters

​Response

​Errors

​Related

Account tasks

Get current account

Request

Parameters

Response

Errors

Related