Quick Start
Get up and running in under a minute.
Get your API key
Sign in to Granted and generate an API key from your dashboard.
Make your first request
Use your key in the Authorization header.
curl -H "Authorization: Bearer ga_live_YOUR_KEY" \
"https://grantedai.com/api/v1/grants?status=active&limit=5"Parse the response
All responses follow a consistent JSON structure.
{
"data": [
{
"id": "abc-123",
"name": "Community Development Grant",
"funder": "Ford Foundation",
"amount_min": 50000,
"amount_max": 250000,
"deadline": "2026-04-15",
"status": "active",
"state": "NY"
}
],
"meta": {
"total": 1247,
"offset": 0,
"limit": 5
}
}Authentication
All API requests require a valid API key passed in the Authorization header.
Authorization: Bearer ga_live_YOUR_API_KEYAPI keys are tied to your Granted account. You can create up to 5 keys and revoke them at any time from the dashboard.
Rate limits are enforced per key on a rolling 24-hour window. The current limit is returned in the X-RateLimit-Limit response header.
API Endpoints
All endpoints are prefixed with the base URL and require authentication.
/api/v1/grantsSearch and list grants with filters
Parameters
q, status, funder, state, amount_min, amount_max, deadline_before, deadline_after, tags, offset, limit, sort
Example
https://grantedai.com/api/v1/grants?status=active&state=CA&limit=5/api/v1/grants/:idGet a single grant by ID
Example
https://grantedai.com/api/v1/grants/abc-123/api/v1/foundationsSearch and list foundations with filters
Parameters
q, state, ntee, assets_min, assets_max, giving_min, giving_max, offset, limit, sort
Example
https://grantedai.com/api/v1/foundations?state=NY&giving_min=1000000&sort=giving_desc/api/v1/foundations/:idGet foundation detail with financials and key people
Example
https://grantedai.com/api/v1/foundations/abc-123/api/v1/foundations/:id/grantsList grants given by a foundation
Parameters
q, year_min, year_max, amount_min, amount_max, offset, limit, sort
Example
https://grantedai.com/api/v1/foundations/abc-123/grants?year_min=2022/api/v1/searchSemantic search across grants and foundations (AI-powered)
Parameters
q (required), type (grants/foundations/all), limit, state
Example
https://grantedai.com/api/v1/search?q=climate+change+adaptation&type=all&limit=10Response Format
All responses use a consistent JSON envelope.
Success Response
{
"data": [ ... ],
"meta": {
"total": 1247,
"offset": 0,
"limit": 20
}
}Error Response
{
"error": {
"message": "Rate limit exceeded",
"status": 429
}
}Pagination
List endpoints support offset-based pagination.
| Parameter | Type | Default | Description |
|---|---|---|---|
| offset | integer | 0 | Number of results to skip |
| limit | integer | 20 | Results per page (max 100) |
# Page 1
GET /api/v1/grants?offset=0&limit=20
# Page 2
GET /api/v1/grants?offset=20&limit=20
# Page 3
GET /api/v1/grants?offset=40&limit=20Rate Limits
Rate limits are enforced per API key on a rolling 24-hour window.
| Header | Description |
|---|---|
| X-RateLimit-Limit | Your daily request quota |
| X-Api-Tier | Your current API tier (free/pro/enterprise) |
When the rate limit is exceeded, the API returns a 429 status code with a message indicating when the limit resets.
API Pricing
Start free, upgrade as you grow.
Free
100 requests/day
- ✓All grant data
- ✓All foundation data
- ✓Semantic search
- ✓Standard rate limits
- ✓Community support
Pro
10,000 requests/day
- ✓Everything in Free
- ✓Higher rate limits
- ✓Foundation financials
- ✓Key people data
- ✓Priority support
Enterprise
Unlimited
- ✓Everything in Pro
- ✓Unlimited requests
- ✓Bulk data exports
- ✓Custom datasets
- ✓Dedicated support & SLA
Data Coverage
What data is available through the API.
Grant Opportunities
76K+
Private Foundations
133K
Foundation Grants
Millions
Key People
79K+
Data Fields
Grants
- Name, funder, summary, eligibility
- Amount range (min/max)
- Deadline, status (active/closed)
- State, agency, program, CFDA number
- Tags, source URL
Foundations
- Name, EIN, NTEE code, state, city
- Mission, programs, website
- Asset amount, total giving
- Financial history (10 years)
- Key people with compensation
- Application info (deadline, restrictions)
- Individual grants given (recipient, amount, purpose)
Academic Access
Free Pro tier access for researchers at accredited institutions.
Researchers and students at accredited educational institutions can apply for free Pro-tier API access. Email us with your institutional email address and a brief description of your research.
Apply for Academic Access