---
title: "Validate Customised Card Number."
method: POST
path: "/api/v1/card/custom-pan"
tags: ["Card"]
---

# Validate Customised Card Number.

`POST /api/v1/card/custom-pan`

## Headers

- `X-Correlation-ID` string

## Request body

- CustomPanData — Request for validating a customised card number.
  - `productId` integer, required — The unique ID of the card product linked to the card.
  - `customPan` string, nullable, required — Last six digits of the card number used as a customise card number.
  - `panOptions` PanOption[], nullable, required
    - `id` integer — The unique identification number of each secondary option.
    - `pan` string, nullable — Digits 11-15 of the customised card number for the secondary option used.

## Response `200`

Success

- union — Response for the Validate Customised Card Number endpoint.
  - object
    - `customPan` string, nullable — Last 6 digits of the customised card number.
    - `isCustomPanValid` true — Indicates whether the customer given number is valid or not.
    - `referenceNumber` integer, nullable — A unique random number used as a reference for the customised card number.
    - `panOptions` unknown[] — Object that displays secondary options, Only available when the customPan in the request is not valid.
      - unknown
  - object
    - `customPan` string, nullable — Last 6 digits of the customised card number.
    - `isCustomPanValid` false — Indicates whether the customer given number is valid or not.
    - `referenceNumber` integer, nullable — A unique random number used as a reference for the customised card number.
    - `panOptions` PanOptionResponse[], nullable — Object that displays secondary options, Only available when the customPan in the request is not valid.
      - `id` integer — The unique identification number of each secondary option, same as that in the request.
      - `pan` string, nullable — Last 6 digits of the customised card number from the secondary option.
      - `referenceNumber` integer — A unique random number used to refer the custom card number from the secondary options.

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `409` — Conflict
- `500` — Server Error

---

[API](https://skmtc.dev/thredd/apis/core-cards.md) · [All operations](https://skmtc.dev/thredd/apis/core-cards/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/thredd/core-cards/revisions/841f62def5bf/schema)