---
title: "Article catalogue for a state"
method: GET
path: "/states/{code}/articles"
tags: ["Reference data"]
---

# Article catalogue for a state

`GET /states/{code}/articles`

## Request

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

Returns the list of stamp article types available in this state, with minimum amounts and allowed denominations. States without a fixed catalogue return an empty list.

## Path parameters

- `code` string, required

## Response `200`

Article list.

- object
  - `stateCode` string
  - `data` ArticleItem[]
    - `code` string, required
    - `description` string, required
    - `popular` boolean
    - `minimumAmount` number, required
    - `allowedAmounts` number[], nullable
    - `isSecondPartyNA` boolean: If true, second party is not required for this article.
  - `count` integer

## Other responses

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

---

[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)