# 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 for Locus Pro. Each call burns credits from your workspace balance.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/credits/incometaxindia/`
**Auth:** `Authorization: Bearer <LOCUS_CREDITS_SECRET_KEY>` (an `lcr_` secret key or a scoped `lcac_` agent credential)
**Required header:** `Idempotency-Key: <fresh UUID per call>`. A retry with the same key replays the stored result without a new charge.
**Response:** the provider response after any endpoint-specific normalization. `X-Locus-Credits-Charged` carries the charge and `X-Locus-Credits-Balance` the remaining balance. Insufficient credits return `402` before the provider is called.
**Pricing:** estimated costs below are USD. Locus debits the credit equivalent at your workspace rate.

Full call contract: https://docs.paywithlocus.com/api-reference/introduction

> Using a Pay With Locus wallet key (`claw_` prefix)? Wallet routes are documented separately: https://docs.paywithlocus.com/wrapped-apis/for-agents

## 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/credits/incometaxindia/get-all-notifications-by-year \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/incometaxindia/get-notifications \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/incometaxindia/get-years \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

## Next steps

- [All wrapped API providers](https://paywithlocus.com/wapi/index.md): pick another provider.
- [Find and call tools](https://paywithlocus.com/agent/tools.md): price ceilings, async results, and errors.
- [Credits and billing](https://paywithlocus.com/agent/billing.md): what a call costs and how to add credits.
- [Agent docs index](https://paywithlocus.com/agent/index.md): every Locus agent page.