Back to Home
Grant Search/Developers
REST API · v1

Grant Search API

Read-only REST API for accessing grant opportunities and application data. Integrate grant search into your dashboards, CRM, or reporting tools.

REST API

v1.0

Auth

Bearer Token

Rate Limit

100 req/min

Base URL

api.grantsearch.us

Quick Start

Make your first API call in under a minute. You'll need an API key from theEnterprise API dashboard.

1

Generate an API key

Go to the API dashboard and create a key with the grants:read scope.

2

Make your first request

bash
curl -X GET "https://api.grantsearch.us/api/v1/grants?limit=5" \
  -H "Authorization: Bearer sk_live_YOUR_KEY_HERE"

Authentication

All API requests must include a Bearer token in the Authorization header. API keys start with sk_live_ (production) and are scoped to specific permissions.

bash
# Every request must include this header:
Authorization: Bearer sk_live_abc123...

Available permission scopes:

grants:read
applications:read
reports:read
fundations:read

Scopes are assigned when you create an API key. Contact support to add scopes to an existing key.

Rate Limiting

Requests are rate-limited per API key. The default limit is 100 requests/minute. Enterprise plans support up to 1,000+ requests/minute. Every response includes rate limit headers.

HeaderDescription
X-RateLimit-LimitMaximum requests per minute for this key
X-RateLimit-RemainingRequests remaining in the current window
X-RateLimit-ResetISO 8601 timestamp when the window resets

When rate-limited, the API returns 429 Too Many Requests. Wait for the reset time before retrying.

Endpoints

The full spec is downloadable as a JSON file compatible with Swagger UI, ReDoc, Postman, and any OpenAPI 3.0-compatible tool.

Error Codes

200
Success — request completed normally.
401
Unauthorized — missing, invalid, or expired API key.
403
Forbidden — API key lacks the required permission scope.
404
Not Found — the requested resource does not exist.
405
Method Not Allowed — only GET requests are supported.
429
Too Many Requests — rate limit exceeded. Retry after the reset time.
500
Server Error — an unexpected error occurred. Contact support if persistent.

Ready to integrate?

API access is included with the Enterprise plan. Generate your API key and start building in minutes.