> ## Documentation Index > Fetch the complete documentation index at: https://docs.finup.io/llms.txt > Use this file to discover all available pages before exploring further. # List account cards > Filters and pagination are both optional; pagination defaults to page 1, 50 per page. Money fields are decimal strings on this endpoint. ## OpenAPI ````yaml /openapi.json post /cards/get openapi: 3.1.0 info: title: Finup Public API version: 1.0.0 description: >- Client-facing Finup API reference generated from current public endpoint metadata. servers: - url: https://api.finup.io/backend description: Production security: [] tags: - name: Accounts description: Current account, account setup, and account capabilities. - name: Transactions description: Account transaction lists and aggregates. - name: Cards description: Card issuing, listing, funding, and status changes. paths: /cards/get: post: tags: - Cards summary: List account cards description: >- Filters and pagination are both optional; pagination defaults to page 1, 50 per page. Money fields are decimal strings on this endpoint. requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/CardsRequest' responses: '200': description: Success content: application/json: schema: type: object required: - result properties: result: type: array items: $ref: '#/components/schemas/CardListItem' pagination: $ref: '#/components/schemas/Pagination' '401': description: Missing or invalid credentials '403': description: Insufficient permission for this operation '404': description: Resource not found security: - apiKeyAuth: [] components: schemas: CardsRequest: type: object properties: filters: $ref: '#/components/schemas/CardFilters' pagination: $ref: '#/components/schemas/PaginationInput' CardListItem: type: object properties: id: type: string example: 67c48f6fc8614632e0b338fc name: type: string example: Marketing card bin: type: string example: '505849' description: Human-readable 6-digit BIN. bin_id: type: string example: 67bcf2abf8e89d31c5f8995e account: type: string example: 67c401f9a5b7cde210f44567 user: type: string example: 67aa1b2c3d4e5f6789abcdef holder: $ref: '#/components/schemas/CardHolder' nullable: true status: type: string enum: - blocked - closed - closing - enabled - freezed - freezing - processing - unreezing example: enabled category: type: string enum: - business - platinum - advertising example: business currency: type: string example: USD masked_PAN: type: string nullable: true example: 1234 56•• •••• 5678 EXP: type: string example: '**/**' balance: type: string description: Decimal money string in USD. example: '50.00' deposit: type: string description: Decimal money string in USD. example: '1000.00' withdraw: type: string description: Decimal money string in USD. example: '500.00' balance_type: type: string enum: - balance - limit example: limit nullable: true limit_amount: type: string description: >- Spending limit (decimal money string in USD), or null for balance cards and unlimited limit cards. example: '500.00' nullable: true limit_period: type: string enum: - one_day - seven_days - thirty_days - all_time - per_transaction example: thirty_days nullable: true limit_spent: type: string description: >- Spend already used in the current limit window. Lifetime total for an unlimited card; null for "per_transaction". example: '123.45' nullable: true balance_possibility: type: boolean example: true limit_possibility: type: boolean example: true auto_deposit: type: boolean example: false balance_threshold: type: string description: Decimal money string in USD. example: '25.00' top_up_amount: type: string description: Decimal money string in USD. example: '100.00' tags: type: array items: $ref: '#/components/schemas/CardTag' created_at: type: string format: date-time Pagination: type: object properties: current_page: type: integer example: 1 total_records: type: integer nullable: true example: 42 description: >- Total matching records. Always null on POST /transactions — call POST /transactions/count for the totals. total_pages: type: integer nullable: true example: 5 CardFilters: type: object properties: status: type: array items: type: string enum: - blocked - closed - closing - enabled - freezed - freezing - processing - unreezing example: enabled example: - enabled - freezed balance_type: type: array items: type: string enum: - balance - limit example: limit description: >- Keep only cards of these balance models. Pass one ("balance" or "limit") or both. example: - balance - limit own: type: boolean example: true users: type: array items: type: string search: type: string example: marketing tag_ids: type: array items: type: string bin_ids: type: array items: type: string balance_min: type: number example: 10 balance_max: type: number example: 1000 PaginationInput: type: object properties: page: type: integer minimum: 1 default: 1 example: 1 per_page: type: integer minimum: 1 maximum: 100 default: 50 example: 50 sort_by: type: string example: created_at sort_direction: type: string enum: - asc - desc default: desc example: desc CardHolder: type: object properties: id: type: string example: 67aa1b2c3d4e5f6789abcdef first_name: type: string nullable: true example: Alex last_name: type: string nullable: true example: Morgan email: type: string nullable: true example: alex@example.com CardTag: type: object properties: id: type: string example: 67fc3d0a766d7a2c1fafefb7 name: type: string example: Ads color: type: string example: '#3B66FF' securitySchemes: apiKeyAuth: type: apiKey in: header name: x-api-key ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.