> ## Documentation Index
> Fetch the complete documentation index at: https://docs.lite.sa/llms.txt
> Use this file to discover all available pages before exploring further.

# Get acceptance account by ID

> Retrieves a single acceptance account with its total and available balance.




## OpenAPI

````yaml /openapi/account-settlement.json get /accounts/acceptance-accounts/{id}
openapi: 3.1.0
info:
  title: lite - Account Settlement
  version: 1.0.0
servers:
  - url: https://api.lite.sa
    description: Production
security:
  - ApiKeyAuth: []
  - BearerAuth: []
tags:
  - name: Settlement Windows
    description: Manage settlement windows for merchant payout cycles
  - name: Transactions
    description: Query settlement transactions and their details
  - name: Settlement
    description: >-
      Register verified seller settlement accounts, view acceptance account
      balances, and pay out on demand from an acceptance account to a settlement
      account
paths:
  /accounts/acceptance-accounts/{id}:
    servers:
      - url: https://api.lite.sa
        description: Production
    get:
      tags:
        - Settlement
      summary: Get acceptance account by ID
      description: >
        Retrieves a single acceptance account with its total and available
        balance.
      operationId: lite.settlement.getAcceptanceAccountById
      parameters:
        - $ref: '#/components/parameters/acceptance_account_id'
        - $ref: '#/components/parameters/x-correlation-id'
      responses:
        '200':
          $ref: '#/components/responses/AcceptanceAccountDetails'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '403':
          $ref: '#/components/responses/Forbidden'
        '404':
          $ref: '#/components/responses/NotFound'
        '500':
          $ref: '#/components/responses/InternalServerError'
      security:
        - ApiKeyAuth: []
components:
  parameters:
    acceptance_account_id:
      name: id
      in: path
      required: true
      description: Unique identifier of the acceptance account
      schema:
        type: string
        format: uuid
        example: 550e8400-e29b-41d4-a716-446655440000
    x-correlation-id:
      name: x-correlation-id
      in: header
      required: false
      description: >-
        Unique identifier for request tracing. Generated by the client or server
        if not provided.
      schema:
        type: string
        format: uuid
        example: 550e8400-e29b-41d4-a716-446655440000
  responses:
    AcceptanceAccountDetails:
      description: Acceptance account details.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/AcceptanceAccount'
    Unauthorized:
      description: |
        Authentication failed — missing or invalid token.

        Returned when:
        - The JWT bearer token is missing, expired, or has an invalid signature
        - The API key is missing or invalid
        - The authenticated session token is invalid
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
    Forbidden:
      description: >
        Request blocked by security policy.


        Returned when:

        - A security threat is detected (SQL injection, XSS, NoSQL injection,
        LDAP injection, path traversal)

        - Header injection or suspicious headers are detected

        - The request payload exceeds the maximum allowed size

        - Geo-region validation fails (user country does not match client
        region)
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
    NotFound:
      description: |
        The requested resource was not found.

        Returned when:
        - The specified resource ID does not exist
        - The path does not match any known endpoint
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
    InternalServerError:
      description: >
        An unexpected error occurred on the server.


        Returned when an unhandled exception or infrastructure failure prevents
        the request from being processed. Retry the request with exponential
        backoff.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
  schemas:
    AcceptanceAccount:
      type: object
      description: >-
        A ledger acceptance account where the merchant's collected funds are
        held and payouts are funded from
      required:
        - id
        - account_name
        - reference
        - currency
        - status
        - balance
        - available_balance
      properties:
        id:
          type: string
          format: uuid
          description: >-
            Acceptance account identifier. Use it as `acceptance_account_id`
            when creating a payout.
          example: 550e8400-e29b-41d4-a716-446655440000
        account_name:
          type: string
          description: Acceptance account name
          example: Acceptance Pool - TikTok Shop
        account_number:
          type: string
          description: 12-digit internal account number
          example: '000110000015'
        reference:
          type: string
          description: Sub-account key within the business account and currency
          example: main
        currency:
          type: string
          description: ISO 4217 currency code
          example: SAR
        status:
          type: string
          description: Acceptance account status. Only `ACTIVE` accounts can fund payouts.
          enum:
            - ACTIVE
            - RESTRICTED
            - CLOSED
            - DORMANT
            - UNCLAIMED
            - ABANDONED
            - FREEZED
            - ON_HOLD
          example: ACTIVE
        balance:
          type: integer
          description: Total funds held in the acceptance account, in minor units
          minimum: 0
          example: 1400000
        available_balance:
          type: integer
          description: >-
            Amount that can be paid out now, in minor units. Excludes funds on
            hold for payouts in progress.
          minimum: 0
          example: 1250000
    ErrorResponse:
      type: object
      required:
        - error
      properties:
        error:
          type: object
          required:
            - code
            - message
            - timestamp
          properties:
            code:
              type: string
              description: Error code identifying the type of error
              example: PAYMENT_DETAILS_MISMATCH
            message:
              type: string
              description: Human-readable error description
              example: The request was invalid or malformed
            details:
              type: object
              description: Additional error details
            correlationId:
              type: string
              format: uuid
              description: Correlation ID for tracking the request
              example: 550e8400-e29b-41d4-a716-446655440000
            timestamp:
              type: string
              format: date-time
              description: Timestamp when the error occurred
              example: '2024-12-16T10:30:00.000Z'
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key
      description: API key for service-to-service or merchant authentication.
    BearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: >-
        JWT Bearer token obtained from user authentication. Passed as
        Authorization: Bearer <token>.

````