Simple access to BondGov issuer and disclosure data.

# 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());