---
title: "GST registrations filtered by category, business function, place, status, constitution and registration date, newest first. Email and mobile on keys with contact access."
method: GET
path: "/gst-registrations"
---

# GST registrations filtered by category, business function, place, status, constitution and registration date, newest first. Email and mobile on keys with contact access.

`GET /gst-registrations`

## Request

- Base URL: `https://indiacos.com/api/v1`
- URL: `https://indiacos.com/api/v1/gst-registrations`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-API-Key`
  - OAuth 2 (authorization code, authorization URL `https://indiacos.com/oauth/authorize`, token URL `https://indiacos.com/oauth/token`, scopes: `api`)

## Query parameters

- `category` string
- `function` string
- `state` string
- `district` string
- `city` string
- `pincode` string
- `status` string
- `constitution` string
- `registered_from` string
- `registered_to` string
- `has_contact` boolean
- `limit` integer
- `offset` integer

## Response `200`

List

- GstList
  - `count` integer
  - `limit` integer
  - `offset` integer
  - `next` string, nullable
  - `results` object[]
    - `gstin` string
    - `name` string
    - `legal_name` string, nullable
    - `trade_name` string, nullable
    - `category` string, nullable
    - `functions` string[]
    - `status` string, nullable
    - `address` object
    - `contact` object: Only on keys with contact access
      - `email` string, nullable
      - `mobile` string, nullable
    - `url` string

## Other responses

- `400`: Error
- `401`: Error
- `403`: Error
- `429`: Error

---

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