> ## 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. # Get a card > Retrieves a virtual card by ID, including its current status, currencies, non-sensitive card metadata, and configured spending limit. ## OpenAPI ````yaml https://core.sandbox.gnosispay.in/partner-api/openapi.json get /v1/cards/{card_id} 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/cards/{card_id}: get: tags: - Cards summary: Get a card description: >- Retrieves a virtual card by ID, including its current status, currencies, non-sensitive card metadata, and configured spending limit. operationId: cards.get.v1 parameters: - name: card_id in: path required: true description: The card ID. schema: $ref: '#/components/schemas/uuid' responses: '200': description: The request has succeeded. content: application/json: schema: $ref: '#/components/schemas/CardDetails' default: description: An unexpected error response. content: application/json: schema: $ref: '#/components/schemas/Error' components: schemas: uuid: type: string format: uuid CardDetails: type: object required: - id - account_id - cardholder_id - status - native_currency - additional_currencies - name - type - printed_name - issuing_date - expiration_date - contactless_enabled - mode - brand - bin - last_4_digits - canceled_at - provisioned_at - limit properties: id: $ref: '#/components/schemas/uuid' description: Unique identifier for the card. account_id: $ref: '#/components/schemas/uuid' description: The account this card belongs to. cardholder_id: $ref: '#/components/schemas/uuid' description: The cardholder who owns this card. status: $ref: '#/components/schemas/CardStatus' description: Current card status. native_currency: type: string description: Primary currency for the card. additional_currencies: type: array items: type: string description: Additional currencies supported by the card. name: type: string description: Display name for the card. type: $ref: '#/components/schemas/CardType' description: Card type. printed_name: anyOf: - type: string - type: 'null' description: Name associated with the card, when available. issuing_date: anyOf: - type: string format: date-time - type: 'null' description: When the card was issued. expiration_date: anyOf: - type: string format: date-time - type: 'null' description: When the card expires. contactless_enabled: anyOf: - type: boolean - type: 'null' description: Whether contactless payments are enabled. mode: anyOf: - type: string - type: 'null' description: Card operation mode. brand: anyOf: - type: string - type: 'null' description: Card network brand (e.g., Visa, Mastercard). bin: anyOf: - type: string - type: 'null' description: Bank Identification Number (first 6-8 digits of card number). last_4_digits: anyOf: - type: string - type: 'null' description: Last 4 digits of the card number. canceled_at: anyOf: - type: string format: date-time - type: 'null' description: When the card was canceled. Null if not canceled. provisioned_at: anyOf: - type: string format: date-time - type: 'null' description: When the card was fully provisioned. limit: anyOf: - $ref: '#/components/schemas/CardLimitSummary' - type: 'null' description: >- Currently configured daily spending limit. Null if no limit has been set for this card. Call `GET /cards/{card_id}/limit` for today's spend and remaining headroom. 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`. CardStatus: type: string enum: - all - provisioning - pending_activation - active - blocked - canceled CardType: type: string enum: - virtual CardLimitSummary: type: object required: - amount - currency - decimals - sync_status - updated_at properties: amount: type: integer format: int64 description: Configured daily limit in the currency's smallest unit. currency: type: string description: ISO-4217 currency code. decimals: type: integer format: int32 description: >- Number of decimal places for this currency (2 for USD, EUR, and GBP). sync_status: type: string enum: - pending - synced - failed description: >- Application status of the limit. `pending` means the update is still being applied, `synced` means it is active, and `failed` means it could not be applied. updated_at: type: string format: date-time description: Last time this limit was modified. description: >- Configuration snapshot of a card's daily spending limit without today's usage. Call `GET /cards/{card_id}/limit` for `spent_today` and `remaining`. securitySchemes: BearerAuth: type: http scheme: Bearer ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.