Skip to main content
GET /api/v2/accounts/current Returns the customer account your API key is currently operating as, including your role and the registered organization domain. Use it to confirm context before running admin-scoped account or domain operations.

​
Request

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

​
Parameters

None. The account is resolved from the API key.

​
Response

{
  "id": 100,
  "company": "Northwind Media",
  "name": "Northwind",
  "role": "ADMIN",
  "customerDomain": "northwind.example",
  "standing": {
    "creditLimitPerMonth": 500000,
    "currency": "USD"
  }
}
FieldTypeNotes
idintegerCustomer ID for the current account
companystringCompany name
namestringDisplay name
rolestringYour role on this customer (MEMBER, ADMIN, SUPER_ADMIN). Omitted when not applicable
customerDomainstring | nullRegistered organization domain, or null if unset
standingobjectAdmin-only. Customer standing. Present only when the caller is ADMIN or above; omitted for members. See below.

​
standing (admin only)

Returned only when your role on the account is ADMIN or SUPER_ADMIN. It carries the account’s credit-limit posture and is resolved with parent fallback — a child account reflects its parent’s inherited credit limit.
FieldTypeNotes
creditLimitPerMonthinteger | nullMonthly credit limit beyond the funded balance, in minor currency units (USD cents). 0 = prepay-only (fund to spend); >0 = a monthly credit ceiling Scope3 fronts; null = no Scope3-imposed limit
currencystringISO 4217 currency code the creditLimitPerMonth is denominated in. Defaults to USD

​
Errors

  • 401 UNAUTHORIZED — missing or invalid API key.
See Errors for the full error contract.

Account tasks

All account operations

List customer accounts

Accounts you can switch into

Account overview

Concepts and hierarchy