# Esankhyiki Mospi — Wrapped API

> **You are on:** `https://api.paywithlocus.com/api` | [llms.txt](https://paywithlocus.com/llms.txt) | [docs](https://docs.paywithlocus.com)
>
> Locus runs on multiple environments -- make sure every URL you call matches your expected environment.
> | Environment | Landing | API | Docs |
> |---|---|---|---|
> | Production | paywithlocus.com | api.paywithlocus.com | docs.paywithlocus.com |
> | Beta | beta.paywithlocus.com | api.beta.paywithlocus.com | docs.paywithlocus.com |
> | Stage | stage.paywithlocus.com | api.stage.paywithlocus.com | docs.paywithlocus.com |
>
> If the API URL above doesn't match your expected environment, re-fetch this file from the correct domain.

> Access India's official macroeconomic statistics including RBI indicators, National Accounts data, and labor force surveys directly from the government's statistical database. Browse dashboards, infographics, and detailed metadata to explore economic trends, employment figures, and key financial indicators.

**Category:** Government & Public Data | **Website:** [esankhyiki.mospi.gov.in/](https://esankhyiki.mospi.gov.in/) | **Docs:** [parse.bot/marketplace/283d5232-8e51-4ba7-9eaf-2a23e5180ac5/esankhyiki-mospi-gov-in-api](https://parse.bot/marketplace/283d5232-8e51-4ba7-9eaf-2a23e5180ac5/esankhyiki-mospi-gov-in-api)

Pay-per-use API proxy. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-esankhyiki-mospi-gov-in-api-283d5232/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_dashboard

Fetches key statistical highlights, themes, visual trends, infographic count, and the product list from the MoSPI dashboard. Returns the current state of the portal's front page data including theme classifications, trend visualizations, and all available statistical products.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-esankhyiki-mospi-gov-in-api-283d5232/get_dashboard \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_infographics

Fetches infographics with their metadata, key takeaways, source attribution, and base64-encoded image data. Returns paginated results ordered by infographic_order. Each infographic represents a statistical visualization published by MoSPI. Upstream may timeout with large limit values above 10 on later pages.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `limit` | integer | No | Number of records per page. Values above 10 may cause upstream timeouts on later pages. |
| `page` | integer | No | Page number for pagination. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-esankhyiki-mospi-gov-in-api-283d5232/get_infographics \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"limit":"<integer>","page":"<integer>"}'
```

### get_nas_data

Fetches paginated NAS data records for a given indicator, series, and frequency. Each record includes base year, industry breakdown, current and constant price values. Supports annual and quarterly frequencies with revision information.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `frequency_code` | string | No | Frequency code: '1' for Annual, '2' for Quarterly. |
| `indicator_code` | string | No | Indicator code from get_nas_indicators (e.g. '1' for Gross Value Added, '5' for GDP). |
| `limit` | integer | No | Number of records per page. |
| `page` | integer | No | Page number for pagination. |
| `series` | string | No | Price series: 'Current' or 'Back'. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-esankhyiki-mospi-gov-in-api-283d5232/get_nas_data \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"frequency_code":"<string>","indicator_code":"<string>","limit":"<integer>","page":"<integer>","series":"<string>"}'
```

### get_nas_filters

Fetches available filter options for a specific NAS indicator, series, and frequency combination. Returns filter configuration that varies by indicator selection. May return an empty object when no additional filters are available for the given combination.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `frequency_code` | string | No | Frequency code: '1' for Annual, '2' for Quarterly. |
| `indicator_code` | string | No | Indicator code from get_nas_indicators (e.g. '1' for Gross Value Added, '5' for GDP). |
| `series` | string | No | Price series: 'Current' or 'Back'. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-esankhyiki-mospi-gov-in-api-283d5232/get_nas_filters \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"frequency_code":"<string>","indicator_code":"<string>","series":"<string>"}'
```

### get_nas_indicators

Fetches the NAS (National Accounts Statistics) configuration including available base years, price series, frequencies, and indicator lists. The response distinguishes between annual and quarterly indicators. Use these codes with get_nas_data and get_nas_filters.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-esankhyiki-mospi-gov-in-api-283d5232/get_nas_indicators \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_plfs_data

Fetches paginated PLFS data records for a given indicator and frequency. Records include demographic breakdowns by state, gender, sector, age group, social group, religion, and education level. Supports optional year filtering by calendar year.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `frequency_code` | string | No | Frequency code from get_plfs_frequency: '1' for Annually, '2' for Quarterly, '3' for Monthly. |
| `indicator_code` | string | No | Indicator code from get_plfs_indicators (e.g. '1' for LFPR, '2' for WPR, '3' for UR). |
| `limit` | integer | No | Number of records per page. |
| `page` | integer | No | Page number for pagination. |
| `year` | string | No | Calendar year to filter by (e.g. '2022', '2023'). Must be a four-digit calendar year, not a fiscal year range. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-esankhyiki-mospi-gov-in-api-283d5232/get_plfs_data \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"frequency_code":"<string>","indicator_code":"<string>","limit":"<integer>","page":"<integer>","year":"<string>"}'
```

### get_plfs_frequency

Fetches available frequencies for PLFS (Periodic Labour Force Survey) data. Returns the frequency codes and their descriptions. Use these codes with get_plfs_indicators and get_plfs_data.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-esankhyiki-mospi-gov-in-api-283d5232/get_plfs_frequency \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_plfs_indicators

Fetches PLFS indicators available for a given frequency. Each indicator has a code, description, and supported visualization types. Use with get_plfs_data to retrieve actual labour force data records.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `frequency_code` | string | No | Frequency code from get_plfs_frequency: '1' for Annually, '2' for Quarterly, '3' for Monthly. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-esankhyiki-mospi-gov-in-api-283d5232/get_plfs_indicators \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"frequency_code":"<string>"}'
```

### get_product_metadata

Fetches metadata for a specific statistical product including its category, data source, time period coverage, frequency, and key statistics. The product_id is a short string identifier obtained from the dashboard products list. Returns a single product metadata object.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `product_id` | string | Yes | Product ID from the dashboard products list. Known values: 'rbi', 'nas', 'plfs', 'cpi', 'nss75e', 'nss76', 'nss76c', 'asuse', 'ec4', 'ec5', 'ec6', 'esi', 'mnre'. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-esankhyiki-mospi-gov-in-api-283d5232/get_product_metadata \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"product_id":"<string>"}'
```

### get_rbi_indicators

Fetches the complete list of RBI (Reserve Bank of India) indicators with their codes, labels, and visualization types. Each indicator can be used with get_rbi_records to retrieve actual data records. Returns all indicators in a single response.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-esankhyiki-mospi-gov-in-api-283d5232/get_rbi_indicators \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_rbi_records

Fetches paginated data records for a specific RBI indicator. Each record contains the indicator name, year, trade direction, geographic grouping, value, and unit. Use indicator codes from get_rbi_indicators as the sub_indicator_code parameter.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `limit` | integer | No | Number of records per page. |
| `page` | integer | No | Page number for pagination. |
| `sub_indicator_code` | string | Yes | Indicator code from get_rbi_indicators (e.g. '1' for Direction of Foreign Trade - Rupees, '22' for Balance of Payments). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-esankhyiki-mospi-gov-in-api-283d5232/get_rbi_records \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"limit":"<integer>","page":"<integer>","sub_indicator_code":"<string>"}'
```