# e-Stamp Catalog Discovery API

> Discover which e-Stamp instruments/services are available to your organization. Endpoint: `GET https://api-b2b.stampmitra.in/v1/services`.

API fee: ₹5 per successful call, pay-as-you-go (lower on Growth and Scale). State procurement fee and stamp duty are quoted per order. Sandbox keys are free. Prices exclude 18% GST.

- HTML docs: https://developer.stampmitra.in/docs/estamp/estamp-catalog
- Product page: https://developer.stampmitra.in/products/estamp-catalog
- Pricing: https://developer.stampmitra.in/pricing
- Authentication: https://developer.stampmitra.in/docs/auth

## List entitled services (generic catalog, covers e-Stamp services too)

`GET https://api-b2b.stampmitra.in/v1/services`

Required scope: `services.read`

Returns every service (verification AND e-Stamp) this organization is entitled to. There is no e-Stamp-specific catalog endpoint yet; e-Stamp instruments surface here as regular service entries once entitled.

### Parameters

- `Authorization` (header, required): Bearer <api-key> (e.g. sk_test_... in sandbox, sk_live_... in production). The x-api-key header is also accepted.

### Response example

```json
[
  {
    "serviceCode": "estamp.instrument.rent_agreement",
    "name": "Rent Agreement e-Stamp",
    "category": "estamp",
    "basePrice": "500.00",
    "currency": "INR",
    "isActive": true,
    "gstRatePercent": "18.00",
    "defaultGovernmentFee": null,
    "processingTimeHours": 24,
    "guestCheckoutEnabled": false,
    "requiresDocuments": true,
    "uiSchema": null,
    "entitled": true,
    "entitlementUpdatedAt": "2026-09-01T10:00:00.000Z"
  }
]
```

## Get one entitled service's detail

`GET https://api-b2b.stampmitra.in/v1/services/:serviceCode`

Required scope: `services.read`

Detail for a single serviceCode, if entitled and active.

### Parameters

- `Authorization` (header, required): Bearer <api-key> (e.g. sk_test_... in sandbox, sk_live_... in production). The x-api-key header is also accepted.
- `serviceCode` (path, required): The service's unique code.

### Response example

```json
{
  "serviceCode": "estamp.instrument.rent_agreement",
  "name": "Rent Agreement e-Stamp",
  "category": "estamp",
  "basePrice": "500.00",
  "currency": "INR",
  "isActive": true,
  "gstRatePercent": "18.00",
  "defaultGovernmentFee": null,
  "processingTimeHours": 24,
  "guestCheckoutEnabled": false,
  "requiresDocuments": true,
  "uiSchema": null,
  "entitled": true,
  "entitlementUpdatedAt": "2026-09-01T10:00:00.000Z"
}
```