---
title: "PIN Code Lookup"
method: GET
path: "/lookup"
---

# PIN Code Lookup

`GET /lookup`

Instantpay's PIN Code Verification Service gives businesses data on specific postal PIN codes. This helps them make better decisions and work more efficiently. This service verifies a PIN code. It then provides detailed location info. This helps with logistics, service delivery, and demographics.

The PIN Code Verification Service is ideal for businesses needing accurate regional data. It helps ensure compliance with specific geographic requirements. Use this solution to streamline location-based processes. It will improve customer service and support planning with accurate data.

## Headers

- `X-Ipay-Auth-Code` string
- `X-Ipay-Client-Id` string
- `X-Ipay-Client-Secret` string
- `X-Ipay-Endpoint-Ip` string

## Request body

- object
  - `pincode` string — pin code.
  - `latitude` string — End Customer Latitude.
  - `longitude` string — End Customer Longitude.
  - `externalRef` string — Your Unique Transaction id

## Response `200`

200

- object
  - `statuscode` string
  - `actcode` unknown
  - `status` string
  - `data` object
    - `poolReferenceId` string
    - `pool` object
      - `account` string
      - `openingBal` string
      - `mode` string
      - `amount` string
      - `closingBal` string
    - `pincodeDetails` object
      - `pincode` string
      - `city` string
      - `district` string
      - `stateName` string
      - `stateCode` string
      - `gstStateCode` string
      - `stateZone` string
      - `geoLat` string
      - `geoLong` string
  - `timestamp` string
  - `ipay_uuid` string
  - `orderid` string
  - `environment` string
  - `internalCode` unknown

## Other responses

- `400` — 400

---

[API](https://skmtc.net/instantpay/apis/identity.md) · [All operations](https://skmtc.net/instantpay/apis/identity/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/instantpay/identity/versions/1d0672797b14/schema)