Skip to main content
Welcome to the Allegory Funders API documentation. This API provides fast, edge-cached access to nonprofit funder information and their grant-making history from IRS 990 filings.

​
Base URL

All API requests should be made to: 
https://allegory-middleware.workers.dev

​
Rate Limits

The API has a rate limit of 100 requests per minute per IP address.

​
Data Freshness

Data is synced daily from our analytics warehouse at 4am UTC.

​
Authentication

API key authentication is optional for public endpoints but required for write operations and higher rate limits.
To use API key authentication, include your API key in the request header: 
X-API-Key: your_api_key_here
Contact Allegory API Support to obtain an API key.

​
Response Format

All API responses follow a consistent format:
​
success
boolean
Indicates whether the request was successful
​
data
object | array
The response data. Structure varies by endpoint.
​
error
string
Error message (only present when success is false)

​
Getting Started

1

Explore the API endpoints

Browse the endpoints in the sidebar to see available operations for searching funders and accessing grant history.
2

Try the API playground

Use the interactive API playground on each endpoint page to test requests directly from your browser.
3

Review the data models

Check the response schemas to understand the structure of returned data.

​
Support

For questions or support, contact Allegory API Support.