> ## Documentation Index
> Fetch the complete documentation index at: https://ecourtsindia.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# List states/UTs

> Returns 38 states/UTs. Free, no auth. SC = Supreme Court.



## OpenAPI

````yaml https://openapi.gitbook.com/o/X2HbEVfDbyhRjXFDsXJM/spec/ecourtsindia-api.json get /api/CauseList/court-structure/states
openapi: 3.0.3
info:
  title: eCourtsIndia API
  version: '4.0'
  description: >-
    Official REST API for India's largest court-data layer — 27.9 crore+ case
    records across the Supreme Court, 25 High Courts, 600+ district courts and
    tribunals. Search cases, read order text and AI summaries, fetch cause
    lists, and refresh live case data.


    - Docs: https://ecourtsindia.com/api/docs

    - Pricing: https://ecourtsindia.com/api/pricing

    - Developer guide:
    https://blogs.ecourtsindia.com/2026/05/18/how-to-use-ecourtsindia-api/


    Auth: send `Authorization: Bearer eci_live_...` on every call (except Court
    Structure). Court Structure and Enums are free; most other calls consume API
    credits. Responses follow `{ data, meta:{ request_id } }`. A CNR is the
    16-char case id `[A-Z]{4}\d{12}`.
  contact:
    name: eCourtsIndia
    url: https://ecourtsindia.com/api
servers:
  - url: https://webapi.ecourtsindia.com
    description: Partner API
security:
  - bearerAuth: []
tags:
  - name: Court Structure
    description: Walk States > Districts > Complexes > Courts. Free, no auth.
  - name: Reference
    description: Live enum dictionaries. Free.
  - name: Cases
    description: Case retrieval and refresh.
  - name: Orders
    description: Order PDF, markdown and AI analysis.
  - name: Search
    description: Solr full-text search with 40+ filters.
  - name: Cause List
    description: Daily court schedules.
paths:
  /api/CauseList/court-structure/states:
    get:
      tags:
        - Court Structure
      summary: List states/UTs
      description: Returns 38 states/UTs. Free, no auth. SC = Supreme Court.
      responses:
        '200':
          description: Success
          content:
            application/json:
              example:
                - state: DL
                  stateName: Delhi
                - state: MH
                  stateName: Maharashtra
                - state: SC
                  stateName: India
                - state: KA
                  stateName: Karnataka
      security: []
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: eci_live_...
      description: Your API key from https://ecourtsindia.com/dashboard/settings

````