> ## Documentation Index > Fetch the complete documentation index at: https://docs.trio.com.br/llms.txt > Use this file to discover all available pages before exploring further. # List Cards > List cards, without their balance. Read a card for its balance. ## OpenAPI ````yaml v2/api-reference/openapi.json GET /v2/cards openapi: 3.0.0 info: title: Trio API v2 version: 2026-10-19.v2 servers: - url: https://api.sandbox.trio.com.br variables: {} - url: https://api.qa.trio.com.br variables: {} - url: https://api.trio.com.br variables: {} security: [] tags: [] paths: /v2/cards: parameters: - description: >- Version of the v2 contract the client is written against. Each breaking change publishes a new version. example: 2026-10-19.v2 in: header name: Trio-Version required: true schema: enum: - 2026-10-19.v2 type: string x-struct: null x-validate: null - description: >- ID of another org to act on instead of the API key's own org. The key's org must have been granted access to it, and the request is refused with 403 FORBIDDEN otherwise. When that access or the API key is read-only, only GET and HEAD requests may carry it. When the target org requires mTLS, so does the request. Leave it out to act on the key's own org. in: header name: Trio-Target-Org-Id required: false schema: format: uuid type: string x-struct: null x-validate: null get: tags: - Cards summary: List cards description: List cards, without their balance. Read a card for its balance. operationId: TrioFoundationWeb.V2.CardController.index parameters: - description: Entity ID in: query name: entity_id required: true schema: $ref: '#/components/schemas/UUID' - description: Card Last Four Digits in: query name: card_last_digits required: false schema: type: string x-struct: null x-validate: null - description: Card Display Name in: query name: display_name required: false schema: type: string x-struct: null x-validate: null - description: Card Holder Name in: query name: holder_name required: false schema: type: string x-struct: null x-validate: null - description: Card Holder Tax Number in: query name: holder_tax_number required: false schema: type: string x-struct: null x-validate: null - description: >- Parameter used for pagination. It is a base64 encoded param used to access the previous page of results. It is provided alongside a metadata section if there is a previous page. example: >- g3QAAAABZAACaWRtAAAAJDU4ZjFlYzhlLWFmYTktNDk0My05M2I1LWQ2ZGM3OWI0M2VhYQ== in: query name: before required: false schema: type: string x-struct: null x-validate: null - description: >- Parameter used for pagination. It's a base64 encoded param used to access the previous page of results. Provided along with the data in the metadata section if there is a previous page. example: >- g3QAAAABZAACaWRtAAAAJGJhYTNiNmM1LTAyYTYtNGQ5Ny05NzU1LTI3OGFiNjRiN2Y1MQ== in: query name: after required: false schema: type: string x-struct: null x-validate: null - description: Parameter used for pagination. in: query name: limit required: false schema: type: integer x-struct: null x-validate: null responses: '200': content: application/json: schema: $ref: '#/components/schemas/V2_list_cards_response' description: Cards '400': content: application/json: schema: $ref: '#/components/schemas/V2_error' description: >- Malformed request: a body that is not valid JSON (MALFORMED_REQUEST), or a Trio-Version header that is missing or not the current one (INVALID_TRIO_VERSION). '401': content: application/json: schema: $ref: '#/components/schemas/V2_error' description: Missing or invalid API key credentials (INVALID_CREDENTIALS). '403': content: application/json: schema: $ref: '#/components/schemas/V2_error' description: >- The API key may not do this (FORBIDDEN): for instance Trio-Target-Org-Id names an org it has no access to, or writes through a read-only access. '422': content: application/json: schema: $ref: '#/components/schemas/V2_error' description: >- Invalid input (INVALID_PARAMETER, REQUIRED_PARAMETER, or the code of the rule the request breaks). A request outside the operation's schema lists the offending fields in `errors`. '503': content: application/json: schema: $ref: '#/components/schemas/V2_error' description: >- A service needed to answer is unavailable (TRIO_SERVICE_UNAVAILABLE). callbacks: {} security: - authorization: [] components: schemas: UUID: description: Unique identifier format: uuid title: UUID type: string x-struct: null x-validate: null V2_list_cards_response: description: A page of cards. Read a card for its balance. example: data: - display_name: marketing card entity_id: 019514eb-5d5c-4a1e-9f0b-1c2d3e4f5a6b id: 019514eb-5d5c-b395-5a77-449d12701ce7 masked_number: •••• •••• •••• 1234 status: active type: virtual metadata: after: null before: null has_more: false properties: data: items: $ref: '#/components/schemas/V2_card' type: array x-struct: null x-validate: null metadata: $ref: '#/components/schemas/V2_card_list_metadata' required: - data - metadata title: V2 list cards response type: object x-struct: Elixir.TrioFoundationWeb.Schemas.Banking.V2.Card.ListResponse x-validate: null V2_error: example: error: error_code: INVALID_PARAMETER error_message: 'Invalid parameters: /amount: Invalid integer. Got: string' errors: - field: /amount message: 'Invalid integer. Got: string' properties: error: properties: error_code: description: >- Stable UPPER_SNAKE identifier of the error, for programs and logs. Branch on this, not on the message. type: string x-struct: null x-validate: null error_message: description: Human readable explanation of the error. type: string x-struct: null x-validate: null errors: description: >- Only on INVALID_PARAMETER for a request outside the operation's schema: one entry per offending field. items: properties: field: description: JSON pointer to the field, e.g. /amount. type: string x-struct: null x-validate: null message: description: What is wrong with it. type: string x-struct: null x-validate: null required: - field - message type: object x-struct: null x-validate: null type: array x-struct: null x-validate: null required: - error_code - error_message type: object x-struct: null x-validate: null required: - error title: V2 error type: object x-struct: Elixir.TrioFoundationWeb.Schemas.HTTP.V2Error x-validate: null V2_card: description: Card, without its balance example: display_name: marketing card entity_id: 019514eb-5d5c-4a1e-9f0b-1c2d3e4f5a6b id: 019514eb-5d5c-b395-5a77-449d12701ce7 masked_number: •••• •••• •••• 1234 status: active type: virtual properties: display_name: description: Display name type: string x-struct: null x-validate: null entity_id: description: ID of the entity that holds the card format: uuid type: string x-struct: null x-validate: null id: description: Card ID format: uuid type: string x-struct: null x-validate: null masked_number: description: Masked card number type: string x-struct: null x-validate: null status: description: Card status enum: - created - pending - active - blocked - expired - canceled type: string x-struct: null x-validate: null type: description: Card type enum: - virtual type: string x-struct: null x-validate: null required: - id - display_name - entity_id - masked_number - status - type title: V2 card type: object x-struct: Elixir.TrioFoundationWeb.Schemas.Banking.V2.Card.Data x-validate: null V2_card_list_metadata: description: Pagination cursors example: after: null before: null has_more: false properties: after: description: Cursor to the next page nullable: true type: string x-struct: null x-validate: null before: description: Cursor to the previous page nullable: true type: string x-struct: null x-validate: null has_more: description: Whether a next page exists type: boolean x-struct: null x-validate: null required: - after - before - has_more title: V2 card list metadata type: object x-struct: Elixir.TrioFoundationWeb.Schemas.Banking.V2.Card.ListMetadata x-validate: null securitySchemes: authorization: scheme: basic type: http ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.