> ## Documentation Index > Fetch the complete documentation index at: https://docs.gnosispay.com/llms.txt > Use this file to discover all available pages before exploring further. # List accounts > Lists accounts available to the authenticated partner. Use the filters to reconcile an interrupted onboarding flow. Results use cursor pagination and are sorted by `created_at`, newest first. You can combine `created_at_start` and `created_at_end`. Do not combine `external_reference` or `kyc_profile_id` with other filters; the response is 400. ## OpenAPI ````yaml https://core.sandbox.gnosispay.in/partner-api/openapi.json get /v1/accounts openapi: 3.1.0 info: title: Gnosis Pay Partner API version: 1.0.0 description: >- Server-to-server API for onboarding users, creating accounts and cards, moving funds, and managing the card lifecycle. Call this API only from a trusted backend. Every request requires a partner access token, and every resource is scoped to the authenticated partner. servers: - url: https://core.prod.gnosispay.com/partner-api description: Production variables: {} - url: https://core.sandbox.gnosispay.in/core description: Sandbox variables: {} security: - BearerAuth: [] tags: - name: Accounts - name: Cards - name: Card transactions - name: KYC - name: Deposits - name: Withdrawals - name: PCI - name: 3DS - name: Webhooks paths: /v1/accounts: get: tags: - Accounts summary: List accounts description: >- Lists accounts available to the authenticated partner. Use the filters to reconcile an interrupted onboarding flow. Results use cursor pagination and are sorted by `created_at`, newest first. You can combine `created_at_start` and `created_at_end`. Do not combine `external_reference` or `kyc_profile_id` with other filters; the response is 400. operationId: accounts.list.v1 parameters: - name: external_reference in: query required: false description: >- Filter by your client-provided external reference. Do not use other filters with this filter. schema: $ref: '#/components/schemas/ExternalReference' explode: false - name: kyc_profile_id in: query required: false description: Filter by KYC profile ID. Do not use other filters with this filter. schema: $ref: '#/components/schemas/uuid' explode: false - name: created_at_start in: query required: false description: Filter accounts created on or after this date. schema: type: string format: date-time explode: false - name: created_at_end in: query required: false description: Filter accounts created on or before this date. schema: type: string format: date-time explode: false - name: page_size in: query required: false description: The number of accounts on each page (1-100). schema: type: integer format: int32 minimum: 1 maximum: 100 default: 10 explode: false - name: page_cursor in: query required: false description: >- The cursor of the page to return. Its value comes from `pagination.next_page_cursor` in the previous response. schema: type: string explode: false responses: '200': description: The request has succeeded. content: application/json: schema: type: object required: - data - pagination properties: data: type: array items: $ref: '#/components/schemas/Account' pagination: $ref: '#/components/schemas/PaginationInfo' description: Paginated response containing data and pagination metadata default: description: An unexpected error response. content: application/json: schema: $ref: '#/components/schemas/Error' components: schemas: ExternalReference: type: string minLength: 1 maxLength: 128 pattern: ^[A-Za-z0-9_-]+$ description: >- Your identifier for reconciliation. 1 to 128 letters, digits, underscores or hyphens. uuid: type: string format: uuid Account: type: object required: - id - kyc_profile_id - funding - native_currency - additional_currencies - status - created_at - updated_at - provisioned_at - closed_at properties: id: $ref: '#/components/schemas/uuid' description: Unique identifier for the account. kyc_profile_id: $ref: '#/components/schemas/uuid' description: UUID of the KYC profile linked to this account. funding: $ref: '#/components/schemas/Funding' description: How the account is funded. `type` determines the fields of `config`. external_reference: $ref: '#/components/schemas/ExternalReference' description: Client-provided external reference for the account. native_currency: type: string description: Primary currency for the account. additional_currencies: type: array items: type: string description: Additional currencies supported by the account. status: $ref: '#/components/schemas/AccountStatus' description: Current account status. created_at: type: string format: date-time description: When the account was created. updated_at: type: string format: date-time description: When the account was last updated. provisioned_at: anyOf: - type: string format: date-time - type: 'null' description: When the account was fully provisioned. Null if still provisioning. closed_at: anyOf: - type: string format: date-time - type: 'null' description: When the account was closed. Null if not closed. examples: - id: 019cbf58-1b2a-7c3d-9e4f-5a6b7c8d9e0f kyc_profile_id: 019cbf57-758a-7589-8676-835804fa8c44 funding: id: 019cbf58-1b2a-7c3d-9e4f-5a6b7c8d9e0f type: safe_wallet config: safe_owner_address: '0xC0FFEE254729296a45a3885639AC7E10F9d54979' safe_address: '0x5afe5afe5afe5afe5afe5afe5afe5afe5afe5afe' chain: name: gnosis id: '100' external_reference: user-1234 native_currency: EUR additional_currencies: - USD - GBP status: active created_at: '2025-06-15T14:30:00Z' updated_at: '2025-06-15T14:32:00Z' provisioned_at: '2025-06-15T14:32:00Z' closed_at: null PaginationInfo: type: object required: - next_page_cursor - has_next properties: next_page_cursor: anyOf: - type: string - type: 'null' description: Base64-encoded cursor for the next page, null if no more items has_next: type: boolean description: True if there are more items available description: Pagination metadata for cursor-based pagination Error: type: object required: - code - message properties: code: type: integer format: int32 description: HTTP status code. message: type: string description: Generic human-readable text for the status code. Do not parse it. reason: type: string description: >- Stable machine-readable code identifying the specific cause, present only for errors that expose one (e.g. `CREATE_CARD_LIMIT_EXCEEDED`). Branch on this rather than on `message`. Funding: type: object oneOf: - $ref: '#/components/schemas/SafeWalletFunding' discriminator: propertyName: type mapping: safe_wallet: '#/components/schemas/SafeWalletFunding' description: >- Funding source of an account. `type` tells which fields `config` has; only `safe_wallet` exists today. AccountStatus: type: string enum: - provisioning - active - blocked - closed SafeWalletFunding: type: object required: - id - type - config properties: id: $ref: '#/components/schemas/uuid' description: Unique identifier for the funding. type: type: string enum: - safe_wallet description: Funding type. config: $ref: '#/components/schemas/SafeWalletFundingConfig' description: Safe wallet details. description: The account is funded through a Safe wallet. title: Safe Wallet Funding examples: - id: 019cbf58-1b2a-7c3d-9e4f-5a6b7c8d9e0f type: safe_wallet config: safe_owner_address: '0xC0FFEE254729296a45a3885639AC7E10F9d54979' safe_address: '0x5afe5afe5afe5afe5afe5afe5afe5afe5afe5afe' chain: name: gnosis id: '100' SafeWalletFundingConfig: type: object required: - safe_owner_address - safe_address - chain properties: safe_owner_address: type: string description: The address that owns the Safe wallet. safe_address: anyOf: - type: string - type: 'null' description: >- The Safe wallet address. Deposits go to this address and withdrawals are sent from it. Null until the Safe is deployed. chain: $ref: '#/components/schemas/Chain' description: The chain the Safe wallet is deployed on. description: Details of the Safe wallet that funds an account. examples: - safe_owner_address: '0xC0FFEE254729296a45a3885639AC7E10F9d54979' safe_address: '0x5afe5afe5afe5afe5afe5afe5afe5afe5afe5afe' chain: name: gnosis id: '100' Chain: type: object required: - name - id properties: name: $ref: '#/components/schemas/ChainName' description: Chain name identifier. id: $ref: '#/components/schemas/ChainID' description: Numeric chain ID. examples: - name: gnosis id: '100' ChainName: type: string enum: - celo - gnosis ChainID: type: string enum: - '42220' - '100' securitySchemes: BearerAuth: type: http scheme: Bearer ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.