# Mahatenders — 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 Maharashtra government tenders from mahatenders.gov.in, browsing them by closing date or by organization with full tender details and pagination support. Find and review procurement opportunities across different government departments in one place.

**Category:** Government & Public Data | **Website:** [mahatenders.gov.in/](https://mahatenders.gov.in/) | **Docs:** [parse.bot/marketplace/9b44be33-833f-4fe6-92b3-b076e00e9ef1/mahatenders-gov-in-api](https://parse.bot/marketplace/9b44be33-833f-4fe6-92b3-b076e00e9ef1/mahatenders-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-mahatenders-gov-in-api-9b44be33/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_tender_detail

Get full detailed information about a specific tender including basic details, fee information, EMD details, work item details, critical dates, and documents. If no tender_url is provided or the provided URL has an expired session token, returns details of the first available tender from the current listing.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `tender_url` | string | No | Full tender detail URL (from detail_url field in list_tenders_by_closing_date or list_tenders_by_organisation). Session tokens in URLs may expire; if expired, falls back to first available tender. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-mahatenders-gov-in-api-9b44be33/get_tender_detail \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"tender_url":"<string>"}'
```

### list_organisations

List all government organisations that have active tenders on the platform, along with their tender counts and URLs to view their tenders. No input parameters required.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-mahatenders-gov-in-api-9b44be33/list_organisations \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### list_tenders_by_closing_date

List tenders closing within 7 days from the Maharashtra eProcurement System. Returns tenders sorted by closing date with pagination support (10 tenders per page). Each tender includes basic metadata and a detail_url for fetching full information via the details() method.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page` | integer | No | Page number for pagination (10 tenders per page) |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-mahatenders-gov-in-api-9b44be33/list_tenders_by_closing_date \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"page":"<integer>"}'
```

### list_tenders_by_organisation

List all tenders for a specific organisation. Requires the organisation's tender list URL obtained from the list_organisations endpoint. The URL contains a session token; if it has expired, the endpoint will establish a fresh session and navigate to the organisation's tenders.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `org_url` | string | Yes | Organisation tender list URL from the list_organisations endpoint's tender_list_url field |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-mahatenders-gov-in-api-9b44be33/list_tenders_by_organisation \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"org_url":"<string>"}'
```