---
title: "Retrieve Data from Locker"
method: POST
path: "/data/retrieve"
tags: ["Cards", "Data"]
---

# Retrieve Data from Locker

`POST /data/retrieve`

Retrieve sensitive data from the locker

## Headers

- `x-tenant-id` string

## Request body

- union
  - RetrieveDataReq
    - `merchant_id` string
    - `merchant_customer_id` string
    - `card_reference` string
  - JWEReq
    - `header` string
    - `iv` string
    - `encrypted_payload` string
    - `tag` string
    - `encrypted_key` string

## Response `200`

Retrieve Data Response

- union
  - RetrieveDataRes — Response received with the sensitive data, associated to the card reference
    - `status` 'Ok'
    - `payload` union
      - object
        - `card` Card
          - `card_number` string, required — The card number
          - `card_exp_month` string, required — The card's expiry month
          - `card_exp_year` string, required — The card's expiry year
          - `card_holder_name` string, required — The card holder's name
          - `card_cvc` string, required — The CVC number for the card
          - `card_issuer` string, nullable — The name of the issuer of card
          - `card_network` 'Visa' | 'Mastercard' | 'AmericanExpress' | 'JCB' | 'DinersClub' | 'Discover' | 'CartesBancaires' | 'UnionPay' | 'Interac' | 'RuPay' | 'Maestro' | 'Star' | 'Pulse' | 'Accel' | 'Nyce' | 'Prop' | 'PrivateLabel' | 'Dinacard' — Indicates the card network.
          - `card_type` string, nullable
          - `card_issuing_country` string, nullable
          - `card_issuing_country_code` string, nullable
          - `bank_code` string, nullable
          - `nick_name` string, nullable — The card holder's nick name
      - object
        - `enc_card_data` string
  - JWERes — JWE encrypted response equivalent
    - `header` string
    - `iv` string
    - `encrypted_payload` string
    - `tag` string
    - `encrypted_key` string

---

[API](https://skmtc.net/hyperswitch/apis/dynamic-routing-openapi-3-0.md) · [All operations](https://skmtc.net/hyperswitch/apis/dynamic-routing-openapi-3-0/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/hyperswitch/dynamic-routing-openapi-3-0/revisions/8fbf69ab2597/schema)