> ## Documentation Index > Fetch the complete documentation index at: https://docs.fintoc.com/llms.txt > Use this file to discover all available pages before exploring further. # List account numbers > Lists the account numbers of your organization in the `live` or `test` mode of the API key used. Filter by `account_id`. The list is paginated. Use the `starting_after`, `ending_before`, and `limit` query parameters to move through the list. The `Link` response header carries the URLs to navigate the paginated list. **`v2`** ยท Base URL `https://api.fintoc.com/v2` ## OpenAPI ````yaml reference/pacioli-api.json GET /account_numbers openapi: 3.1.0 info: title: Fintoc API version: v2026-02-01 servers: - url: https://api.fintoc.com/v2 security: [] paths: /account_numbers: get: tags: - Account numbers summary: List account numbers description: >- Lists the account numbers of your organization in the `live` or `test` mode of the API key used. Filter by `account_id`. The list is paginated. Use the `starting_after`, `ending_before`, and `limit` query parameters to move through the list. The `Link` response header carries the URLs to navigate the paginated list. operationId: account-numbers-list parameters: - name: account_id in: query required: false schema: type: string description: Identifier of the account whose account numbers are returned. - name: ending_before in: query required: false schema: type: string example: acno_2rNxBkOrlHoOYsZTyQYhA0o8Ek0 description: >- Cursor that fetches the previous page of account numbers. Use the ID of the first account number from the current page. - name: limit in: query required: false schema: type: integer example: 50 description: >- Maximum number of account numbers to return per page. Ranges from `1` to `300`. Defaults to `30`. - name: starting_after in: query required: false schema: type: string example: acno_2rNxBkOrlHoOYsZTyQYhA0o8Ek0 description: >- Cursor that fetches the next page of account numbers. Use the ID of the last account number from the current page. responses: '200': description: List of account numbers for the current mode. headers: Link: schema: type: string description: URLs to navigate the paginated list, as defined by RFC 8288. content: application/json: examples: account_numbers_list: value: - id: acno_2daFu0zqqDtZGJaSi2TGI2Mm1nN object: account_number account_id: acc_2hQ9vBmKpR7xLtZ3sWn1fJ4dGcA created_at: '2026-03-01T12:00:00.000Z' deleted_at: null description: Payouts CLABE is_root: false last_transfer_at: null metadata: invoice_id: '12345' mode: test number: '646180111800000000' options: min_amount: 1000 max_amount: 1000000 status: enabled updated_at: '2026-03-01T12:00:00.000Z' schema: type: array items: $ref: '#/components/schemas/account_number' '401': description: Invalid or missing API key. content: application/json: examples: invalid_api_key: value: error: type: authentication_error code: invalid_api_key message: 'Invalid API Key: invalid-*oken' schema: $ref: '#/components/schemas/error_object' security: - api_key: [] components: schemas: account_number: type: object properties: id: type: string description: Unique identifier of the account number. example: acno_2daFu0zqqDtZGJaSi2TGI2Mm1nN object: const: account_number description: Type of the object. Always `account_number`. account_id: type: string description: Identifier of the account this number belongs to. example: acc_2hQ9vBmKpR7xLtZ3sWn1fJ4dGcA created_at: type: string format: date-time description: Time the account number was created, as an ISO 8601 datetime in UTC. example: '2026-03-01T12:00:00.000Z' deleted_at: type: - string - 'null' description: >- Time the account number was deleted, as an ISO 8601 datetime in UTC, or `null` when not deleted. example: null description: type: - string - 'null' description: >- Free-text description of the account number, or `null` when none is set. example: Payouts CLABE is_root: type: boolean description: Whether this account number is the account's default. example: false last_transfer_at: type: - string - 'null' description: >- Time of the last transfer received, as an ISO 8601 datetime in UTC, or `null` when no transfer has been received. example: null metadata: type: object description: Set of key-value pairs attached to the account number. example: invoice_id: '12345' mode: type: string enum: - live - test description: Whether the account number holds `live` or `test` data. example: test number: type: string description: >- Account number that receives inbound transfers. In Mexico, the 18-digit standardized Mexican bank account number (CLABE); in Chile, the bank account number. example: '646180111800000000' options: type: object description: Inbound transfer constraints for this account number. properties: min_amount: type: - integer - 'null' description: Minimum inbound amount, in the smallest currency unit. example: 1000 max_amount: type: - integer - 'null' description: Maximum inbound amount, in the smallest currency unit. example: 1000000 required: - min_amount - max_amount status: type: string enum: - enabled - disabled - blocked - deleted description: >- Current state of the account number. One of `enabled` (can receive inbound transfers), `disabled` (you turned off inbound transfers), `blocked` (Fintoc blocked inbound transfers), or `deleted` (removed; see `deleted_at`). example: enabled updated_at: type: string format: date-time description: >- Time the account number was last updated, as an ISO 8601 datetime in UTC. example: '2026-03-01T12:00:00.000Z' required: - id - object - account_id - created_at - deleted_at - description - is_root - last_transfer_at - metadata - mode - number - options - status - updated_at error_object: type: object properties: error: type: object description: Details of the error that caused the request to fail. properties: code: type: string description: >- Machine-readable code identifying the specific error, for example `invalid_request`. example: invalid_request doc_url: type: string description: >- URL of a documentation page with more details about the error. Not returned by every error. example: https://docs.fintoc.com/reference/errors message: type: string description: Human-readable message describing the error. example: 'Missing required param: account_id' param: type: - string - 'null' description: >- Name of the request parameter that caused the error. Not returned by every error. example: account_id type: type: string description: >- Category of the error, for example `invalid_request_error` or `authentication_error`. Not returned by every error. example: invalid_request_error required: - code - message required: - error securitySchemes: api_key: type: apiKey name: Authorization in: header ````