Browse the docs

Get account

GET /v2/api-gateway/accounts/{id}

Returns one account of your organization or of one of its child organizations, with its current balance and available_balance. An account id that exists but belongs to another organization returns 404, same as one that does not exist.

Request

Authentication: your API key in the x-api-key header.

Path parameters

Field	Type	Description
`id` required	string, uuid	Account UUID

Example request

cURL

curl --request GET \
     --url 'https://api.themooncard.com/v2/api-gateway/accounts/8d2cd518-5ef2-4280-91e8-63b1a0e672e7' \
     --header 'x-api-key: YOUR_API_KEY'

Responses

200 Success

Field	Type	Description
`id` required	string	Account id.
`name` required	string, nullable
`organization_id` required	string
`ledger_account_id` required	string	Internal. May change or be removed without notice — do not rely on it.
`balance` required	number	Current balance as a number.
`available_balance` required	number	Spendable balance as a number.
`currency` required	string	ISO-4217 currency code, e.g. "USD".
`metadata` required	object	The key-value data you stored on this account, returned exactly as you sent it. An empty object when you never set any — it is never null.
`created_at` required	string	ISO-8601 timestamp.
`updated_at` required	string, nullable	ISO-8601 timestamp, or null.

JSON

{
  "id": "9b2e7d10-6c1f-4a3e-8f5d-2a4b6c8d0e1f",
  "name": "Operations",
  "organization_id": "5c1e2d3f-4a5b-4c6d-8e7f-9a0b1c2d3e4f",
  "ledger_account_id": "0a1b2c3d-4e5f-4061-8273-8495a6b7c8d9",
  "balance": 1250.75,
  "available_balance": 1180.25,
  "currency": "USD",
  "metadata": {
    "cost_center": "CC-204"
  },
  "created_at": "2026-08-01T09:12:44.000Z",
  "updated_at": "2026-08-16T17:51:01.000Z"
}

400 Error

Validation failed (errors[] lists each offending field) or a domain rule rejected the request ({ message, code }).

The body is the standard error object: see Errors.

401 Error

Missing or invalid credentials, e.g. { "message": "Invalid API Key", "code": "UNAUTHORIZED" }.

The body is the standard error object: see Errors.

404 Error

Account not found or not owned by you.

The body is the standard error object: see Errors.

500 Error

Unexpected server error. Body is { message: "Internal server error", code: "INTERNAL_SERVER_ERROR" }.

The body is the standard error object: see Errors.

Last updated June 5, 2026