# Get Customer Token by Token ID

**Method:** `GET`

**Path:** `/api/v1/customer/{customer_id}/tokens/{token_id}`

**Category:** Tokenization

**Authentication:** Required

## Description

Retrieve a specific token linked to a customer by both the customer ID and token ID.


## Path Parameters

- `customer_id` (`string`) **required** — Unique identifier of the customer in the Pine Labs Online database.
- `token_id` (`string`) **required** — Unique token ID to retrieve.

## Responses

- `200` — Customer token details retrieved successfully.
- `400` — 
- `401` — 
- `403` — 
- `404` — 
- `500` — 

### Response Schema

- `token_id` (`string`) — Unique token ID generated by Pine Labs Online.
- `merchant_token_reference` (`string`) — Merchant's token reference.
- `customer_id` (`string`) — Unique identifier of the customer.
- `status` (`INITIATED | ACTIVE | SUSPENDED | FAILED | DEACTIVATED`) — Current status of the token. - INITIATED: Token creation is initiated. - ACTIVE: Token is active and can be used for transactions. - SUSPENDED: Token is temporarily suspended. - FAILED: Token creation failed. - DEACTIVATED: Token has been deactivated. 
- `payment_method` (`CARD | UPI | POINTS`) — Payment method associated with the token.
- `expired_at` (`string`) — ISO 8601 UTC timestamp when the token expires.
- `created_at` (`string`) — ISO 8601 UTC timestamp when the token was created.
- `updated_at` (`string`) — ISO 8601 UTC timestamp when the token was last updated.
- `status_reason` (`string`) — Reason for the current token status.
- `merchant_metadata` (`object`) — Arbitrary key-value pairs for merchant use. Maximum 10 pairs, 256 characters each.
- `card_data` (`object`) — Card data associated with a token.
  - `last4_digit` (`string`) — Last 4 digits of the card number.
  - `card_type` (`CREDIT | DEBIT`) — Type of card.
  - `network_name` (`string`) — Card network name.
  - `issuer_name` (`string`) — Card issuer name.
  - `card_category` (`string`) — Category of the card.
  - `country_code` (`string`) — Country code of the card issuer.
  - `international` (`boolean`) — Whether the card is an international card.
  - `emi` (`boolean`) — Whether the card is eligible for EMI.
  - `cvv_required` (`boolean`) — Whether CVV is required for transactions with this token.

- `is_compliant` (`boolean`) — Indicates whether the token is compliant with regulatory requirements.

### Example Response

```json
{
  "token_id": "token-v1-1234567890-aa-ABCDEF",
  "merchant_token_reference": "token-ref-001",
  "customer_id": "cust-v1-0811030624-aa-RBDgpR",
  "status": "ACTIVE",
  "payment_method": "CARD",
  "expired_at": "2025-12-31T23:59:59.000000Z",
  "created_at": "2024-10-04T13:11:29.645591Z",
  "updated_at": "2024-10-04T13:11:29.645657Z",
  "status_reason": "Token activated successfully",
  "merchant_metadata": {
    "clientId": "DD",
    "transactionReferenceNo": "pine-1223",
    "merchantId": "1234",
    "tid": "9000990",
    "acquirerName": "HDFC_FSS",
    "isOfferDisplayRequired": "true",
    "OfferData": "UHJvZHVjdF9Db2RlPSIgIiZQcm9kdWN0X05hbWU9IiImUGF5bWVudF9Nb2RlPUJhbmsgRU1JJkNhcmRfVHlwZT1EZWJpdCBDYXJkJkJhbmtfTmFtZT1IREZDIERlYml0JkVNSV9UZW51cmU9NiZJbnRlcmVzdF9SYXRlPTkuMCZJbnRlcmVzdF9BbW91bnQ9MTM4MTQwJk1vbnRobHlfSW5zdGFsbG1lbnQ9ODk0NjkwJkF1dGhvcml6YXRpb25fQW1vdW50PTEwMCZMb2FuX2Jvb2tpbmdfQW1vdW50PTUyMzAwMDAmSW50ZXJlc3RfQ2FzaGJhY2tfQW1vdW50PTAmSW50ZXJlc3RfQ2FzaGJhY2tfVHlwZT1EZWZlcnJlZCZBZGRpdGlvbmFsX0Nhc2hiYWNrPSIiJkFkZGl0aW9uYWxfQ2FzaGJhY2tfVHlwZT0iIiZEZXNjcmlwdGlvbj1CYW5rIEVNSSZQcm9kdWN0X1ZhbHVlPTUyMzAwMDA",
    "tenant_id": "PGATPOS",
    "is_offer_validation_required": "true"
  },
  "card_data": {
    "last4_digit": "1112",
    "card_type": "CREDIT",
    "network_name": "Visa",
    "issuer_name": "HDFC Bank",
    "card_category": "CONSUMER",
    "country_code": "IN",
    "international": false,
    "emi": true,
    "cvv_required": true
  },
  "is_compliant": true
}
```

---

Reference: https://localhost:3000/api/tokenization/get-customer-token-by-token-id