---
title: "List supported states"
method: GET
path: "/states"
tags: ["Reference data"]
---

# List supported states

`GET /states`

## Request

- Base URL: `https://esahayak.io/api/v1`
- URL: `https://esahayak.io/api/v1/states`
- Auth: HTTP bearer

## Response `200`

All configured states with their option flags.

- object
  - `data` StateListItem[]
    - `name` string, required
    - `code` string, required
    - `minAmount` number, nullable
    - `maxAmount` number, nullable
    - `amountMultipleOf` number, nullable: The state sells stamps only in whole multiples of this face value (₹), e.g. 10 for Uttar Pradesh — ₹100 or ₹110, never ₹101. Null when any whole amount is accepted. Off-step denominations fail /validate + /create with AMOUNT_NOT_MULTIPLE.
    - `eStampAvailable` boolean, nullable
    - `traditionalAvailable` boolean, nullable
    - `sroRequired` boolean
    - `cessRequired` boolean
    - `propertyAreaRequired` boolean
    - `fatherHusbandNameRequired` boolean, nullable
    - `firstPartyAddressRequired` boolean, nullable
    - `panCardImageRequired` boolean, nullable
    - `payerGenderRequiredAboveAmount` number: Payer gender (payerGender) is required when the denomination exceeds this face value in catalogue states. For the full per-combination requirement set use GET /states/{code}/requirements.
  - `count` integer

## Other responses

- `401`: Missing / invalid / expired / revoked key

## Changes

- **2026-11-03** `cca124862a3e`: 1 info
  - added the optional property `data/items/amountMultipleOf` to the response with the `200` status

[Operation history](https://skmtc.dev/esahayak/apis/esahayak-stamp-api/changes/states/get.md)

---

[API](https://skmtc.dev/esahayak/apis/esahayak-stamp-api.md) - [All operations](https://skmtc.dev/esahayak/apis/esahayak-stamp-api/llms.txt) - [OpenAPI document](https://skmtc.dev/esahayak/apis/esahayak-stamp-api/revisions/cca124862a3e?raw)