> **Source:** https://knowledge.leegality.com/document-execution/api/list-stamp-groups
> **Site:** Leegality Knowledge Base — https://knowledge.leegality.com
> **About:** Leegality is a document execution platform covering eSigning, stamps, NeSL, workflows, and REST API integration.
> **Navigation:** Every article on this site has a plain-text version at `<article-url>.txt` (this format). To get an index of all articles with their `.txt` links, read: https://knowledge.leegality.com/llms.txt
> **AI Guide:** For instructions on how to navigate this knowledge base as an AI agent, read: https://knowledge.leegality.com/ai-readable.txt

---
# GET /v3.0/series/groups/list — List stamp groups

Returns details of all stamp groups in your account.

**Authentication:** `X-Auth-Token` header required on every request.

## Request URL

```
GET https://app1.leegality.com/api/v3.0/series/groups/list
```

**Environments:**
- Production: `https://app1.leegality.com/api/v3.0/series/groups/list`
- Sandbox: `https://sandbox.leegality.com/api/v3.0/series/groups/list`

---

## Responses

### 200 — Stamp groups retrieved successfully.

Response wrapper for the List Stamp Groups API.  On success (`status: 1`), `data.seriesGroups` contains the array of stamp groups. The `messages` array is empty on success.

| Field | Type | Required | Description | Example |
|-------|------|----------|-------------|---------|
| `status` | integer | No | API response status.  `1` = success, `0` = failure. Allowed: `0`, `1`. | `1` |
| `messages` | array\<Message\> | No | Array of response messages. Empty array `[]` on success. See **Message** below. | — |
| `data` | StampGroupListData | No | Contains the list of stamp groups in the account. See **StampGroupListData** below. | — |

#### Message

Message object containing a machine-readable code and a human-readable description. Used for success confirmations, errors, and warnings.

| Field | Type | Required | Description | Example |
|-------|------|----------|-------------|---------|
| `code` | string | No | Response message code. | `simpleWorkFlow.success` |
| `message` | string | No | Human-readable success or error message. | `Invitations sent successfully.` |

#### StampGroupListData

Contains the list of stamp groups in the account.

| Field | Type | Required | Description | Example |
|-------|------|----------|-------------|---------|
| `seriesGroups` | array\<StampGroupItem\> | No | Array of stamp group objects. Each object represents one stamp group configured in the account. See **StampGroupItem** below. | — |

##### StampGroupItem

Details of a single stamp group.  A stamp group bundles one or more stamp series under a common identifier, state, and maximum value limit.

| Field | Type | Required | Description | Example |
|-------|------|----------|-------------|---------|
| `groupName` | string | No | Display name of the stamp group. | `DL` |
| `groupNumber` | string | No | Unique identifier for the stamp group.  **Format:** State abbreviation followed by a number (e.g., `"MH01"`, `"DL02"`). | `DL01` |
| `maximumValuePermitted` | string | No | Maximum stamp value allowed for this group, in Indian Rupees.  **Format:** Numeric string (e.g., `"10000"`, `"1500"`). | `10000` |
| `series` | array\<StampGroupSeriesItem\> | No | Stamp series belonging to this group. See **StampGroupSeriesItem** below. | — |
| `state` | string | No | Indian state associated with this stamp group.  **Examples:** `"Maharashtra"`, `"Delhi"`. | `Delhi` |

###### StampGroupSeriesItem

A stamp series within a stamp group.

| Field | Type | Required | Description | Example |
|-------|------|----------|-------------|---------|
| `denomination` | string | No | Stamp paper denomination (face value) in Indian Rupees.  **Format:** Decimal string (e.g., `"100.0"`, `"53.0"`). | `100.0` |
| `seriesNumber` | string | No | Series number identifying the stamp series.  **Format:** Numeric string, typically zero-padded (e.g., `"01"`, `"07"`).  This matches the `seriesNumber` from the List Stamp Series API. | `03` |

### Sample Response (200)

```json
{
  "status": 1,
  "messages": [
    {
      "code": "simpleWorkFlow.success",
      "message": "Invitations sent successfully."
    }
  ],
  "data": {
    "seriesGroups": [
      {
        "groupName": "DL",
        "groupNumber": "DL01",
        "maximumValuePermitted": "10000",
        "series": [
          {
            "denomination": "100.0",
            "seriesNumber": "03"
          }
        ],
        "state": "Delhi"
      }
    ]
  }
}
```