Quickstart

Run the server locally, set your API key, and call the API. Every example below works against the real product.

1. Start the server

python3 -m grantradar.app   # stdlib only, no install needed

2. Set your API key

export GRANTRADAR_API_KEY="your-key-here"   # see .env.example

When the key is set, programmatic /api/* calls require an X-API-Key header. Full endpoint reference: OPENAPI.md in the repo.

3. Try it

Track a grant

curl -s -X POST localhost:8473/api/grants -H "Content-Type: application/json" -H "X-API-Key: $GRANTRADAR_API_KEY" -d '{"funder":"Ford Foundation","program":"BUILD","proposal_deadline":"2027-01-10"}'

Advance the status

curl -s -X PUT localhost:8473/api/grants/1 -H "Content-Type: application/json" -H "X-API-Key: $GRANTRADAR_API_KEY" -d '{"status":"drafting"}'

Radar board

curl -s localhost:8473/api/radar

Client status report

curl -s localhost:8473/api/grants/1/report