List accounts

GET /api/v2/accounts Returns every account you can switch into. Use it to discover the accounts under your organization or to find the account ID for a subsequent domain or membership operation.

Request

curl

curl https://api.interchange.io/api/v2/accounts \
  -H "Authorization: Bearer $SCOPE3_API_KEY"

Parameters

None. Accounts are scoped to the authenticated user’s memberships.

Response

{
  "accounts": [
    {
      "id": 100,
      "company": "Northwind Media",
      "name": "Northwind",
      "role": "ADMIN"
    },
    {
      "id": 200,
      "company": "Northwind Retail",
      "name": "Retail",
      "role": "MEMBER"
    }
  ]
}

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

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

Create account

Provision a new account

Get notification preferences Update account domain

⌘I

Getting Started

Operating Your Storefront

Inventory Sources

Real-Time Targeting (TMP)

Approvals & Reviews

Buyer Onboarding

Demand & Signals

Proposals & Agents

Buyer Routing

Analytics & Activity

Billing

Account

Request

Parameters

Response

Errors

Account tasks

Get current account

Create account

​Request

​Parameters

​Response

​Errors

​Related

Account tasks

Get current account

Create account

Request

Parameters

Response

Errors

Related