> ## 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 accounts > Lists the accounts of your organization for the `live` or `test` mode of the API key used. Filter by `entity_id` and `status`. 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 /accounts openapi: 3.1.0 info: title: Fintoc API version: v2026-02-01 servers: - url: https://api.fintoc.com/v2 security: [] paths: /accounts: get: tags: - Accounts summary: List accounts description: >- Lists the accounts of your organization for the `live` or `test` mode of the API key used. Filter by `entity_id` and `status`. 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: accounts-list parameters: - name: entity_id in: query required: false schema: type: string description: >- Identifier of the entity whose accounts are returned. If omitted, returns only the accounts of your root entity. - name: status in: query required: false schema: type: string enum: - active - blocked - closed description: >- Status of the accounts to return. One of `active`, `blocked`, `closed`. - name: starting_after in: query required: false schema: type: string example: acc_2rNxBkOrlHoOYsZTyQYhA0o8Ek0 description: >- Cursor for pagination. Use the ID of the last account on the current page to fetch the next page. - name: ending_before in: query required: false schema: type: string example: acc_2rNxBkOrlHoOYsZTyQYhA0o8Ek0 description: >- Cursor for pagination. Use the ID of the first account on the current page to fetch the previous page. - name: limit in: query required: false schema: type: integer example: 50 description: >- Maximum number of accounts to return per page. Ranges from `1` to `300`. Defaults to `30`. responses: '200': description: List of accounts 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: accounts_list: value: - id: acc_2daFu0zqqDtZGJaSi2TGI2Mm1nN object: account available_balance: 1050000 currency: MXN description: Main collection account entity: id: ent_2eGhTp1rLqWnXkZbYc4JsKmAvD9 holder_id: '000000000' holder_name: Test Customer 1 is_root: true is_root: true mode: test root_account_number: '646180111800000000' root_account_number_id: acno_2fJkRm7tBvQxNzYpLc5WsHaDfT3 status: active schema: type: array items: $ref: '#/components/schemas/account' '400': description: The request parameters are invalid. content: application/json: examples: invalid_status: value: error: code: invalid_enum message: >- Invalid status: pending. Must be one of 'active', 'blocked' or 'closed'. schema: $ref: '#/components/schemas/error_object' '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: type: object properties: id: type: string description: Unique identifier of the account. example: acc_2daFu0zqqDtZGJaSi2TGI2Mm1nN object: const: account description: Type of the object. Always `account`. available_balance: type: integer description: >- Available balance of the account, in the smallest currency unit. For MXN the smallest unit is the centavo; for CLP it is the peso, which has no minor unit. example: 1050000 currency: type: string enum: - CLP - MXN description: ISO 4217 currency code of the account. One of `CLP`, `MXN`. example: MXN description: type: - string - 'null' description: Free-text description of the account, or `null` when none is set. example: Main collection account entity: type: object description: Owner entity of the account. properties: id: type: string description: Identifier of the entity. example: ent_2eGhTp1rLqWnXkZbYc4JsKmAvD9 holder_id: type: string description: >- Tax identifier of the owner. A Chilean tax ID (RUT) or a Mexican tax ID (RFC). example: '000000000' holder_name: type: string description: Legal name of the owner. example: Test Customer 1 is_root: type: boolean description: Whether this entity is the root entity. example: true required: - id - holder_id - holder_name - is_root is_root: type: boolean description: Whether this account is the organization's root account. example: true mode: type: string enum: - live - test description: Whether the account holds `live` or `test` data. example: test root_account_number: type: string description: >- Default account number of the account. In Mexico, the 18-digit standardized bank account number (CLABE); in Chile, the bank account number. example: '646180111800000000' root_account_number_id: type: string description: Identifier of the default account number. example: acno_2fJkRm7tBvQxNzYpLc5WsHaDfT3 status: type: string enum: - active - blocked - closed description: Status of the account. One of `active`, `blocked`, `closed`. example: active required: - id - object - available_balance - currency - description - entity - is_root - mode - root_account_number - root_account_number_id - status 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 ````