# Ncvbdc Mohfw — 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.

> Track real-time surveillance data on malaria, dengue, chikungunya, kalaazar, and Japanese encephalitis cases across India, along with disease reports, clinical guidelines, and official announcements from India's National Center for Vector Borne Diseases Control. Access annual disease reports, latest news updates, and recruitment information all in one place.

**Category:** Government & Public Data | **Website:** [ncvbdc.mohfw.gov.in/](https://ncvbdc.mohfw.gov.in/) | **Docs:** [parse.bot/marketplace/f0ddda52-6eca-4c8c-bf1f-fd66d014a724/ncvbdc-mohfw-gov-in-api](https://parse.bot/marketplace/f0ddda52-6eca-4c8c-bf1f-fd66d014a724/ncvbdc-mohfw-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-ncvbdc-mohfw-gov-in-api-f0ddda52/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_chikungunya_situation_data

Fetches and parses the Chikungunya Situation page. Returns state-wise suspected and confirmed chikungunya cases data as tabular arrays, plus the source file URL.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-ncvbdc-mohfw-gov-in-api-f0ddda52/get_chikungunya_situation_data \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_dengue_situation_data

Fetches and parses the Dengue Situation HTML table from the NCVBDC site. Returns state-wise dengue cases and deaths data across multiple years as a two-dimensional array of cell strings (rows × columns), including header rows.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-ncvbdc-mohfw-gov-in-api-f0ddda52/get_dengue_situation_data \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_disease_page_info

Returns metadata and all available links for a given vector-borne disease page on the NCVBDC site. Each link includes its title and full URL.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `disease` | string | No | Disease name to look up. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-ncvbdc-mohfw-gov-in-api-f0ddda52/get_disease_page_info \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"disease":"<string>"}'
```

### get_guidelines

Fetches the list of available clinical and operational guidelines documents from the NCVBDC guidelines page. Returns an array of guideline items each with title and download URL.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-ncvbdc-mohfw-gov-in-api-f0ddda52/get_guidelines \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_je_cases_deaths_data

Fetches and parses the Japanese Encephalitis (JE) cases and deaths data page. Returns state-wise JE surveillance data as tabular arrays, plus the source file URL.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-ncvbdc-mohfw-gov-in-api-f0ddda52/get_je_cases_deaths_data \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_kalaazar_situation_data

Fetches and parses the Kala-azar (Visceral Leishmaniasis) Situation page. Returns state-wise cases and deaths data as tabular arrays across multiple years, plus the source file URL.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-ncvbdc-mohfw-gov-in-api-f0ddda52/get_kalaazar_situation_data \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_malaria_annual_report

Fetches the Malaria Annual Report download URL for a specific year. Returns the direct PDF URL, the year, and the link title. Reports are available for years 2010 through 2024.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `year` | string | No | Year of the report (4-digit year string). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-ncvbdc-mohfw-gov-in-api-f0ddda52/get_malaria_annual_report \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"year":"<string>"}'
```

### get_malaria_situation_data

Fetches the malaria situation page and returns the main malaria situation PDF URL and a list of all available document links (annual reports, surveillance formats, advisories). Each link includes its title and direct URL.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-ncvbdc-mohfw-gov-in-api-f0ddda52/get_malaria_situation_data \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_malaria_situation_file_url

Returns the direct download URL and title of the current Malaria Situation PDF document from the NCVBDC malaria page.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-ncvbdc-mohfw-gov-in-api-f0ddda52/get_malaria_situation_file_url \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_news_and_highlights

Scrapes recent news, highlights, and document links from the NCVBDC homepage. Returns an array of news items each with title and URL.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-ncvbdc-mohfw-gov-in-api-f0ddda52/get_news_and_highlights \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_vacancies

Fetches the list of current vacancies and job postings from the NCVBDC vacancies page. Returns an array of vacancy items each with title, download URL, and details array.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-ncvbdc-mohfw-gov-in-api-f0ddda52/get_vacancies \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```