GET
/
v1
/
accounts
/
:id
curl https://v2.app-dev.zquence.com/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"
}
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

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

​
Returns

​
id
string
Account ID.
​
externalReference
string
Your reference from Create an account. Omitted for accounts created without one, including accounts created in the console.
​
accountType
string
Account-type code, for example permanent or real_estate.
​
title
string
Account title.
​
status
string
invited, pending, accepted, completed, or cancelled.
​
participants
object[]
One customer, or a buyer and a seller.
​
createdAt
string
ISO 8601 UTC creation timestamp.
​
updatedAt
string
ISO 8601 UTC last-updated timestamp.

​
Error codes

StatuscodeMeaning
400invalid_account_idid isn’t a valid account ID.
400invalid_external_read_contextThe API key isn’t bound to an environment. Use a sandbox or live key.
401key_missing / key_invalid / key_revokedMissing, wrong, or revoked API key pair.
403key_forbiddenThe key lacks the accounts.read scope.
404account_not_foundNo 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://v2.app-dev.zquence.com/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"
}