# Bank of Zambia — 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 historical and current 91-day treasury bill auction data from the Bank of Zambia, including tender results, bid amounts, prices, and yield rates spanning from 2014 to present. Search and retrieve structured tender information to analyze Zambia's treasury bill market trends and performance over time.

**Category:** Finance & Markets | **Website:** [www.boz.zm/treasury-bills-results.htm](https://www.boz.zm/treasury-bills-results.htm) | **Docs:** [parse.bot/marketplace/73928735-f433-4861-8f25-845652d98171/boz-zm-api](https://parse.bot/marketplace/73928735-f433-4861-8f25-845652d98171/boz-zm-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-boz-zm-api-73928735/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_tbill_auction_data

Retrieve treasury bill auction results for a specified tenor (91, 182, 273, or 364 days). Returns auction dates, tender numbers, ISINs, discount rates, yield rates, and PDF URLs. Data availability: 2026 records include full rate data (ISIN, discount rate, yield rate); older migrated records (2014-2025) include auction date, tender number, and PDF URL but may lack rate fields. Results sorted by auction date descending. Paginates through all matching records automatically.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `tenor` | string | No | Treasury bill tenor in days. |
| `year` | string | No | Year(s) to retrieve data for. Single year (e.g. '2026'), comma-separated years (e.g. '2025,2026'), or 'all' for all available years (2014-present). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-boz-zm-api-73928735/get_tbill_auction_data \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"tenor":"<string>","year":"<string>"}'
```

### list_tender_pdfs

List all treasury bill tender result PDF URLs organized by year. Returns PDF download URLs for tender result documents from the Bank of Zambia website. Each year group includes a count and the full list of URLs. Results cover all tenors combined for the given year(s).

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `year` | string | No | Year(s) to list PDFs for. Single year (e.g. '2026'), comma-separated years (e.g. '2025,2026'), or 'all' for all available years (2014-present). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-boz-zm-api-73928735/list_tender_pdfs \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"year":"<string>"}'
```