GET
/
v1
/
accounts
/
:id
curl https://api.zquenceeee.com/v1/accounts/6a25cdcc36bc6230704b5bce \
  -H "x-api-key: $ZQUENCE_PUBLIC_KEY" \
  -H "x-api-secret: $ZQUENCE_SECRET_KEY"

{
  "id": "6a25cdcc36bc6230704b5bce",
  "title": "123 Elm Street Escrow",
  "accountType": "real_estate",
  "status": "accepted",
  "tenantId": "bc41c6ab-7206-4033-b632-4d1cfa86d840",
  "environmentId": "69f9b5fa0600ccbf9c677005",
  "buyer": {
    "id": "6a25cdac36bc6230704b5b59",
    "token": "7e9e6101c0ddedf0588ee8842994e7a2",
    "accepted": true,
    "expiresAt": "2026-06-14T20:00:12.325Z"
  },
  "seller": {
    "id": "6a25cdac36bc6230704b5b60",
    "token": "3f1b8e2d4a5c6f7e8d9a0b1c2d3e4f50",
    "accepted": true,
    "expiresAt": "2026-06-14T20:00:12.325Z"
  },
  "timeline": [
    {
      "event": "Seller invitation sent",
      "eventType": "sent",
      "timestamp": "2026-06-07T20:00:12.400Z",
      "details": { "email": "emily.thompson@example.com", "role": "seller" }
    },
    {
      "event": "Buyer invitation sent",
      "eventType": "sent",
      "timestamp": "2026-06-07T20:00:12.401Z",
      "details": { "email": "james.carter@example.com", "role": "buyer" }
    },
    {
      "event": "Buyer accepted invitation",
      "eventType": "accepted",
      "timestamp": "2026-06-07T20:10:45.000Z",
      "details": { "role": "buyer", "acceptedAt": "2026-06-07T20:10:45.000Z" }
    },
    {
      "event": "Seller accepted invitation",
      "eventType": "accepted",
      "timestamp": "2026-06-07T20:14:30.000Z",
      "details": { "role": "seller", "acceptedAt": "2026-06-07T20:14:30.000Z" }
    }
  ],
  "archivedAt": null,
  "archivedBy": null,
  "createdAt": "2026-06-07T20:00:12.414Z",
  "updatedAt": "2026-06-07T20:14:30.000Z"
}
Returns the full account record including all party details, timeline, and status. The account must belong to the authenticated tenant. Party field naming:
  • real_estate accounts: contains buyer and seller fields
  • permanent and construction accounts: contain only a buyer field (used as the single customer)
Requires the transaction.view.one permission on the authenticated API key or role.

​
Path parameters

​
id
string
required
The account ID (MongoDB ObjectId), as returned by List accounts or Create account.

​
Returns

A full account object.
​
id
string
Account ID (MongoDB ObjectId).
​
title
string
Account title as provided at creation.
​
accountType
string
"real_estate", "permanent", or "construction".
​
status
string
Current status — "invited", "pending", "accepted", or "completed".
​
tenantId
string
Owning tenant identifier.
​
environmentId
string | null
Environment this account belongs to.
​
token
string
Root account token (internal use).
​
buyer
object | null
For real_estate accounts: the buyer party. For permanent and construction: the single customer party. Fields: id, token, accepted, expiresAt.
​
seller
object | null
Only present for real_estate accounts. For other types this field is omitted. Fields: id, token, accepted, expiresAt.
​
timeline
array
Full ordered event log. Each entry contains event (description), eventType, timestamp, and optional details.
​
archivedAt
string | null
ISO 8601 timestamp if archived. null otherwise.
​
archivedBy
string | null
User ID of the archiving admin. null otherwise.
​
createdAt
string
ISO 8601 UTC creation timestamp.
​
updatedAt
string
ISO 8601 UTC last-updated timestamp.

​
Error codes

StatusMeaning
401Missing or invalid API key pair.
403Caller does not have transaction.view.one permission.
404Account not found or belongs to a different tenant.
curl https://api.zquenceeee.com/v1/accounts/6a25cdcc36bc6230704b5bce \
  -H "x-api-key: $ZQUENCE_PUBLIC_KEY" \
  -H "x-api-secret: $ZQUENCE_SECRET_KEY"

{
  "id": "6a25cdcc36bc6230704b5bce",
  "title": "123 Elm Street Escrow",
  "accountType": "real_estate",
  "status": "accepted",
  "tenantId": "bc41c6ab-7206-4033-b632-4d1cfa86d840",
  "environmentId": "69f9b5fa0600ccbf9c677005",
  "buyer": {
    "id": "6a25cdac36bc6230704b5b59",
    "token": "7e9e6101c0ddedf0588ee8842994e7a2",
    "accepted": true,
    "expiresAt": "2026-06-14T20:00:12.325Z"
  },
  "seller": {
    "id": "6a25cdac36bc6230704b5b60",
    "token": "3f1b8e2d4a5c6f7e8d9a0b1c2d3e4f50",
    "accepted": true,
    "expiresAt": "2026-06-14T20:00:12.325Z"
  },
  "timeline": [
    {
      "event": "Seller invitation sent",
      "eventType": "sent",
      "timestamp": "2026-06-07T20:00:12.400Z",
      "details": { "email": "emily.thompson@example.com", "role": "seller" }
    },
    {
      "event": "Buyer invitation sent",
      "eventType": "sent",
      "timestamp": "2026-06-07T20:00:12.401Z",
      "details": { "email": "james.carter@example.com", "role": "buyer" }
    },
    {
      "event": "Buyer accepted invitation",
      "eventType": "accepted",
      "timestamp": "2026-06-07T20:10:45.000Z",
      "details": { "role": "buyer", "acceptedAt": "2026-06-07T20:10:45.000Z" }
    },
    {
      "event": "Seller accepted invitation",
      "eventType": "accepted",
      "timestamp": "2026-06-07T20:14:30.000Z",
      "details": { "role": "seller", "acceptedAt": "2026-06-07T20:14:30.000Z" }
    }
  ],
  "archivedAt": null,
  "archivedBy": null,
  "createdAt": "2026-06-07T20:00:12.414Z",
  "updatedAt": "2026-06-07T20:14:30.000Z"
}