> ## Documentation Index
> Fetch the complete documentation index at: https://www.marqeta.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Retrieve Card from Exception File

> Retrieves the exception file record for the specified card



## OpenAPI

````yaml GET /exception-file/{cardToken}
openapi: 3.0.3
info:
  title: Exception File Management
  description: >-
    Marqeta's Exception File Management service enables you to manage cards on
    the exception file.
  version: 0.0.1
  x-docs-collection: Core API
  contact:
    name: Marqeta
    url: https://www.marqeta.com
servers:
  - url: https://sandbox-api.marqeta.com/v3
security: []
tags:
  - name: Exception File
    description: >-
      Marqeta's Exception File Management service enables you to manage card
      entries on the exception file.
paths:
  /exception-file/{cardToken}:
    get:
      tags:
        - Exception File
      summary: Retrieves a card from the exception file
      description: >-
        Retrieves the exception file record for the specified card token.


        At this time, this endpoint returns only exception file records that
        were added or updated using the Exception File Management API.

        The card network's exception file is the source of truth, and the
        Marqeta platform does not yet reconcile this endpoint's data against
        records the card network maintains directly.

        Support for reconciling with the card network's records is coming soon.
      operationId: getCardFromExceptionFile
      parameters:
        - name: cardToken
          in: path
          required: true
          schema:
            type: string
            x-allowableValues: Valid card token
          description: >-
            Card token for which details need to be retrieved from the exception
            file.
        - $ref: '#/components/parameters/programHeaderParam'
      responses:
        '200':
          description: Exception file record for the specified card token
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ExceptionFileRecordResponse'
              example:
                card_token: 6a2b8c4e-1f3d-4a5b-9c7e-2d4f6a8b0c1e
                program_short_code: sqc9
                network: VISA
                action_code: CLOS
                action_type: ADD
                action_date: '2027-01-15'
                source: API
                created_at: '2026-10-17T14:32:08Z'
                last_modified_at: '2026-10-17T14:32:08Z'
        '400':
          description: Program is not onboarded for the exception file Management feature
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ExceptionFileMgmtResponse'
              example:
                message: >-
                  Program is not onboarded for the Exception File Management
                  feature
        '404':
          description: Card is not available in exception file
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ExceptionFileMgmtResponse'
              example:
                message: This card is not available in exception file
        '500':
          description: Internal server error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ExceptionFileMgmtResponse'
              example:
                message: Unable to process the request. Please retry later
      security:
        - zionToken: []
        - oauth2:
            - exception-file-mgmt-service:read
components:
  parameters:
    programHeaderParam:
      name: X-Marqeta-Program-Short-Code
      description: Program short code of the program managing the card.
      in: header
      example: sqc9
      required: true
      schema:
        type: string
        x-allowableValues: Valid program short code
  schemas:
    ExceptionFileRecordResponse:
      type: object
      example:
        card_token: 6a2b8c4e-1f3d-4a5b-9c7e-2d4f6a8b0c1e
        program_short_code: sqc9
        network: VISA
        action_code: CLOS
        action_type: ADD
        action_date: '2027-01-15'
        source: API
        created_at: '2026-10-17T14:32:08Z'
        last_modified_at: '2026-10-17T14:32:08Z'
      properties:
        card_token:
          type: string
          description: Unique identifier of the card on the exception file.
          example: 6a2b8c4e-1f3d-4a5b-9c7e-2d4f6a8b0c1e
          x-allowableValues: Valid card token
        program_short_code:
          type: string
          description: Program short code of the program managing the card.
          example: sqc9
          x-allowableValues: Valid program short code
        network:
          type: string
          description: Card network associated with the card.
          example: VISA
          enum:
            - VISA
        action_code:
          type: string
          description: >
            Code representing the action that was taken on the card.

            - `CLOS` - Card terminated / closed account

            - `LCPU` - Lost card

            - `SCPU` - Stolen card

            - `INVA` - Invalid / not found account

            - `PUWF` - Fraud pickup (non-specific)

            - `PUNF` - Pickup (no fraud)

            - `EXPC` - Expired card (authorization only; declines with response
            code 54)

            - `DNTH` - General block (authorization only; declines with response
            code 05)
          enum:
            - CLOS
            - LCPU
            - SCPU
            - INVA
            - PUWF
            - PUNF
            - EXPC
            - DNTH
          example: CLOS
        action_type:
          type: string
          description: Type of action recorded for the card on the exception file.
          example: ADD
          enum:
            - ADD
            - UPDATE
            - DELETE
        action_date:
          type: string
          format: date
          pattern: ^\d{4}-\d{2}-\d{2}$
          description: >-
            Purge date of the record in the exception file, in YYYY-MM-DD format
            (UTC).
          example: '2027-01-15'
        source:
          type: string
          description: Origin of the exception file record.
          example: API
          enum:
            - API
            - AUTO_ADD
        created_at:
          type: string
          format: date-time
          description: Date and time when the record was created, in UTC.
          example: '2026-10-17T14:32:08Z'
          x-allowableValues: |-
            *Format:*

            yyyy-MM-ddThh:mm:ssZ
        last_modified_at:
          type: string
          format: date-time
          description: Date and time when the record was last modified, in UTC.
          example: '2026-10-17T14:32:08Z'
          x-allowableValues: |-
            *Format:*

            yyyy-MM-ddThh:mm:ssZ
    ExceptionFileMgmtResponse:
      type: object
      properties:
        message:
          type: string
          description: Human-readable message describing the result of the request.
  securitySchemes:
    zionToken:
      type: http
      scheme: basic
    oauth2:
      type: oauth2
      flows:
        clientCredentials:
          tokenUrl: https://internal-auth.mq01-dev.marqeta.io/oauth/token
          scopes:
            exception-file-mgmt-service:read: Read exception file records
            exception-file-mgmt-service:write: Create, update, or delete exception file records

````

## Related topics

- [Exception File Management](/docs/core-api/exception-file-management.md)
- [Add Card to Exception File](/docs/core-api/exception-file-add.md)
- [Update Card on Exception File](/docs/core-api/exception-file-update.md)
- [Remove Card from Exception File](/docs/core-api/exception-file-remove.md)
- [Credit Cards](/docs/diva-api/credit-cards.md)
