boz.zm APIwww.boz.zm ↗
Access structured treasury bill auction data from the Bank of Zambia. Covers 91, 182, 273, and 364-day tenors with ISINs, discount rates, yield rates, and PDF URLs from 2014.
curl -X GET 'https://api.parse.bot/scraper/82d5a744-254f-4636-a255-bcae0d6624e5/get_tbill_auction_data?year=2026' \ -H 'X-API-Key: $PARSE_API_KEY'
Retrieve treasury bill auction results with details for a specified tenor (91, 182, 273, or 364 days). Returns auction dates, tender numbers, ISINs, discount rates, yield rates, and PDF URLs. Data is available from 2014 to present. Results are sorted by auction date descending.
| Param | Type | Description |
|---|---|---|
| year | string | 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). |
| tenor | string | Treasury bill tenor in days. Accepted values: '91', '182', '273', '364'. |
{
"type": "object",
"fields": {
"tenor": "string indicating the tenor queried (e.g. '91_days')",
"results": "array of auction result objects with year, tender_number, auction_date, pdf_url, isin, discount_rate, yield_rate",
"total_records": "integer count of auction records returned",
"years_queried": "array of year strings included in the query"
},
"sample": {
"data": {
"tenor": "91_days",
"results": [
{
"isin": "ZM3000013836",
"year": "2026",
"pdf_url": "https://www.boz.zm/sites/default/files/2026-04/Treasury-Bills-Results-Tender-No-09-2026-30-04-2026.pdf",
"yield_rate": "10.7500",
"auction_date": "2026-04-30",
"discount_rate": "10.4695",
"tender_number": "09/2026"
}
],
"total_records": 9,
"years_queried": [
"2026"
]
},
"status": "success"
}
}About the boz.zm API
The boz.zm API exposes treasury bill auction results from the Bank of Zambia across two endpoints, returning structured data including tender numbers, ISINs, discount rates, yield rates, auction dates, and PDF document URLs. The get_tbill_auction_data endpoint covers all four standard tenors — 91, 182, 273, and 364 days — with records spanning from 2014 to the present, queryable by year or tenor.
Endpoints and Coverage
The API provides two endpoints. get_tbill_auction_data returns structured auction result records for a specified tenor (91, 182, 273, or 364 days). Each record includes the auction_date, tender_number, isin, discount_rate, yield_rate, and a pdf_url pointing to the official tender result document. Results are sorted by auction date descending and can be filtered using the year parameter, which accepts a single year string (e.g. '2025'), a comma-separated list (e.g. '2024,2025'), or 'all' for the full historical dataset.
PDF Access
The list_tender_pdfs endpoint returns all tender result PDF URLs organized by year. The response shape is an object (pdfs_by_year) that maps each year to a count and an array of direct PDF URLs, plus a total_pdfs integer for the full query scope. This endpoint accepts the same year parameter, making it straightforward to pull document references for a specific period without fetching full auction metadata.
Data Fields and Scope
Across both endpoints, the year filter controls scope without requiring pagination logic — requesting 'all' returns the complete dataset from 2014 onward. The total_records field in get_tbill_auction_data gives an immediate count of matched rows. Note that data availability for specific years and tenors reflects what the Bank of Zambia has published; early years may have fewer records for certain tenors.
- Plot yield rate trends for 364-day Zambian treasury bills from 2014 to present using
yield_ratefields. - Build a bond research tool that maps ISINs to historical discount rates across all four tenors.
- Automate a weekly digest of new auction results by querying
get_tbill_auction_datafor the current year. - Download official tender result PDFs in bulk using URLs returned by
list_tender_pdfs. - Compare discount rates across 91-day and 182-day tenors for a given year to analyze the yield curve.
- Populate a fixed-income database with structured tender numbers and auction dates for Zambian T-bills.
- Monitor newly listed ISINs from recent auctions to support secondary market analysis.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does the Bank of Zambia provide an official developer API?+
What does `get_tbill_auction_data` return for a given tenor, and how do I narrow the year range?+
results, each containing tender_number, auction_date, isin, discount_rate, yield_rate, and pdf_url. Use the year parameter to scope the query: a single year string, a comma-separated list, or 'all' for the full 2014-to-present dataset. The total_records field in the response reflects the count of matched records.Are bid amounts, accepted amounts, or oversubscription ratios included in the auction data?+
discount_rate, yield_rate, tender_number, auction_date, isin, and pdf_url per auction. Bid volume, accepted amounts, and subscription ratios are not exposed as structured fields. You can fork this API on Parse and revise it to extract those fields from the linked tender result PDFs.