# Licitacoes E — 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 analyze Brazilian public tenders from Banco do Brasil, including filtering by buyer and tender status to find procurement opportunities. Get detailed information about specific tenders to track bids, deadlines, and procurement details.

**Category:** Government & Public Data | **Website:** [licitacoes-e.com/](https://licitacoes-e.com/) | **Docs:** [parse.bot/marketplace/be4b8a85-167e-4e0d-9d90-90bbf8263025/licitacoes-e-com-api](https://parse.bot/marketplace/be4b8a85-167e-4e0d-9d90-90bbf8263025/licitacoes-e-com-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-licitacoes-e-com-api-be4b8a85/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_tender_details

Retrieves the comprehensive details of a specific tender by its numeric ID (Nº Licitação). Solves a reCAPTCHA challenge automatically as part of the request flow. Returns key-value pairs covering client, auctioneer, summary, dates, modality, status, and other metadata fields.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `tender_id` | string | Yes | The unique numeric identification number of the tender (e.g. '1055555'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-licitacoes-e-com-api-be4b8a85/get_tender_details \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"tender_id":"<string>"}'
```

### list_all_statuses

Returns the fixed list of possible tender statuses (Situação da licitação). These are the main lifecycle stages a tender passes through on the platform. Use the returned codes as input for list_buyers_by_status.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-licitacoes-e-com-api-be4b8a85/list_all_statuses \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### list_buyers_by_status

Lists all buyers (compradores) and their current tender counts for a specific main status code. Returns one row per buyer-sub_status combination. The response size varies by status — some statuses may return many rows while others may return few or none depending on current live data.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `status_code` | string | No | Main status code identifying the tender lifecycle stage to query. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-licitacoes-e-com-api-be4b8a85/list_buyers_by_status \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"status_code":"<string>"}'
```