Simple access to BondGov issuer and disclosure data.

Authenticate In One Minute

# Bash / Linux
export BONDGOV_API_KEY="bgv1_your_key_here"

curl -s "https://bondgov.com/api/v1/investor-documents/auth/" \
  -H "Authorization: Bearer $BONDGOV_API_KEY"

# PowerShell
$env:BONDGOV_API_KEY="bgv1_your_key_here"

curl.exe -s "https://bondgov.com/api/v1/investor-documents/auth/" `
  -H "Authorization: Bearer $env:BONDGOV_API_KEY"

# Python
import os, requests

base = "https://bondgov.com/api/v1/investor-documents"
headers = {"Authorization": f"Bearer {os.environ['BONDGOV_API_KEY']}"}

auth = requests.get(f"{base}/auth/", headers=headers, timeout=30)
auth.raise_for_status()

docs = requests.get(
    f"{base}/doclist/",
    params={"cusip": "123456AB7", "scope": "all"},
    headers=headers,
    timeout=30,
)
docs.raise_for_status()
document = docs.json()["documents"][0]

prepare = requests.post(
    document["links"]["prepare"],
    params={"include": "download,text", "background": "true"},
    headers=headers,
    timeout=30,
)
prepare.raise_for_status()

status = requests.get(document["links"]["status"], headers=headers, timeout=30)
status.raise_for_status()

# JavaScript
const base = "https://bondgov.com/api/v1/investor-documents";
const headers = { Authorization: `Bearer ${process.env.BONDGOV_API_KEY}` };

const auth = await fetch(`${base}/auth/`, { headers });
if (!auth.ok) throw new Error(await auth.text());

const docs = await fetch(`${base}/doclist/?cusip=123456AB7&scope=all`, { headers });
if (!docs.ok) throw new Error(await docs.text());
const document = (await docs.json()).documents[0];

const prepare = await fetch(`${document.links.prepare}?include=download,text&background=true`, {
  method: "POST",
  headers
});
if (!prepare.ok) throw new Error(await prepare.text());

const status = await fetch(document.links.status, { headers });
if (!status.ok) throw new Error(await status.text());

Investor Document API

curl -s "https://bondgov.com/api/v1/investor-documents/doclist/?cusip=123456AB7&scope=all&limit=100" \
  -H "Authorization: Bearer $BONDGOV_API_KEY"

curl -X POST "https://bondgov.com/api/v1/investor-documents/{document_id}/prepare/?include=download,text&background=true" \
  -H "Authorization: Bearer $BONDGOV_API_KEY"

curl -I "https://bondgov.com/api/v1/investor-documents/{document_id}/download/" \
  -H "Authorization: Bearer $BONDGOV_API_KEY"

curl -L "https://bondgov.com/api/v1/investor-documents/{document_id}/download/" \
  -H "Authorization: Bearer $BONDGOV_API_KEY" \
  -o disclosure.pdf

curl -s "https://bondgov.com/api/v1/investor-documents/{document_id}/text/?include=sections,tables" \
  -H "Authorization: Bearer $BONDGOV_API_KEY"

Document Lifecycle

Doclist supports safe filters: scope, limit, cursor, category, source, date_from, date_to, cache_status, and text_status. CUSIP6 searches are intentionally rejected in v1; send a full CUSIP9.

Scopes And Limits

Every investor document response includes X-BondGov-Request-ID for support correlation. Quota headers are returned when limits apply. Request responses include X-BondGov-RateLimit-Limit, X-BondGov-RateLimit-Remaining, and X-BondGov-RateLimit-Reset. Download responses can also include X-BondGov-Download-Limit, X-BondGov-Download-Used, and X-BondGov-Download-Remaining. Pending and temporary-failure responses include retry_after_seconds, Retry-After, and docs_url.

My API Keys Workspace

Errors

Integration Best Practices

Issuer Financials API

Up to ten fiscal years of income-statement totals extracted from an issuer's filed annual financial statements, with the source document, page, column and extractor confidence attached to every figure. Coverage is deliberately narrow today. Only statements an operator has reviewed and accepted are readable, and the accepted corpus is a small fraction of what has been extracted. Read coverage.accepted_statement_count on every response — it is the measured number for that issuer, and it may be zero.

curl -s "https://bondgov.com/api/v1/issuer-financials/state-of-california/income-statement/?years=10" \
  -H "Authorization: Bearer $BONDGOV_API_KEY"

Public Issuer API

Issuer search, CUSIP6 lookup, feeds, and embeddable profile widgets remain public read-only endpoints. These do not use investor document API keys.