> ## Documentation Index > Fetch the complete documentation index at: https://docs.nxos.io/llms.txt > Use this file to discover all available pages before exploring further. # Get account > Retrieve a single account by ID, including its current balances and attached funding methods. Balances are fetched from the ledger in real time. ## OpenAPI ````yaml GET /v1/accounts/{accountId} openapi: 3.0.0 info: title: nxos API version: 1.0.0 contact: name: nxos url: https://nxos.io description: |- The nxos platform API provides programmatic access to accounts, balances, quotes, and trades. All endpoints require API key authentication. servers: - url: https://api.nxos.io description: Production variables: {} - url: https://api.sandbox.nxos.io description: Sandbox variables: {} security: [] tags: - name: Accounts - name: Quotes - name: Beneficiaries - name: Fiat Payouts - name: Crypto Payouts - name: Nxosnet - name: Fees - name: Funding Methods - name: Transactions - name: Organizations - name: Authorizations - name: Webhooks description: >- Register an HTTPS endpoint to receive events (organization verification and transaction status changes) instead of polling. Deliveries are signed; verify the `svix-signature` header before acting on an event. See the [Webhooks guide](https://docs.nxos.io/core-concepts/webhooks) for the delivery format, signature verification, retries, and broker behavior. Payload shapes are documented in the `…Event` models below. paths: /v1/accounts/{accountId}: get: tags: - Accounts description: >- Retrieve a single account by ID, including its current balances and attached funding methods. Balances are fetched from the ledger in real time. operationId: Accounts_get parameters: - $ref: '#/components/parameters/ApiKeyAuth' - name: accountId in: path required: true schema: type: string responses: '200': description: The request has succeeded. content: application/json: schema: $ref: '#/components/schemas/AccountDetail' '401': description: Access is unauthorized. content: application/json: schema: $ref: '#/components/schemas/Error401' '404': description: The server cannot find the requested resource. content: application/json: schema: $ref: '#/components/schemas/Error404' '429': description: Client error content: application/json: schema: $ref: '#/components/schemas/Error429' '500': description: Server error content: application/json: schema: $ref: '#/components/schemas/Error500' components: parameters: ApiKeyAuth: name: Authorization in: header required: true description: 'Bearer token. Format: `Bearer `' schema: type: string schemas: AccountDetail: type: object required: - object - accountId - name - description - isPrimary - status - fundingMethods - balances - createdAt - updatedAt properties: object: type: string enum: - account description: Object type. Always `account`. accountId: type: string description: Unique account identifier. name: type: string nullable: true description: Display name for the account. description: type: string nullable: true description: Optional description of the account's purpose. isPrimary: type: boolean description: Whether this is the organization's primary account. status: allOf: - $ref: '#/components/schemas/AccountStatus' description: Current account status. fundingMethods: type: array items: $ref: '#/components/schemas/FundingMethod' description: Funding methods attached to this account. balances: type: array items: $ref: '#/components/schemas/Balance' description: Current balances per asset held in this account. createdAt: allOf: - $ref: '#/components/schemas/dateTimeString' description: When the account was created. updatedAt: allOf: - $ref: '#/components/schemas/dateTimeString' description: When the account was last updated. description: >- Detailed view of a financial account, including balances and funding methods. example: object: account accountId: acct_a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4 name: Main description: null isPrimary: true status: ACTIVE fundingMethods: [] balances: - object: balance asset: USD amount: '15000.00' - object: balance asset: USDC amount: '5000.000000' createdAt: '2025-01-15T10:30:00.000Z' updatedAt: '2025-01-15T10:30:00.000Z' Error401: type: object required: - error properties: error: $ref: '#/components/schemas/ErrorBody' description: Standard error response returned by all endpoints on failure. example: error: code: missing_api_key message: No Authorization header provided. requestId: req_a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4 Error404: type: object required: - error properties: error: $ref: '#/components/schemas/ErrorBody' description: Standard error response returned by all endpoints on failure. example: error: code: not_found message: The requested resource was not found. requestId: req_a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4 Error429: type: object required: - error properties: error: $ref: '#/components/schemas/ErrorBody' description: Standard error response returned by all endpoints on failure. example: error: code: rate_limited message: 'Rate limit exceeded: 1000 requests per minute. Retry in 23 seconds.' requestId: req_a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4 Error500: type: object required: - error properties: error: $ref: '#/components/schemas/ErrorBody' description: Standard error response returned by all endpoints on failure. example: error: code: internal_error message: An unexpected server error occurred. requestId: req_a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4 AccountStatus: type: string enum: - ACTIVE - SUSPENDED - CLOSED description: Account status. FundingMethod: type: object required: - object - fundingMethodId - name - type - status - createdAt properties: object: type: string enum: - funding_method description: Object type. Always `funding_method`. fundingMethodId: type: string description: Unique funding method identifier. name: type: string nullable: true description: Display name for this funding method. type: type: string description: Type of funding method (e.g., `BANK_ACCOUNT`, `CRYPTO_WALLET`). status: type: string description: Current status of this funding method. createdAt: allOf: - $ref: '#/components/schemas/dateTimeString' description: When this funding method was created. description: >- A funding method (e.g., bank account, crypto wallet) attached to an account. example: object: funding_method fundingMethodId: funding_a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4 name: USD Wire type: BANK_ACCOUNT status: ACTIVE createdAt: '2025-01-15T10:30:00.000Z' Balance: type: object required: - object - asset - amount properties: object: type: string enum: - balance description: Object type. Always `balance`. asset: type: string description: Asset code (e.g. `USD`, `USDC`, `EUR`). amount: allOf: - $ref: '#/components/schemas/amount' description: Balance amount in major units (e.g. `"100.50"`). description: >- A balance entry for an account, representing the amount held in a specific asset. dateTimeString: type: string description: ISO 8601 timestamp string. ErrorBody: type: object required: - code - message - requestId properties: code: allOf: - $ref: '#/components/schemas/ErrorCode' description: Machine-readable error code. message: type: string description: Human-readable error message. requestId: type: string description: Unique identifier for this request, useful for debugging. amount: type: string description: >- Monetary amount as a decimal string in major units (e.g., `"10.50"` for ten dollars and fifty cents). Amounts are always returned at the asset's native precision — for example, USDT amounts have 6 decimal places (`"10.500000"`). Clients should parse amounts as arbitrary-precision decimals, never as floating-point numbers, to avoid rounding errors. Internally, the platform stores all amounts as integer subunits and converts at the API boundary. ErrorCode: type: string enum: - missing_api_key - authentication_failed - invalid_api_key - forbidden - not_found - organization_not_found - account_not_found - quote_not_found - beneficiary_not_found - transaction_not_found - funding_method_not_found - authorization_not_found - nxosnet_handle_not_found - quote_expired - quote_already_used - beneficiary_already_archived - beneficiary_not_archived - beneficiary_blocked - nxosnet_not_enabled - nxosnet_handle_taken - chain_send_failed - idempotency_key_in_use - idempotency_request_in_flight - invalid_request - insufficient_funds - validation_error - share_token_invalid - verification_import_unsupported - rate_limited - webhooks_unavailable - internal_error description: All possible error codes returned by the API. ````