Quickstart

Sign up, get a key, make your first call.

1. Sign up

   Go to portal.congress.minaki.io and click Sign in → Register. Email, password, done.

   We verify your email so we can let you know about deprecations. That's it. No payment, no tier choice, no “contact sales.”

2. Create your API key

   After signup you'll land on your dashboard. Click Create new key. Copy the key immediately — it's shown once and not retrievable later. Lost keys are easily revoked + reissued from the same page.

   # Save your key somewhere — your shell config, a secret manager, .env file:
   export MINAKI_API_KEY="ct_live_xxxxxxxxxxxxxxxxxxxxxxxx"

3. Make your first call

   Use the apikey header on every call. The headline endpoint is /v1/meta: it returns dataset coverage, freshness, license, and the resolution-quality numbers.

   curl -H "apikey: $MINAKI_API_KEY" \
        https://api.congress.minaki.io/v1/meta | jq '.datasets | keys'

   Returns:

   [
     "congress",
     "contracts",
     "lobbying"
   ]

4. Read each dataset's headline

   Congress trades

   curl -H "apikey: $MINAKI_API_KEY" \
        "https://api.congress.minaki.io/v1/trades?ticker=NVDA&limit=3"

   Returns recent congressional NVDA trades, with party, state, and disclosure date.

   Federal contracts

   curl -H "apikey: $MINAKI_API_KEY" \
        "https://api.congress.minaki.io/v1/contracts/LMT" | \
        jq '{ticker, total_contracts, total_award_dollars}'

   Returns Lockheed Martin's federal contract aggregate (including Sikorsky & other subsidiaries, all rolled up to LMT via EDGAR).

   Corporate lobbying

   curl -H "apikey: $MINAKI_API_KEY" \
        "https://api.congress.minaki.io/v1/lobbying/MSFT" | \
        jq '{ticker, total_filings, total_income, top_issues: .top_issues[0:3]}'

   Microsoft's lobbying spend, registrants, and issue codes lobbied.

5. Mind the rate limits

   Free tier: 60 requests/minute, 5,000 requests/day. Every response carries the limit + remaining counters as headers so you can back off cleanly:

   HTTP/2 200
   ratelimit-limit: 60
   ratelimit-remaining: 59
   ratelimit-reset: 39
   x-ratelimit-limit-day: 5000
   x-ratelimit-remaining-day: 4997

   Exceeding the limit returns 429 Too Many Requests with a Retry-After header in seconds.

6. Browse the full reference

   Every endpoint, every filter, every response field is on the API reference. It's generated live from the API's OpenAPI spec — what's documented is what's deployed.