Retrieve an account

GET

accounts

:id

curl https://api.zquence.ai/v1/accounts/6a25cdcc36bc6230704b5bce \
  -H "x-api-key: $ZQUENCE_PUBLIC_KEY" \
  -H "x-api-secret: $ZQUENCE_SECRET_KEY"

{
  "id": "6a25cdcc36bc6230704b5bce",
  "externalReference": "deal-2291",
  "accountType": "real_estate",
  "title": "123 Elm Street",
  "status": "accepted",
  "participants": [
    { "role": "buyer", "userId": "6a25cdac36bc6230704b5b59", "accepted": true },
    { "role": "seller", "userId": "6a25cdac36bc6230704b5b60", "accepted": true }
  ],
  "createdAt": "2026-06-07T20:00:12.414Z",
  "updatedAt": "2026-06-07T20:14:30.000Z"
}

{
  "id": "6a25cdcc36bc6230704b5bcf",
  "accountType": "permanent",
  "title": "Acme Corporation",
  "status": "invited",
  "participants": [
    { "role": "customer", "userId": "6a25cdac36bc6230704b5b59", "accepted": false }
  ],
  "createdAt": "2026-06-07T20:00:12.414Z",
  "updatedAt": "2026-06-07T20:00:12.414Z"
}

{
  "code": "account_not_found",
  "statusCode": 404,
  "message": "Account not found",
  "path": "/v1/accounts/6a25cdcc36bc6230704b5bce",
  "correlationId": "5c4b3a29-1807-4f6e-9d5c-4b3a29180f6e",
  "timestamp": "2026-09-15T10:00:00.000Z"
}

Returns one account from the environment your API key is bound to. The response has the same shape as Create an account, so you can use one parser for both. It works for every account in the environment, including accounts created in the Zquence console.

Requires an API key with the accounts.read scope that is bound to an environment.

[BREAKING] Response shape changed for API-key callers. This endpoint used to return the full internal account record (tenantId, environmentId, token, buyer, seller, timeline, archivedAt, archivedBy). It now returns the smaller projection below, with parties listed under participants and no invitation tokens. If your integration reads buyer, seller, or timeline, switch to participants. For account lifecycle history, subscribe to account webhooks.

Path parameters

string

required

The account ID, as returned by Create an account (also in its Location header) or List accounts.

Returns

string

Account ID.

string

Your reference from Create an account. Omitted for accounts created without one, including accounts created in the console.

string

Account-type code, for example permanent or real_estate.

string

Account title.

string

invited, pending, accepted, completed, or cancelled.

object[]

One customer, or a buyer and a seller.

Show participant properties

string

customer, buyer, or seller.

string

Customer ID.

boolean

Whether this participant has accepted the invitation.

string

ISO 8601 UTC creation timestamp.

string

ISO 8601 UTC last-updated timestamp.

Error codes

Status	`code`	Meaning
`400`	`invalid_account_id`	`id` isn’t a valid account ID.
`400`	`invalid_external_read_context`	The API key isn’t bound to an environment. Use a sandbox or live key.
`401`	`key_missing` / `key_invalid` / `key_revoked`	Missing, wrong, or revoked API key pair.
`403`	`key_forbidden`	The key lacks the `accounts.read` scope.
`404`	`account_not_found`	No account with this ID in the key’s tenant and environment. A sandbox key can’t read live accounts, and a live key can’t read sandbox accounts.

curl https://api.zquence.ai/v1/accounts/6a25cdcc36bc6230704b5bce \
  -H "x-api-key: $ZQUENCE_PUBLIC_KEY" \
  -H "x-api-secret: $ZQUENCE_SECRET_KEY"

{
  "id": "6a25cdcc36bc6230704b5bce",
  "externalReference": "deal-2291",
  "accountType": "real_estate",
  "title": "123 Elm Street",
  "status": "accepted",
  "participants": [
    { "role": "buyer", "userId": "6a25cdac36bc6230704b5b59", "accepted": true },
    { "role": "seller", "userId": "6a25cdac36bc6230704b5b60", "accepted": true }
  ],
  "createdAt": "2026-06-07T20:00:12.414Z",
  "updatedAt": "2026-06-07T20:14:30.000Z"
}

{
  "id": "6a25cdcc36bc6230704b5bcf",
  "accountType": "permanent",
  "title": "Acme Corporation",
  "status": "invited",
  "participants": [
    { "role": "customer", "userId": "6a25cdac36bc6230704b5b59", "accepted": false }
  ],
  "createdAt": "2026-06-07T20:00:12.414Z",
  "updatedAt": "2026-06-07T20:00:12.414Z"
}

{
  "code": "account_not_found",
  "statusCode": 404,
  "message": "Account not found",
  "path": "/v1/accounts/6a25cdcc36bc6230704b5bce",
  "correlationId": "5c4b3a29-1807-4f6e-9d5c-4b3a29180f6e",
  "timestamp": "2026-09-15T10:00:00.000Z"
}

curl https://api.zquence.ai/v1/accounts/6a25cdcc36bc6230704b5bce \
  -H "x-api-key: $ZQUENCE_PUBLIC_KEY" \
  -H "x-api-secret: $ZQUENCE_SECRET_KEY"

{
  "id": "6a25cdcc36bc6230704b5bce",
  "externalReference": "deal-2291",
  "accountType": "real_estate",
  "title": "123 Elm Street",
  "status": "accepted",
  "participants": [
    { "role": "buyer", "userId": "6a25cdac36bc6230704b5b59", "accepted": true },
    { "role": "seller", "userId": "6a25cdac36bc6230704b5b60", "accepted": true }
  ],
  "createdAt": "2026-06-07T20:00:12.414Z",
  "updatedAt": "2026-06-07T20:14:30.000Z"
}

{
  "id": "6a25cdcc36bc6230704b5bcf",
  "accountType": "permanent",
  "title": "Acme Corporation",
  "status": "invited",
  "participants": [
    { "role": "customer", "userId": "6a25cdac36bc6230704b5b59", "accepted": false }
  ],
  "createdAt": "2026-06-07T20:00:12.414Z",
  "updatedAt": "2026-06-07T20:00:12.414Z"
}

{
  "code": "account_not_found",
  "statusCode": 404,
  "message": "Account not found",
  "path": "/v1/accounts/6a25cdcc36bc6230704b5bce",
  "correlationId": "5c4b3a29-1807-4f6e-9d5c-4b3a29180f6e",
  "timestamp": "2026-09-15T10:00:00.000Z"
}

Introduction

Tenant

Environments

Customers

Accounts

KYC

Document reviews

Source of funds

Files

Webhooks

Sync

Sanctions

Retrieve an account

Path parameters

Returns

Error codes

​Path parameters

​Returns

​Error codes

Path parameters

Returns

Error codes