# Incometaxindia — 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.

> Search and retrieve official Income Tax Department notifications from India spanning over 60 years, with the ability to filter by year, search by text, and browse through paginated results. Access detailed information about each notification including its number, title, date, documents, and categories to stay updated on tax policy changes and regulatory updates.

**Category:** Government & Public Data | **Website:** [www.incometaxindia.gov.in/notifications](https://www.incometaxindia.gov.in/notifications) | **Docs:** [parse.bot/marketplace/075c8e2b-16a0-4ed9-a88a-9106556c24bc/incometaxindia-gov-in-api](https://parse.bot/marketplace/075c8e2b-16a0-4ed9-a88a-9106556c24bc/incometaxindia-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-incometaxindia-gov-in-api-075c8e2b/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_all_notifications_by_year

Bulk-fetch all notifications for a given year by auto-paginating through every page internally. Returns the complete set with total and fetched counts. Suitable for archival or full-year analysis. The max_pages param caps iteration to prevent runaway requests.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `max_pages` | integer | No | Maximum pages to fetch (safety limit). |
| `page_size` | integer | No | Items per page for internal pagination. |
| `year` | string | Yes | Year to fetch all notifications for (e.g. '2024'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-incometaxindia-gov-in-api-075c8e2b/get_all_notifications_by_year \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"max_pages":"<integer>","page_size":"<integer>","year":"<string>"}'
```

### get_notifications

Search and browse notifications with optional year filter, text search, and pagination. Returns one page of results with pagination metadata (total_count, last_page). Each notification includes its number, title, dates, document info, and categories. Omitting all filters returns the most recent notifications across all years.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page` | integer | No | Page number (1-based). |
| `page_size` | integer | No | Number of results per page. |
| `search` | string | No | Search text to filter notifications by keyword. |
| `year` | string | No | Filter by year (e.g. '2024'). Omit to return notifications from all years. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-incometaxindia-gov-in-api-075c8e2b/get_notifications \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"page":"<integer>","page_size":"<integer>","search":"<string>","year":"<string>"}'
```

### get_years

Retrieve the complete list of years for which notifications are available. Returns year strings from 1961 through the current year. Useful for discovering valid year values before filtering notifications.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-incometaxindia-gov-in-api-075c8e2b/get_years \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```