API reference
Every endpoint, for whoever sets up the connection. New to the API? Start with the guide.
Basics
Base URL
https://api.grantlas.com/v1
The machine-readable description is at openapi.json (OpenAPI 3.1).
Authentication
Send your key in a header on every request: Authorization: Bearer gl_live_… (the word Bearer can be any case). Make keys in Settings → Integrations. Never put a key in a URL: any query value that starts with gl_live_ is refused with key_in_url, even a valid key, and you should revoke that key. Requests with a browser cookie are refused too.
Conventions
- JSON, with snake_case field names.
- One item:
{ data }. A list:{ data, page, per_page, total, total_pages }. - Dates are
YYYY-MM-DD. Times are ISO 8601 in UTC, like2026-09-29T15:30:00.000Z. - Every record has
url, its page in Grantlas. - Tracker items and saved items carry
tags(names, A to Z). Tracker items also carryfields: each of your own fields by name,nullwhen empty. The Tracker and saved lists take?tag=Capital campaignto keep only items with that tag. - Organizations, Tracker items, tasks, notes and saved searches have ids like
org_3f9a1c0e7b2d4a61,trk_8c2e5b17d94f0a3c,tsk_4b7d2e9a1c0f6e35,ntn_7c1e5a9b3d2f8046andsrch_51d7a0c9e3b86f24. Use them exactly as given. An id never changes. If you untrack something and track it again, it gets a new id. Funders and grants have number ids, the same as in their Grantlas links. - Errors:
{ error, message }, whereerroris one of the codes below andmessageis a plain sentence. - Query parameters you don't recognize from these pages are ignored, as in the app.
Pages
Lists take page (from 1) and per_page: up to 100 for your own data (Tracker, saved, new matches) and up to 25 for searches. Searches stop at 200 results, so page × per_page can't go past 200. In a search, total counts up to 200 and total_matching is the real number of matches.
Search order
sort=fit(the default): best Fit first across all results, so the first 200 are the organization's best 200.sort=relevance: best keyword match first, the app's order.sort=deadline(grants only): upcoming deadlines, soonest first. Grants with no deadline or a past deadline are left out.
Every search response has sort_applied: fit, fit_within_page, relevance or deadline. fit_within_page means the organization's first full analysis of grants isn't finished: each page is sorted by Fit, but the list as a whole is in relevance order, and sort_note says so. Fit order can shift slightly between pages as new grants are analyzed, so de-duplicate by id.
Fit
Funders and grants carry a fit object for the organization. Its status is one of:
scored- Has
score(0 to 100),label(Great, Good, Okay, Weak or Very weak) and a one-sentencereason. still_scoring- Grants only: being analyzed now. Ask again in a minute.
not_scored- No Fit yet.
unavailable- Grants only: the account is out of Grantlas AI credits, or analysis is paused for the day.
A funder's Fit is worked out from its giving record, so it is always current and costs nothing. fit.stale is true when a grant's Fit is from before the organization's last profile change. Looking up or searching grants analyzes what's returned, using your account's Grantlas AI credits, which can take a few seconds (up to about 15). Lists of your own data (Tracker, saved, new matches) show analysis already done and never start a new one.
Limits and headers
Each key can make 60 requests a minute; each account 10,000 in 24 hours, counted from the first request in that window. Responses carry X-RateLimit-Limit and X-RateLimit-Remaining (for this key, this minute). A 429 carries Retry-After, in seconds.
Errors
missing_key401- No key was sent, or not in the right form. Send Authorization: Bearer gl_live_…
invalid_key401- The key isn't valid: revoked, mistyped, or its maker left the team. Make a new one in Settings → Integrations.
key_in_url400- A key was in the URL. Revoke that key, since it may be in someone's logs, and send the new one in the header.
plan_required403- The account isn't on a paid Grantlas Pro or Agency plan. The keys work again once it is.
read_only_key403- This key can only read. Make a key with “Read & Write” access.
forbidden403- The key’s person can’t change this note: only the person who wrote it can (the account owner can also tidy the Earlier note and delete a former member’s).
org_not_found404- No organization with that id in this account. List yours with GET /v1/orgs.
not_found404- No such record, Tracker item, task, note, saved search or endpoint. Check the id or the path.
already_added409- A past grant that repeats one already on the Tracker (same funder, year, result and amount). existing_id names it. Send allow_duplicate: true if it’s a separate award.
method_not_allowed405- This endpoint doesn't accept that method, for example POST to /v1/me. Check the method in the reference.
bad_request400- A parameter or the JSON body isn't right. The message says which.
invalid_field400- A Tracker, task or note field's value isn't allowed. Nothing was saved. The message names the field.
too_deep400- Search results stop at 200. Narrow the search with more filters.
funder_search_not_supported400- New matches work for grant searches only.
rate_limited429- Too many requests from this key this minute, or this account in 24 hours. Wait the seconds in Retry-After.
limit_reached429- The organization has added 100 grants today (past grants and grants from a link together). Try again tomorrow.
record_limit429- The account has looked up 1,000 funders and grants it hasn't saved or tracked in 24 hours. Saved and tracked ones still work.
cookies_not_accepted400- The request carried a browser cookie. The API takes an API key only; call it from a server or tool, not a web page.
server_error500- Something went wrong on our side. Try again in a minute.
Account
Who am IGET /v1/me
The account (its plan is pro, agency or trial) and key you're using, and the limits that apply.
curl "https://api.grantlas.com/v1/me" \
-H "Authorization: Bearer $GRANTLAS_API_KEY"{
"data": {
"account": {
"plan": "pro"
},
"key": {
"name": "Airtable sync",
"prefix": "gl_live_ab12",
"scope": "read",
"created_at": "2026-09-01T16:00:00.000Z"
},
"limits": {
"requests_per_minute_per_key": 60,
"requests_per_day_per_account": 10000,
"search_per_page_max": 25,
"search_depth_max": 200,
"list_per_page_max": 100,
"record_lookups_per_day": 1000
}
}
}List organizationsGET /v1/orgs
Your organizations (a consultant's clients). The /v1/orgs/{org}/… endpoints need one of these ids.
curl "https://api.grantlas.com/v1/orgs" \
-H "Authorization: Bearer $GRANTLAS_API_KEY"{
"data": [
{
"id": "org_3f9a1c0e7b2d4a61",
"name": "Front Range Food Partners",
"ein": "84-2345678",
"city": "Denver",
"state": "CO",
"fiscal_year_start_month": 7
}
]
}Sorted by name. Ids look like org_3f9a1c0e7b2d4a61 and never change. fiscal_year_start_month is the month the organization's fiscal year starts, 1 (January) to 12 (December), or null when not set (Grantlas reports then count calendar years). It is set in Grantlas, in the organization's settings; the API reads it only.
Tracker
List the TrackerGET /v1/orgs/{org}/tracker
The organization's Tracker, soonest deadline first. To keep another tool in sync, pass the time of your last sync as updated_since.
Parameters
orgpath · string · required- An organization id from GET /v1/orgs, like org_3f9a1c0e7b2d4a61.
stagequery · string- open (every in-progress and submitted stage), closed (won and not won stages), all, or one stage by its key: this account's stage keys, from GET /v1/stages (to start with: researching, loi, applying, submitted, awarded, declined). Anything else is a 400 that lists them. Left out while updated_since is set, it means all.
Default: open
archivedquery · string- false: leave archived items out; true: only archived items; all: both. Left out, it is false, unless updated_since is set: then archived items are included (archived: true), so a sync sees an item leave the Tracker.
One of: false, true, all
updated_sincequery · string- Only items changed at or after this date (2026-09-01) or time (2026-09-01T12:00:00Z, fractional seconds allowed), including changes made in the Grantlas app. Without archived=, this also returns archived items, flagged archived: true.
tagquery · string- Only items with this tag, by name (?tag=Capital campaign), matched ignoring capitals and extra spaces. A name that isn't one of your tags returns an empty list (200), not an error. A tag change moves updated_at, so updated_since sees it.
pagequery · integer- Page number, from 1.
Default: 1 · 1 or more
per_pagequery · integer- Items per page, 1 to 100.
Default: 25 · 1 to 100
curl "https://api.grantlas.com/v1/orgs/org_3f9a1c0e7b2d4a61/tracker" \
-H "Authorization: Bearer $GRANTLAS_API_KEY"{
"data": [
{
"id": "trk_8c2e5b17d94f0a3c",
"type": "funder",
"target_id": 90211,
"name": "Rocky Mountain Family Trust",
"stage": "loi",
"stage_label": "LOI",
"stage_kind": "in_progress",
"outcome": null,
"amount_awarded": null,
"submitted_on": null,
"decided_on": null,
"decided_precision": null,
"archived": false,
"archived_at": null,
"deadline": "2027-03-01",
"amount_requested": 25000,
"notes": "Program officer asked for a two-page LOI by email.",
"owner": {
"name": "Pat Owner",
"email": "pat@frontrangefood.org"
},
"tags": [
"Capital campaign",
"Youth"
],
"fields": {
"Program": "Youth",
"Board meeting": "2026-11-18",
"Pledge goal": 50000,
"Program officer": null
},
"fit_score": 88,
"fit_stale": false,
"updated_at": "2026-09-29T15:30:00.000Z",
"url": "https://grantlas.com/funder/90211"
}
],
"page": 1,
"per_page": 25,
"total": 1,
"total_pages": 1
}Items with no deadline come last. With updated_since and no stage you get every stage, so moves to awarded or declined show up too. Archived items are left out unless archived=true or archived=all (or updated_since is set). stage is the stage's key, which never changes, even when the stage is renamed; stage_label is its name as the app shows it, and stage_kind its type: in_progress, submitted, won or not_won (GET /v1/stages lists them). outcome is won or lost once the item is in a won or not won stage, else null; it follows the stage and can't be sent. amount_awarded is whole dollars, set on a won item; it is kept if the item moves out of a won stage. submitted_on is the YYYY-MM-DD day it was submitted, or null when that isn't recorded: the first move into a submitted stage sets it to that day if it has none, a later move never changes it, and you can set, change or clear it with PATCH submitted_on. decided_on is the YYYY-MM-DD day it was won or not won, or null while it's open. decided_precision says how much of it is known: day, or month or year for a past grant recorded that way (decided_on is then the last day of that month or year, capped at today); null with no decided_on. type is past_grant for a grant the organization won or lost before Grantlas, added by hand, by Claude or ChatGPT, or with POST type past_grant: it has funder ({ id, name }: the linked Grantlas funder, or id null and the name as typed), target_id is its own grant record, fit_score is null, and url opens it in the Tracker. archived is true for an item taken out of the Tracker's lists, counts and reminders (it keeps its history); archived_at is when. deadline is YYYY-MM-DD. amount_requested is whole dollars. fit_score is the organization's fit (0 to 100) once it has been analyzed, else null. fit_stale is true when the organization's profile changed since. owner is the teammate who owns the item ({ name, email }); change it with PATCH owner (an email). tags is the item's tags by name, A to Z (an empty list when it has none). fields is the account's own fields: every one of them is there by name, in the order set up in Tracker setup, with its value, or null when empty (a Choice is its label, Money a number of dollars, Date YYYY-MM-DD, Text a string). Tags and fields are set in the Grantlas app or with Claude; the API reads them. notes is every note on the item, newest first, joined by a blank line, or null when there are none. It is a summary of the item's notes: read, edit and delete single notes with the notes endpoints. updated_at changes whenever the item changes (its notes and tasks included), in the app or through the API.
Every organization's TrackerGET /v1/tracker
Tracker items from all your organizations in one list, soonest deadline first. Each item names its organization. To keep another tool in sync, pass the time of your last sync as updated_since.
Parameters
stagequery · string- open (every in-progress and submitted stage), closed (won and not won stages), all, or one stage by its key: this account's stage keys, from GET /v1/stages (to start with: researching, loi, applying, submitted, awarded, declined). Anything else is a 400 that lists them. Left out while updated_since is set, it means all.
Default: open
archivedquery · string- false: leave archived items out; true: only archived items; all: both. Left out, it is false, unless updated_since is set: then archived items are included (archived: true), so a sync sees an item leave the Tracker.
One of: false, true, all
updated_sincequery · string- Only items changed at or after this date (2026-09-01) or time (2026-09-01T12:00:00Z, fractional seconds allowed), including changes made in the Grantlas app. Without archived=, this also returns archived items, flagged archived: true.
tagquery · string- Only items with this tag, by name (?tag=Capital campaign), matched ignoring capitals and extra spaces. A name that isn't one of your tags returns an empty list (200), not an error. A tag change moves updated_at, so updated_since sees it.
pagequery · integer- Page number, from 1.
Default: 1 · 1 or more
per_pagequery · integer- Items per page, 1 to 100.
Default: 25 · 1 to 100
curl "https://api.grantlas.com/v1/tracker" \
-H "Authorization: Bearer $GRANTLAS_API_KEY"{
"data": [
{
"org": {
"id": "org_3f9a1c0e7b2d4a61",
"name": "Riverbend Literacy"
},
"id": "trk_8c2e5b17d94f0a3c",
"type": "funder",
"target_id": 90211,
"name": "Rocky Mountain Family Trust",
"stage": "loi",
"stage_label": "LOI",
"stage_kind": "in_progress",
"outcome": null,
"amount_awarded": null,
"submitted_on": null,
"decided_on": null,
"decided_precision": null,
"archived": false,
"archived_at": null,
"deadline": "2027-03-01",
"amount_requested": 25000,
"notes": "Program officer asked for a two-page LOI by email.",
"owner": {
"name": "Pat Owner",
"email": "pat@frontrangefood.org"
},
"tags": [
"Capital campaign",
"Youth"
],
"fields": {
"Program": "Youth",
"Board meeting": "2026-11-18",
"Pledge goal": 50000,
"Program officer": null
},
"fit_score": 88,
"fit_stale": false,
"updated_at": "2026-09-29T15:30:00.000Z",
"url": "https://grantlas.com/funder/90211"
}
],
"page": 1,
"per_page": 25,
"total": 1,
"total_pages": 1
}The same item fields as GET /v1/orgs/{org}/tracker, plus org. With updated_since and no stage you get every stage, so moves to awarded or declined show up too. Ties on a deadline are ordered by organization name, and items with no deadline come last. Archived items are left out unless archived=true or archived=all (or updated_since is set). To change an item, use its organization's /v1/orgs/{org}/tracker/{item}. 404 (not_found) when the account has only one organization. stage is the stage's key, which never changes, even when the stage is renamed; stage_label is its name as the app shows it, and stage_kind its type: in_progress, submitted, won or not_won (GET /v1/stages lists them). outcome is won or lost once the item is in a won or not won stage, else null; it follows the stage and can't be sent. amount_awarded is whole dollars, set on a won item; it is kept if the item moves out of a won stage. submitted_on is the YYYY-MM-DD day it was submitted, or null when that isn't recorded: the first move into a submitted stage sets it to that day if it has none, a later move never changes it, and you can set, change or clear it with PATCH submitted_on. decided_on is the YYYY-MM-DD day it was won or not won, or null while it's open. decided_precision says how much of it is known: day, or month or year for a past grant recorded that way (decided_on is then the last day of that month or year, capped at today); null with no decided_on. type is past_grant for a grant the organization won or lost before Grantlas, added by hand, by Claude or ChatGPT, or with POST type past_grant: it has funder ({ id, name }: the linked Grantlas funder, or id null and the name as typed), target_id is its own grant record, fit_score is null, and url opens it in the Tracker. archived is true for an item taken out of the Tracker's lists, counts and reminders (it keeps its history); archived_at is when. deadline is YYYY-MM-DD. amount_requested is whole dollars. fit_score is the organization's fit (0 to 100) once it has been analyzed, else null. fit_stale is true when the organization's profile changed since. owner is the teammate who owns the item ({ name, email }); change it with PATCH owner (an email). tags is the item's tags by name, A to Z (an empty list when it has none). fields is the account's own fields: every one of them is there by name, in the order set up in Tracker setup, with its value, or null when empty (a Choice is its label, Money a number of dollars, Date YYYY-MM-DD, Text a string). Tags and fields are set in the Grantlas app or with Claude; the API reads them. notes is every note on the item, newest first, joined by a blank line, or null when there are none. It is a summary of the item's notes: read, edit and delete single notes with the notes endpoints. updated_at changes whenever the item changes (its notes and tasks included), in the app or through the API.
Track a funder or grantPOST /v1/orgs/{org}/tracker
Adds a funder or grant to the Tracker at the account's first in-progress stage (Researching to start with) and returns the new item. Or records a past grant.
Parameters
orgpath · string · required- An organization id from GET /v1/orgs, like org_3f9a1c0e7b2d4a61.
typeJSON body · string · required- funder or grant, or past_grant to record a grant already won or lost.
One of: funder, grant, past_grant
idJSON body · integer- The funder's or grant's Grantlas id. Required for funder or grant; not sent for past_grant.
1 or more
notesJSON body · string | null- Optional: a first note, up to 2,000 characters. If it's already tracked, the note is added unless it repeats the item's newest note or its whole notes text, so a sync can send it every time. null or an empty string adds nothing; any other non-text value is 400 "notes: send text or null."
funderJSON body · string- past_grant only: the funder's name as you know it, up to 200 characters. Required unless funder_id is sent.
funder_idJSON body · integer- past_grant only, optional: the Grantlas funder id to link it to. Left out, the grant is not linked, even when the name matches a funder.
1 or more
resultJSON body · string- past_grant only, required: won or lost (not won).
One of: won, lost
amount_awardedJSON body · integer | null- past_grant only, optional: whole dollars awarded. A won grant only.
0 or more
amount_requestedJSON body · integer | null- past_grant only, optional: whole dollars asked for.
0 or more
decided_onJSON body · string- past_grant only, required: when it was decided, as YYYY, YYYY-MM or YYYY-MM-DD, from 50 years back to today. Send only what you know: a year is a year.
titleJSON body · string | null- past_grant only, optional: the grant's name, up to 300 characters. Left out, it is "[Funder] grant".
stageJSON body · string- past_grant only, optional: a won or not won stage, matching result, by key (this account's stage keys, from GET /v1/stages (to start with: researching, loi, applying, submitted, awarded, declined)). Left out, the first one of that type.
allow_duplicateJSON body · boolean- past_grant only, optional: true adds it even when it repeats a past grant already there (409 otherwise).
curl -X POST "https://api.grantlas.com/v1/orgs/org_3f9a1c0e7b2d4a61/tracker" \
-H "Authorization: Bearer $GRANTLAS_API_KEY" \
-H "Content-Type: application/json" \
-d '{"type":"funder","id":90211,"notes":null}'{
"data": {
"id": "trk_8c2e5b17d94f0a3c",
"type": "funder",
"target_id": 90211,
"name": "Rocky Mountain Family Trust",
"stage": "researching",
"stage_label": "Researching",
"stage_kind": "in_progress",
"outcome": null,
"amount_awarded": null,
"submitted_on": null,
"decided_on": null,
"decided_precision": null,
"archived": false,
"archived_at": null,
"deadline": null,
"amount_requested": null,
"notes": null,
"owner": {
"name": "Pat Owner",
"email": "pat@frontrangefood.org"
},
"tags": [],
"fields": {
"Program": null,
"Board meeting": null,
"Pledge goal": null,
"Program officer": null
},
"fit_score": null,
"fit_stale": false,
"updated_at": "2026-09-22T10:15:00.000Z",
"url": "https://grantlas.com/funder/90211"
}
}curl -X POST "https://api.grantlas.com/v1/orgs/org_3f9a1c0e7b2d4a61/tracker" \
-H "Authorization: Bearer $GRANTLAS_API_KEY" \
-H "Content-Type: application/json" \
-d '{"type":"past_grant","funder":"Rocky Mountain Family Trust","funder_id":90211,"result":"won","amount_awarded":20000,"amount_requested":25000,"decided_on":"2025-03","notes":"From the 2025 board report."}'{
"data": {
"id": "trk_5c0e2b7a91d3f468",
"type": "past_grant",
"target_id": 812,
"name": "Rocky Mountain Family Trust grant",
"funder": {
"id": 90211,
"name": "Rocky Mountain Family Trust"
},
"stage": "awarded",
"stage_label": "Awarded",
"stage_kind": "won",
"outcome": "won",
"amount_awarded": 20000,
"submitted_on": null,
"decided_on": "2025-03-31",
"decided_precision": "month",
"archived": false,
"archived_at": null,
"deadline": null,
"amount_requested": 25000,
"notes": "From the 2025 board report.",
"owner": {
"name": "Pat Owner",
"email": "pat@frontrangefood.org"
},
"tags": [],
"fields": {
"Program": null,
"Board meeting": null,
"Pledge goal": null,
"Program officer": null
},
"fit_score": null,
"fit_stale": false,
"updated_at": "2026-10-14T15:30:00.000Z",
"url": "https://grantlas.com/pipeline?item=4127"
}
}If it's already tracked you get 200 with the existing item, and its stage isn't changed. If it's archived, it is restored, in the stage it had, and you get 200. 404 when Grantlas has no funder or grant with that id. type past_grant records a grant the organization already won or lost (its record from before Grantlas) on the Closed tab: one award, one result, one year. It lands in the account's first won or not won stage (or the stage you name, of that type) and counts in the win record; it has no fit. The funder is linked only when you send funder_id. 201 with the new item. An exact repeat (the same funder, year, result and amount awarded as a past grant already in this organization) is 409 (already_added) with existing_id; send allow_duplicate: true if it is a separate award. A field that isn't right is 400 (invalid_field) and nothing is saved. Past grants and grants added from a link count together toward 100 a day per organization: past that, 429 (limit_reached) until tomorrow (Central time). stage is the stage's key, which never changes, even when the stage is renamed; stage_label is its name as the app shows it, and stage_kind its type: in_progress, submitted, won or not_won (GET /v1/stages lists them). outcome is won or lost once the item is in a won or not won stage, else null; it follows the stage and can't be sent. amount_awarded is whole dollars, set on a won item; it is kept if the item moves out of a won stage. submitted_on is the YYYY-MM-DD day it was submitted, or null when that isn't recorded: the first move into a submitted stage sets it to that day if it has none, a later move never changes it, and you can set, change or clear it with PATCH submitted_on. decided_on is the YYYY-MM-DD day it was won or not won, or null while it's open. decided_precision says how much of it is known: day, or month or year for a past grant recorded that way (decided_on is then the last day of that month or year, capped at today); null with no decided_on. type is past_grant for a grant the organization won or lost before Grantlas, added by hand, by Claude or ChatGPT, or with POST type past_grant: it has funder ({ id, name }: the linked Grantlas funder, or id null and the name as typed), target_id is its own grant record, fit_score is null, and url opens it in the Tracker. archived is true for an item taken out of the Tracker's lists, counts and reminders (it keeps its history); archived_at is when. deadline is YYYY-MM-DD. amount_requested is whole dollars. fit_score is the organization's fit (0 to 100) once it has been analyzed, else null. fit_stale is true when the organization's profile changed since. owner is the teammate who owns the item ({ name, email }); change it with PATCH owner (an email). tags is the item's tags by name, A to Z (an empty list when it has none). fields is the account's own fields: every one of them is there by name, in the order set up in Tracker setup, with its value, or null when empty (a Choice is its label, Money a number of dollars, Date YYYY-MM-DD, Text a string). Tags and fields are set in the Grantlas app or with Claude; the API reads them. notes is every note on the item, newest first, joined by a blank line, or null when there are none. It is a summary of the item's notes: read, edit and delete single notes with the notes endpoints. updated_at changes whenever the item changes (its notes and tasks included), in the app or through the API.
Update a Tracker itemPATCH /v1/orgs/{org}/tracker/{item}
Change any of stage, deadline, amount requested, submitted date, amount awarded, decided date, archived and owner, or add a note. If one field is wrong, nothing is saved.
Parameters
orgpath · string · required- An organization id from GET /v1/orgs, like org_3f9a1c0e7b2d4a61.
itempath · string · required- A Tracker item id (the id of each Tracker item), like trk_8c2e5b17d94f0a3c.
stageJSON body · string- One of this account's stage keys, from GET /v1/stages (to start with: researching, loi, applying, submitted, awarded, declined).
deadlineJSON body · string | null- YYYY-MM-DD, or null to clear.
amount_requestedJSON body · integer | null- Whole dollars, or null to clear.
0 or more
submitted_onJSON body · string | null- YYYY-MM-DD, the day it was submitted, or null to clear. Not after today or after decided_on. Any stage; a move never changes it.
notesJSON body · string | null- Adds a note (up to 2,000 characters), written by the key's person. The same text as the item's notes or its newest note adds nothing, so a sync can send it every time. null or an empty string changes nothing (it no longer clears): delete a note with DELETE …/notes/{note}.
ownerJSON body · string- A teammate's email: someone on this account's team (Settings → Team).
amount_awardedJSON body · integer | null- Whole dollars awarded, or null to clear. A won item only.
0 or more
decided_onJSON body · string | null- YYYY-MM-DD, the day it was won or not won, or null to clear. A won or not won item only. A past grant also takes YYYY or YYYY-MM (decided_precision says which).
archivedJSON body · boolean- true takes the item out of the Tracker's lists, counts, reminders and calendar, keeping its history; false brings it back in the stage it had.
curl -X PATCH "https://api.grantlas.com/v1/orgs/org_3f9a1c0e7b2d4a61/tracker/trk_8c2e5b17d94f0a3c" \
-H "Authorization: Bearer $GRANTLAS_API_KEY" \
-H "Content-Type: application/json" \
-d '{"stage":"loi","deadline":"2027-03-01","amount_requested":25000,"submitted_on":null,"notes":"Program officer asked for a two-page LOI by email.","owner":"pat@frontrangefood.org","amount_awarded":null,"decided_on":null,"archived":false}'{
"data": {
"id": "trk_8c2e5b17d94f0a3c",
"type": "funder",
"target_id": 90211,
"name": "Rocky Mountain Family Trust",
"stage": "loi",
"stage_label": "LOI",
"stage_kind": "in_progress",
"outcome": null,
"amount_awarded": null,
"submitted_on": null,
"decided_on": null,
"decided_precision": null,
"archived": false,
"archived_at": null,
"deadline": "2027-03-01",
"amount_requested": 25000,
"notes": "Program officer asked for a two-page LOI by email.",
"owner": {
"name": "Pat Owner",
"email": "pat@frontrangefood.org"
},
"tags": [
"Capital campaign",
"Youth"
],
"fields": {
"Program": "Youth",
"Board meeting": "2026-11-18",
"Pledge goal": 50000,
"Program officer": null
},
"fit_score": 88,
"fit_stale": false,
"updated_at": "2026-09-29T15:30:00.000Z",
"url": "https://grantlas.com/funder/90211"
}
}Send only the fields you want to change. outcome isn't a field: it follows the stage. amount_awarded is for an item in a won stage and decided_on for one in a won or not won stage, after this request's stage change if it has one: otherwise 400 (invalid_field). Moving into a won or not won stage from another type sets decided_on to today; a move between two stages of the same type keeps it. Moving back to an in-progress or submitted stage clears it. submitted_on can't be after today or after decided_on, and decided_on can't be before submitted_on: otherwise 400 (invalid_field). An archived item can still be changed; it stays archived until you send archived: false. stage is the stage's key, which never changes, even when the stage is renamed; stage_label is its name as the app shows it, and stage_kind its type: in_progress, submitted, won or not_won (GET /v1/stages lists them). outcome is won or lost once the item is in a won or not won stage, else null; it follows the stage and can't be sent. amount_awarded is whole dollars, set on a won item; it is kept if the item moves out of a won stage. submitted_on is the YYYY-MM-DD day it was submitted, or null when that isn't recorded: the first move into a submitted stage sets it to that day if it has none, a later move never changes it, and you can set, change or clear it with PATCH submitted_on. decided_on is the YYYY-MM-DD day it was won or not won, or null while it's open. decided_precision says how much of it is known: day, or month or year for a past grant recorded that way (decided_on is then the last day of that month or year, capped at today); null with no decided_on. type is past_grant for a grant the organization won or lost before Grantlas, added by hand, by Claude or ChatGPT, or with POST type past_grant: it has funder ({ id, name }: the linked Grantlas funder, or id null and the name as typed), target_id is its own grant record, fit_score is null, and url opens it in the Tracker. archived is true for an item taken out of the Tracker's lists, counts and reminders (it keeps its history); archived_at is when. deadline is YYYY-MM-DD. amount_requested is whole dollars. fit_score is the organization's fit (0 to 100) once it has been analyzed, else null. fit_stale is true when the organization's profile changed since. owner is the teammate who owns the item ({ name, email }); change it with PATCH owner (an email). tags is the item's tags by name, A to Z (an empty list when it has none). fields is the account's own fields: every one of them is there by name, in the order set up in Tracker setup, with its value, or null when empty (a Choice is its label, Money a number of dollars, Date YYYY-MM-DD, Text a string). Tags and fields are set in the Grantlas app or with Claude; the API reads them. notes is every note on the item, newest first, joined by a blank line, or null when there are none. It is a summary of the item's notes: read, edit and delete single notes with the notes endpoints. updated_at changes whenever the item changes (its notes and tasks included), in the app or through the API.
UntrackDELETE /v1/orgs/{org}/tracker/{item}
Removes the item from the Tracker. Its notes, dates and tasks go with it.
Parameters
orgpath · string · required- An organization id from GET /v1/orgs, like org_3f9a1c0e7b2d4a61.
itempath · string · required- A Tracker item id (the id of each Tracker item), like trk_8c2e5b17d94f0a3c.
curl -X DELETE "https://api.grantlas.com/v1/orgs/org_3f9a1c0e7b2d4a61/tracker/trk_8c2e5b17d94f0a3c" \
-H "Authorization: Bearer $GRANTLAS_API_KEY"Returns 204 No Content, with no body.
A grant your organization added itself (a past grant, or one added by link or by hand) is deleted from Grantlas with its item: it no longer appears in grant searches, the saved list or the Tracker, and GET /v1/orgs/{org}/grants/{id} answers 404. There is no undo here. Grants and funders from our database are only removed from the Tracker.
List an item's notesGET /v1/orgs/{org}/tracker/{item}/notes
The Tracker item's notes, newest first, with the Earlier note last.
Parameters
orgpath · string · required- An organization id from GET /v1/orgs, like org_3f9a1c0e7b2d4a61.
itempath · string · required- A Tracker item id (the id of each Tracker item), like trk_8c2e5b17d94f0a3c.
curl "https://api.grantlas.com/v1/orgs/org_3f9a1c0e7b2d4a61/tracker/trk_8c2e5b17d94f0a3c/notes" \
-H "Authorization: Bearer $GRANTLAS_API_KEY"{
"data": [
{
"id": "ntn_7c1e5a9b3d2f8046",
"tracker_item_id": "trk_8c2e5b17d94f0a3c",
"body": "Called the program officer. She asked for a two-page LOI by email.",
"author": {
"name": "Pat Owner",
"email": "pat@frontrangefood.org"
},
"earlier": false,
"created_at": "2026-10-03T16:05:00.000Z",
"updated_at": "2026-10-03T16:05:00.000Z"
}
]
}This list isn't paged. Notes are a dated log, newest first. Only the person who wrote a note can change or delete it; the account owner can also edit or delete the Earlier note (text from before notes were a log) and delete a former member's note. author is the person who wrote it ({ name, email }), or null for the Earlier note and a former member's. earlier is true for the Earlier note. Anyone else gets 403 (forbidden).
Add a notePOST /v1/orgs/{org}/tracker/{item}/notes
Adds a note to the Tracker item, written by the key's person, and returns it.
Parameters
orgpath · string · required- An organization id from GET /v1/orgs, like org_3f9a1c0e7b2d4a61.
itempath · string · required- A Tracker item id (the id of each Tracker item), like trk_8c2e5b17d94f0a3c.
bodyJSON body · string · required- The note, up to 2,000 characters.
curl -X POST "https://api.grantlas.com/v1/orgs/org_3f9a1c0e7b2d4a61/tracker/trk_8c2e5b17d94f0a3c/notes" \
-H "Authorization: Bearer $GRANTLAS_API_KEY" \
-H "Content-Type: application/json" \
-d '{"body":"Called the program officer. She asked for a two-page LOI by email."}'{
"data": {
"id": "ntn_7c1e5a9b3d2f8046",
"tracker_item_id": "trk_8c2e5b17d94f0a3c",
"body": "Called the program officer. She asked for a two-page LOI by email.",
"author": {
"name": "Pat Owner",
"email": "pat@frontrangefood.org"
},
"earlier": false,
"created_at": "2026-10-03T16:05:00.000Z",
"updated_at": "2026-10-03T16:05:00.000Z"
}
}Notes are a dated log, newest first. Only the person who wrote a note can change or delete it; the account owner can also edit or delete the Earlier note (text from before notes were a log) and delete a former member's note. author is the person who wrote it ({ name, email }), or null for the Earlier note and a former member's. earlier is true for the Earlier note. Anyone else gets 403 (forbidden).
Update a notePATCH /v1/orgs/{org}/tracker/{item}/notes/{note}
Changes a note's text. It keeps its place and its date.
Parameters
orgpath · string · required- An organization id from GET /v1/orgs, like org_3f9a1c0e7b2d4a61.
itempath · string · required- A Tracker item id (the id of each Tracker item), like trk_8c2e5b17d94f0a3c.
notepath · string · required- A note id from the item's notes list, like ntn_7c1e5a9b3d2f8046.
bodyJSON body · string · required- The new text, up to 2,000 characters.
curl -X PATCH "https://api.grantlas.com/v1/orgs/org_3f9a1c0e7b2d4a61/tracker/trk_8c2e5b17d94f0a3c/notes/ntn_7c1e5a9b3d2f8046" \
-H "Authorization: Bearer $GRANTLAS_API_KEY" \
-H "Content-Type: application/json" \
-d '{"body":"Called the program officer. She asked for a two-page LOI by email by Nov 1."}'{
"data": {
"id": "ntn_7c1e5a9b3d2f8046",
"tracker_item_id": "trk_8c2e5b17d94f0a3c",
"body": "Called the program officer. She asked for a two-page LOI by email by Nov 1.",
"author": {
"name": "Pat Owner",
"email": "pat@frontrangefood.org"
},
"earlier": false,
"created_at": "2026-10-03T16:05:00.000Z",
"updated_at": "2026-10-04T09:12:00.000Z"
}
}Notes are a dated log, newest first. Only the person who wrote a note can change or delete it; the account owner can also edit or delete the Earlier note (text from before notes were a log) and delete a former member's note. author is the person who wrote it ({ name, email }), or null for the Earlier note and a former member's. earlier is true for the Earlier note. Anyone else gets 403 (forbidden).
Delete a noteDELETE /v1/orgs/{org}/tracker/{item}/notes/{note}
Removes the note from the Tracker item. There is no undo.
Parameters
orgpath · string · required- An organization id from GET /v1/orgs, like org_3f9a1c0e7b2d4a61.
itempath · string · required- A Tracker item id (the id of each Tracker item), like trk_8c2e5b17d94f0a3c.
notepath · string · required- A note id from the item's notes list, like ntn_7c1e5a9b3d2f8046.
curl -X DELETE "https://api.grantlas.com/v1/orgs/org_3f9a1c0e7b2d4a61/tracker/trk_8c2e5b17d94f0a3c/notes/ntn_7c1e5a9b3d2f8046" \
-H "Authorization: Bearer $GRANTLAS_API_KEY"Returns 204 No Content, with no body.
Notes are a dated log, newest first. Only the person who wrote a note can change or delete it; the account owner can also edit or delete the Earlier note (text from before notes were a log) and delete a former member's note. author is the person who wrote it ({ name, email }), or null for the Earlier note and a former member's. earlier is true for the Earlier note. Anyone else gets 403 (forbidden).
Read an item's applicationGET /v1/orgs/{org}/tracker/{item}/application
The Tracker item's application questions in order, each with its limit, guidance, status and answer as Markdown, and how many are done.
Parameters
orgpath · string · required- An organization id from GET /v1/orgs, like org_3f9a1c0e7b2d4a61.
itempath · string · required- A Tracker item id (the id of each Tracker item), like trk_8c2e5b17d94f0a3c.
curl "https://api.grantlas.com/v1/orgs/org_3f9a1c0e7b2d4a61/tracker/trk_8c2e5b17d94f0a3c/application" \
-H "Authorization: Bearer $GRANTLAS_API_KEY"{
"data": {
"tracker_item_id": "trk_8c2e5b17d94f0a3c",
"name": "Mile High Community Foundation",
"archived": false,
"done": 0,
"total": 1,
"progress": "0 of 1 done",
"questions": [
{
"id": "q_6d2a9f1c4e8b0375",
"tracker_item_id": "trk_8c2e5b17d94f0a3c",
"number": 1,
"text": "Describe the need your program addresses and the people it serves.",
"limit": {
"value": 500,
"unit": "words"
},
"guidance": "Use the 2025 county food insecurity numbers.",
"status": "in_progress",
"answer": "One in six children in **Adams County** lives in a household without enough food.\n\n- 3,200 families served in 2025\n- 41% of them seniors",
"count": 23,
"count_unit": "words",
"version": 3,
"updated_at": "2026-10-04T09:12:00.000Z",
"updated_via": "claude"
}
],
"attachments": [
{
"id": "att_5c1d9e7a3b2f8064",
"text": "IRS determination letter",
"ready": true,
"file": {
"id": "fil_8a2c4e6f0b1d3957",
"name": "IRS letter.pdf"
}
}
]
}
}An application holds up to 100 questions, so this list isn't paged. An item with no questions returns an empty questions list. status is not_started (no answer), in_progress or done. answer is the answer as Markdown (paragraphs, **bold**, *italic*, <u>underline</u>, links, - and 1. lists), or an empty string. count is the answer's words, or its characters when the limit is in characters (count_unit says which). version goes up with every change to the answer: send it back when you replace an answer that has text. updated_via is app, claude, chatgpt or api. Questions are added here or in the app; they are edited, reordered and deleted only in the app. An archived item's application can't change (409 archived). attachments is the funder's required attachments checklist, in order: text, ready (true once marked ready in the app) and file, the grant's file it's linked to ({ id, name }) or null. Attachments are added here or in the app; they are linked, marked ready, edited and removed only in the app.
Add application questionsPOST /v1/orgs/{org}/tracker/{item}/application/questions
Adds questions after the ones already there and returns the ones added. A question exactly like one already there is skipped.
Parameters
orgpath · string · required- An organization id from GET /v1/orgs, like org_3f9a1c0e7b2d4a61.
itempath · string · required- A Tracker item id (the id of each Tracker item), like trk_8c2e5b17d94f0a3c.
questionsJSON body · array- Questions in order, each { text, limit_value, limit_unit, guidance }: text up to 2,000 characters; limit_value a whole number with limit_unit words or characters; guidance optional.
pastedJSON body · string- The funder's questions as one block of text, instead of (or as well as) questions.
attachmentsJSON body · array- Required attachments to add to the checklist, up to 50 texts of 1–500 characters, like "Board list".
curl -X POST "https://api.grantlas.com/v1/orgs/org_3f9a1c0e7b2d4a61/tracker/trk_8c2e5b17d94f0a3c/application/questions" \
-H "Authorization: Bearer $GRANTLAS_API_KEY" \
-H "Content-Type: application/json" \
-d '{"pasted":"1. Describe the need your program addresses and the people it serves. (500 words)"}'{
"data": {
"added": [
{
"id": "q_6d2a9f1c4e8b0375",
"tracker_item_id": "trk_8c2e5b17d94f0a3c",
"number": 1,
"text": "Describe the need your program addresses and the people it serves.",
"limit": {
"value": 500,
"unit": "words"
},
"guidance": null,
"status": "not_started",
"answer": "",
"count": 0,
"count_unit": "words",
"version": 0,
"updated_at": "2026-10-04T09:12:00.000Z",
"updated_via": "api"
}
],
"skipped": 0,
"total": 1
}
}Send questions, a list, or pasted, the funder's questions as one block of text: it is split into questions the way the app's paste box splits it (numbered lines, bullets or blank lines), and limits such as "(500 words)" are read. If one question is wrong, nothing is added. skipped counts the questions left out as duplicates; total is how many the application now has. attachments adds the funder's required attachments to the checklist (one already there is skipped), with or without questions; the reply then has attachments_added and the whole checklist as attachments. status is not_started (no answer), in_progress or done. answer is the answer as Markdown (paragraphs, **bold**, *italic*, <u>underline</u>, links, - and 1. lists), or an empty string. count is the answer's words, or its characters when the limit is in characters (count_unit says which). version goes up with every change to the answer: send it back when you replace an answer that has text. updated_via is app, claude, chatgpt or api. Questions are added here or in the app; they are edited, reordered and deleted only in the app. An archived item's application can't change (409 archived).
Write an answerPUT /v1/orgs/{org}/tracker/{item}/application/questions/{question}/answer
Replaces a question's answer with Markdown and returns the question. The answer is in_progress unless done is true.
Parameters
orgpath · string · required- An organization id from GET /v1/orgs, like org_3f9a1c0e7b2d4a61.
itempath · string · required- A Tracker item id (the id of each Tracker item), like trk_8c2e5b17d94f0a3c.
questionpath · string · required- A question id from the item's application, like q_6d2a9f1c4e8b0375.
markdownJSON body · string · required- The whole answer as Markdown, up to 100,000 characters of text.
doneJSON body · boolean- true marks the answer done. Default false (in progress).
base_versionJSON body · integer- The answer's version when you read it. Needed when the answer already has text; or send it in If-Match.
0 or more
curl -X PUT "https://api.grantlas.com/v1/orgs/org_3f9a1c0e7b2d4a61/tracker/trk_8c2e5b17d94f0a3c/application/questions/q_6d2a9f1c4e8b0375/answer" \
-H "Authorization: Bearer $GRANTLAS_API_KEY" \
-H "Content-Type: application/json" \
-d '{"markdown":"One in six children in **Adams County** lives in a household without enough food.\n\n- 3,200 families served in 2025\n- 41% of them seniors","base_version":3}'{
"data": {
"id": "q_6d2a9f1c4e8b0375",
"tracker_item_id": "trk_8c2e5b17d94f0a3c",
"number": 1,
"text": "Describe the need your program addresses and the people it serves.",
"limit": {
"value": 500,
"unit": "words"
},
"guidance": "Use the 2025 county food insecurity numbers.",
"status": "in_progress",
"answer": "One in six children in **Adams County** lives in a household without enough food.\n\n- 3,200 families served in 2025\n- 41% of them seniors",
"count": 23,
"count_unit": "words",
"version": 4,
"updated_at": "2026-10-04T09:12:00.000Z",
"updated_via": "api"
}
}An answer that already has text is replaced only when you send the version you read, as base_version or in an If-Match header ("3"). If the answer has changed since, or you sent no version, nothing is saved and you get 409 conflict with current: { version, answer, status }, so you can merge and send again with that version. An empty markdown clears the answer. The response's ETag is the new version. status is not_started (no answer), in_progress or done. answer is the answer as Markdown (paragraphs, **bold**, *italic*, <u>underline</u>, links, - and 1. lists), or an empty string. count is the answer's words, or its characters when the limit is in characters (count_unit says which). version goes up with every change to the answer: send it back when you replace an answer that has text. updated_via is app, claude, chatgpt or api. Questions are added here or in the app; they are edited, reordered and deleted only in the app. An archived item's application can't change (409 archived).
Write a letterPUT /v1/orgs/{org}/tracker/{item}/application/letters/{kind}
Replaces the Tracker item's letter of inquiry (loi) or cover letter (cover) with Markdown, creating it if there isn't one, and returns it.
Parameters
orgpath · string · required- An organization id from GET /v1/orgs, like org_3f9a1c0e7b2d4a61.
itempath · string · required- A Tracker item id (the id of each Tracker item), like trk_8c2e5b17d94f0a3c.
kindpath · string · required- loi (letter of inquiry) or cover (cover letter).
markdownJSON body · string · required- The whole letter as Markdown.
doneJSON body · boolean- true marks the letter done. Default false (in progress).
base_versionJSON body · integer- The letter's version when you read it. Needed when it already has text; or send it in If-Match.
0 or more
curl -X PUT "https://api.grantlas.com/v1/orgs/org_3f9a1c0e7b2d4a61/tracker/trk_8c2e5b17d94f0a3c/application/letters/1" \
-H "Authorization: Bearer $GRANTLAS_API_KEY" \
-H "Content-Type: application/json" \
-d '{"markdown":"Dear Ms. Rivera,\n\nPueblo Reads would like to submit a proposal…","base_version":2}'{
"data": {
"id": "d_7c1e5a9b3d2f8046",
"kind": "loi",
"title": "Letter of inquiry",
"text": "Dear Ms. Rivera,\n\nPueblo Reads would like to submit a proposal…",
"words": 286,
"done": false,
"version": 3,
"updated_at": "2026-11-04T18:00:00.000Z",
"updated_via": "api"
}
}A grant has at most one of each. A letter that already has text is replaced only when you send the version you read, as base_version or in an If-Match header; otherwise nothing is saved and you get 409 conflict with current: { version, text, done }. The letters also come back on GET .../application as letters. The response's ETag is the new version.
An item's historyGET /v1/orgs/{org}/tracker/{item}/events
What happened to the Tracker item, newest first: when it was added, each stage move, the amount awarded, the submitted date, owner changes, tasks done, archived and restored.
Parameters
orgpath · string · required- An organization id from GET /v1/orgs, like org_3f9a1c0e7b2d4a61.
itempath · string · required- A Tracker item id (the id of each Tracker item), like trk_8c2e5b17d94f0a3c.
pagequery · integer- Page number, from 1.
Default: 1 · 1 or more
per_pagequery · integer- Items per page, 1 to 100.
Default: 25 · 1 to 100
curl "https://api.grantlas.com/v1/orgs/org_3f9a1c0e7b2d4a61/tracker/trk_8c2e5b17d94f0a3c/events" \
-H "Authorization: Bearer $GRANTLAS_API_KEY"{
"data": [
{
"id": "evt_2a6f9c1d0b8e7354",
"tracker_item_id": "trk_8c2e5b17d94f0a3c",
"type": "stage",
"text": "Moved to LOI from Researching",
"stage": "loi",
"stage_label": "LOI",
"from_stage": "researching",
"from_stage_label": "Researching",
"amount_awarded": null,
"actor": {
"name": "Pat Owner",
"email": "pat@frontrangefood.org"
},
"via": "api",
"recorded": true,
"created_at": "2026-10-08T14:20:00.000Z"
}
],
"page": 1,
"per_page": 25,
"total": 1,
"total_pages": 1
}The same history as the item's History tab in the app. type is added, stage, outcome (the amount awarded changed), owner, task_done, tag, field, funder, submitted, archived or restored. tag is tags added or removed (text names them), field is a custom field set, changed or cleared (text says which and the new value), funder is a past grant linked to or unlinked from a funder in Grantlas, and submitted is a hand edit of the submitted date (set, changed or cleared; a stage move that records it writes no line of its own). text is the line as the app shows it. stage and stage_label are where it went (for added, stage and restored), from_stage and from_stage_label where it came from (for stage); the names are the ones the stages had at the time. amount_awarded is the amount on a stage or outcome line. actor is who did it ({ name, email }), or null for someone who has left the account and on a line with recorded false. via is app, claude, chatgpt or api. recorded is false for the first line of an item tracked before history was kept: changes before then weren't recorded. Notes are not here: see the notes endpoints.
List stagesGET /v1/stages
The account's Tracker stages, in order. Every organization in the account shares them.
curl "https://api.grantlas.com/v1/stages" \
-H "Authorization: Bearer $GRANTLAS_API_KEY"{
"data": [
{
"key": "researching",
"label": "Researching",
"kind": "in_progress",
"position": 0
},
{
"key": "loi",
"label": "LOI",
"kind": "in_progress",
"position": 1
},
{
"key": "applying",
"label": "Applying",
"kind": "in_progress",
"position": 2
},
{
"key": "submitted",
"label": "Submitted",
"kind": "submitted",
"position": 3
},
{
"key": "awarded",
"label": "Awarded",
"kind": "won",
"position": 4
},
{
"key": "declined",
"label": "Declined",
"kind": "not_won",
"position": 5
}
]
}key is what each Tracker item's stage holds: it never changes, even when the stage is renamed in the app (Settings → Tracker setup). label is its name. kind is in_progress (deadline reminders go out), submitted (still open, no reminders), won or not_won (closed). position is its place in the list, from 0. Stages are edited in the app, not through the API.
List an item's tasksGET /v1/orgs/{org}/tracker/{item}/tasks
The Tracker item's tasks: open ones first, soonest due first, then done ones.
Parameters
orgpath · string · required- An organization id from GET /v1/orgs, like org_3f9a1c0e7b2d4a61.
itempath · string · required- A Tracker item id (the id of each Tracker item), like trk_8c2e5b17d94f0a3c.
curl "https://api.grantlas.com/v1/orgs/org_3f9a1c0e7b2d4a61/tracker/trk_8c2e5b17d94f0a3c/tasks" \
-H "Authorization: Bearer $GRANTLAS_API_KEY"{
"data": [
{
"id": "tsk_4b7d2e9a1c0f6e35",
"tracker_item_id": "trk_8c2e5b17d94f0a3c",
"title": "Draft the budget",
"due_date": "2027-02-15",
"kind": "task",
"report_type": null,
"done": false,
"done_at": null,
"assignee": {
"name": "Pat Owner",
"email": "pat@frontrangefood.org"
},
"created_at": "2026-10-02T15:30:00.000Z",
"updated_at": "2026-10-02T15:30:00.000Z"
}
]
}An item holds up to 100 tasks, so this list isn't paged. due_date is YYYY-MM-DD or null. done_at is when it was first checked off, or null while it's open. assignee is the teammate it's assigned to ({ name, email }): the item's owner unless you name someone. A task with a due date gets reminder emails, like a deadline, until it's done. kind is task or report: a report deadline (kind report) is a report owed to a funder, and always has a due date. report_type is interim, final or null, and is null on every plain task.
Add a taskPOST /v1/orgs/{org}/tracker/{item}/tasks
Adds a task to the Tracker item and returns it. If one field is wrong, nothing is saved.
Parameters
orgpath · string · required- An organization id from GET /v1/orgs, like org_3f9a1c0e7b2d4a61.
itempath · string · required- A Tracker item id (the id of each Tracker item), like trk_8c2e5b17d94f0a3c.
titleJSON body · string · required- What needs doing, up to 200 characters.
due_dateJSON body · string | null- YYYY-MM-DD, or leave it out for no due date.
assigneeJSON body · string- A teammate's email. Left out, the task goes to the item's owner.
kindJSON body · string- report for a report owed to the funder (needs due_date). Left out, task.
One of: task, report · Default: task
report_typeJSON body · string | null- interim or final, for kind report only (optional).
One of: interim, final
repeat_monthsJSON body · integer- For kind report: repeat every 3, 6 or 12 months, each date its own deadline. Needs until.
One of: 3, 6, 12
untilJSON body · string- YYYY-MM-DD: the last date to repeat until, inclusive. At most 24 dates.
last_is_finalJSON body · boolean- With repeat_months: true makes the last date the final report.
curl -X POST "https://api.grantlas.com/v1/orgs/org_3f9a1c0e7b2d4a61/tracker/trk_8c2e5b17d94f0a3c/tasks" \
-H "Authorization: Bearer $GRANTLAS_API_KEY" \
-H "Content-Type: application/json" \
-d '{"title":"Draft the budget","due_date":"2027-02-15","assignee":"pat@frontrangefood.org"}'{
"data": {
"id": "tsk_4b7d2e9a1c0f6e35",
"tracker_item_id": "trk_8c2e5b17d94f0a3c",
"title": "Draft the budget",
"due_date": "2027-02-15",
"kind": "task",
"report_type": null,
"done": false,
"done_at": null,
"assignee": {
"name": "Pat Owner",
"email": "pat@frontrangefood.org"
},
"created_at": "2026-10-02T15:30:00.000Z",
"updated_at": "2026-10-02T15:30:00.000Z"
}
}curl -X POST "https://api.grantlas.com/v1/orgs/org_3f9a1c0e7b2d4a61/tracker/trk_8c2e5b17d94f0a3c/tasks" \
-H "Authorization: Bearer $GRANTLAS_API_KEY" \
-H "Content-Type: application/json" \
-d '{"title":"Interim report","due_date":"2027-03-31","kind":"report","repeat_months":6,"until":"2028-03-31","last_is_final":true}'{
"data": {
"tasks": [
{
"id": "tsk_4b8e1f0a6c2d9e37",
"tracker_item_id": "trk_8c2e5b17d94f0a3c",
"title": "Interim report 1 of 2",
"due_date": "2027-03-31",
"kind": "report",
"report_type": "interim",
"done": false,
"done_at": null,
"assignee": {
"name": "Pat Owner",
"email": "pat@frontrangefood.org"
},
"created_at": "2026-10-02T15:30:00.000Z",
"updated_at": "2026-10-02T15:30:00.000Z"
},
{
"id": "tsk_9d3c7a5e1b0f2846",
"tracker_item_id": "trk_8c2e5b17d94f0a3c",
"title": "Interim report 2 of 2",
"due_date": "2027-09-30",
"kind": "report",
"report_type": "interim",
"done": false,
"done_at": null,
"assignee": {
"name": "Pat Owner",
"email": "pat@frontrangefood.org"
},
"created_at": "2026-10-02T15:30:00.000Z",
"updated_at": "2026-10-02T15:30:00.000Z"
},
{
"id": "tsk_1f6a2e9c7d4b8035",
"tracker_item_id": "trk_8c2e5b17d94f0a3c",
"title": "Final report",
"due_date": "2028-03-31",
"kind": "report",
"report_type": "final",
"done": false,
"done_at": null,
"assignee": {
"name": "Pat Owner",
"email": "pat@frontrangefood.org"
},
"created_at": "2026-10-02T15:30:00.000Z",
"updated_at": "2026-10-02T15:30:00.000Z"
}
]
}
}An item holds up to 100 tasks and report deadlines together; past that you get 400. due_date is YYYY-MM-DD or null. done_at is when it was first checked off, or null while it's open. assignee is the teammate it's assigned to ({ name, email }): the item's owner unless you name someone. A task with a due date gets reminder emails, like a deadline, until it's done. kind is task or report: a report deadline (kind report) is a report owed to a funder, and always has a due date. report_type is interim, final or null, and is null on every plain task. With repeat_months, title is the base name: every date is its own report deadline, at most 24 in one add, and the response is { data: { tasks: [...] } }, every one of them, soonest first. A report_type that isn't interim or final, or one on a plain task, is a 400.
Update a taskPATCH /v1/orgs/{org}/tracker/{item}/tasks/{task}
Change any of title, due date, done, assignee, kind and report type. If one field is wrong, nothing is saved.
Parameters
orgpath · string · required- An organization id from GET /v1/orgs, like org_3f9a1c0e7b2d4a61.
itempath · string · required- A Tracker item id (the id of each Tracker item), like trk_8c2e5b17d94f0a3c.
taskpath · string · required- A task id from the item's task list, like tsk_4b7d2e9a1c0f6e35.
titleJSON body · string- Up to 200 characters.
due_dateJSON body · string | null- YYYY-MM-DD, or null to clear.
doneJSON body · boolean- true or false.
assigneeJSON body · string- A teammate's email.
kindJSON body · string- task or report. A report needs a due date; task clears report_type.
One of: task, report
report_typeJSON body · string | null- interim, final or null, for kind report only.
One of: interim, final
curl -X PATCH "https://api.grantlas.com/v1/orgs/org_3f9a1c0e7b2d4a61/tracker/trk_8c2e5b17d94f0a3c/tasks/tsk_4b7d2e9a1c0f6e35" \
-H "Authorization: Bearer $GRANTLAS_API_KEY" \
-H "Content-Type: application/json" \
-d '{"title":"Draft the budget","due_date":"2027-02-15","done":true,"assignee":"pat@frontrangefood.org"}'{
"data": {
"id": "tsk_4b7d2e9a1c0f6e35",
"tracker_item_id": "trk_8c2e5b17d94f0a3c",
"title": "Draft the budget",
"due_date": "2027-02-15",
"kind": "task",
"report_type": null,
"done": true,
"done_at": "2026-10-05T18:20:00.000Z",
"assignee": {
"name": "Pat Owner",
"email": "pat@frontrangefood.org"
},
"created_at": "2026-10-02T15:30:00.000Z",
"updated_at": "2026-10-05T18:20:00.000Z"
}
}Send only the fields you want to change: kind and report_type left out stay as they are, so a report stays a report. done: true checks it off (and stops its reminders); done: false reopens it. A report deadline can't lose its due date (400). due_date is YYYY-MM-DD or null. done_at is when it was first checked off, or null while it's open. assignee is the teammate it's assigned to ({ name, email }): the item's owner unless you name someone. A task with a due date gets reminder emails, like a deadline, until it's done. kind is task or report: a report deadline (kind report) is a report owed to a funder, and always has a due date. report_type is interim, final or null, and is null on every plain task.
Delete a taskDELETE /v1/orgs/{org}/tracker/{item}/tasks/{task}
Removes the task from the Tracker item. There is no undo.
Parameters
orgpath · string · required- An organization id from GET /v1/orgs, like org_3f9a1c0e7b2d4a61.
itempath · string · required- A Tracker item id (the id of each Tracker item), like trk_8c2e5b17d94f0a3c.
taskpath · string · required- A task id from the item's task list, like tsk_4b7d2e9a1c0f6e35.
curl -X DELETE "https://api.grantlas.com/v1/orgs/org_3f9a1c0e7b2d4a61/tracker/trk_8c2e5b17d94f0a3c/tasks/tsk_4b7d2e9a1c0f6e35" \
-H "Authorization: Bearer $GRANTLAS_API_KEY"Returns 204 No Content, with no body.
Answer library
Search saved answersGET /v1/orgs/{org}/answers
The organization's saved answers: the best matches for q, or the most recently used first.
Parameters
orgpath · string · required- An organization id from GET /v1/orgs, like org_3f9a1c0e7b2d4a61.
qquery · string- Words to search for. Leave out for every saved answer, most recently used first.
pagequery · integer- Page number, from 1.
Default: 1 · 1 or more
per_pagequery · integer- Items per page, 1 to 100.
Default: 25 · 1 to 100
curl "https://api.grantlas.com/v1/orgs/org_3f9a1c0e7b2d4a61/answers" \
-H "Authorization: Bearer $GRANTLAS_API_KEY"{
"data": [
{
"id": "ans_3b8e1f0c6a2d9475",
"title": "Mission statement",
"markdown": "Front Range Food Bank makes sure **no family in Adams County** goes to bed hungry.",
"words": 14,
"used_count": 3,
"last_used_at": "2026-10-02T15:40:00.000Z",
"updated_at": "2026-09-12T10:05:00.000Z",
"updated_via": "app"
}
],
"page": 1,
"per_page": 25,
"total": 1,
"total_pages": 1
}q matches words in titles and text ("families" finds "family", and the last word matches as a prefix). Punctuation and search operators in q are ignored, so a q with no words returns an empty list. markdown is the answer as Markdown (paragraphs, **bold**, *italic*, <u>underline</u>, links, - and 1. lists). words is its word count. used_count is how many times it was inserted into an application, and last_used_at when it last was (null when never). updated_via is app, claude, chatgpt or api. Answers are edited and deleted in the app.
Save an answerPOST /v1/orgs/{org}/answers
Adds a saved answer to the organization's library and returns it. It never replaces one.
Parameters
orgpath · string · required- An organization id from GET /v1/orgs, like org_3f9a1c0e7b2d4a61.
titleJSON body · string · required- A short title, up to 200 characters.
markdownJSON body · string · required- The answer as Markdown, up to 100,000 characters of text.
curl -X POST "https://api.grantlas.com/v1/orgs/org_3f9a1c0e7b2d4a61/answers" \
-H "Authorization: Bearer $GRANTLAS_API_KEY" \
-H "Content-Type: application/json" \
-d '{"title":"Mission statement","markdown":"Front Range Food Bank makes sure **no family in Adams County** goes to bed hungry."}'{
"data": {
"id": "ans_3b8e1f0c6a2d9475",
"title": "Mission statement",
"markdown": "Front Range Food Bank makes sure **no family in Adams County** goes to bed hungry.",
"words": 14,
"used_count": 0,
"last_used_at": null,
"updated_at": "2026-09-12T10:05:00.000Z",
"updated_via": "api"
}
}An organization holds up to 2,000 saved answers; past that you get 400. markdown is the answer as Markdown (paragraphs, **bold**, *italic*, <u>underline</u>, links, - and 1. lists). words is its word count. used_count is how many times it was inserted into an application, and last_used_at when it last was (null when never). updated_via is app, claude, chatgpt or api. Answers are edited and deleted in the app.
Saved
Saved funders and grantsGET /v1/orgs/{org}/saved
Everything the organization has saved, newest first.
Parameters
orgpath · string · required- An organization id from GET /v1/orgs, like org_3f9a1c0e7b2d4a61.
typequery · string- funder or grant. Both when left out.
One of: funder, grant
tagquery · string- Only saved items with this tag, by name (?tag=Board ask), matched ignoring capitals and extra spaces. A name that isn't one of your tags returns an empty list (200), not an error.
pagequery · integer- Page number, from 1.
Default: 1 · 1 or more
per_pagequery · integer- Items per page, 1 to 100.
Default: 25 · 1 to 100
curl "https://api.grantlas.com/v1/orgs/org_3f9a1c0e7b2d4a61/saved" \
-H "Authorization: Bearer $GRANTLAS_API_KEY"{
"data": [
{
"type": "grant",
"id": 55120,
"name": "Community Food Security Innovation Grants",
"saved_at": "2026-09-18T09:00:00.000Z",
"tags": [
"Board ask"
],
"fit": {
"status": "scored",
"score": 81,
"label": "Good",
"stale": false,
"reason": "Supports community food access programs like your pantry network, at an award size you can manage."
},
"tracked": false,
"url": "https://grantlas.com/grant/55120"
}
],
"page": 1,
"per_page": 25,
"total": 1,
"total_pages": 1
}tags is the item's tags by name, A to Z (tags are kept when it is tracked; fields are on Tracker items only). fit is shown where it has already been analyzed; this list never starts an analysis. name is null once a record has left Grantlas. tracked is true while the record is on the organization's Tracker. An archived Tracker item reads false; tracking it again (POST /v1/orgs/{org}/tracker) restores it, in the stage it had. fit.status is scored (with score 0 to 100, label Great, Good, Okay, Weak or Very weak, and a one-sentence reason), or not_scored. A grant can also be still_scoring (ask again in a minute) or unavailable (the account is out of Grantlas AI credits, or analysis is paused for the day). A funder's fit is always current: it is worked out from the funder's giving record and needs no analysis. fit.stale is true when a grant's fit is from before the organization's last profile change.
Deadlines
Upcoming deadlinesGET /v1/orgs/{org}/deadlines
Open Tracker items with a deadline, and open report deadlines, in the next N days, soonest first.
Parameters
orgpath · string · required- An organization id from GET /v1/orgs, like org_3f9a1c0e7b2d4a61.
daysquery · integer- How many days ahead to look, 1 to 365.
Default: 60 · 1 to 365
curl "https://api.grantlas.com/v1/orgs/org_3f9a1c0e7b2d4a61/deadlines" \
-H "Authorization: Bearer $GRANTLAS_API_KEY"{
"data": [
{
"date": "2027-03-01",
"kind": "application_deadline",
"tracker_item_id": "trk_8c2e5b17d94f0a3c",
"type": "funder",
"id": 90211,
"name": "Rocky Mountain Family Trust",
"task_id": null,
"title": null,
"stage": "loi",
"stage_label": "LOI",
"reminders": "default",
"url": "https://grantlas.com/funder/90211"
},
{
"date": "2027-03-31",
"kind": "report_due",
"tracker_item_id": "trk_8a41c6e0d27f5b93",
"type": "grant",
"id": 55120,
"name": "Community Food Security Innovation Grants",
"task_id": "tsk_4b8e1f0a6c2d9e37",
"title": "Interim report 1 of 2",
"stage": "awarded",
"stage_label": "Awarded",
"reminders": "default",
"url": "https://grantlas.com/grant/55120"
}
]
}Archived items are left out. reminders says which reminder emails are set for that item: default (the standard schedule), custom, or off. kind says what the date is: application_deadline (the item's deadline) or report_due (a report deadline owed to the funder, in any stage). A report_due row names its report with task_id (tsk_…) and title; both are null on an application_deadline row. Plain tasks are not deadlines: read them from the task endpoints. Changed October 2026: report deadlines are now included, and every row has kind, task_id and title.
Upcoming deadlines, every organizationGET /v1/deadlines
Open Tracker items from all your organizations with a deadline, and open report deadlines, in the next N days, soonest first. Each row names its organization.
Parameters
daysquery · integer- How many days ahead to look, 1 to 365.
Default: 60 · 1 to 365
curl "https://api.grantlas.com/v1/deadlines" \
-H "Authorization: Bearer $GRANTLAS_API_KEY"{
"data": [
{
"date": "2027-03-01",
"kind": "application_deadline",
"org": {
"id": "org_3f9a1c0e7b2d4a61",
"name": "Riverbend Literacy"
},
"tracker_item_id": "trk_8c2e5b17d94f0a3c",
"type": "funder",
"id": 90211,
"name": "Rocky Mountain Family Trust",
"task_id": null,
"title": null,
"stage": "loi",
"stage_label": "LOI",
"reminders": "default",
"url": "https://grantlas.com/funder/90211"
},
{
"date": "2027-03-31",
"kind": "report_due",
"tracker_item_id": "trk_8a41c6e0d27f5b93",
"type": "grant",
"id": 55120,
"name": "Community Food Security Innovation Grants",
"task_id": "tsk_4b8e1f0a6c2d9e37",
"title": "Interim report 1 of 2",
"stage": "awarded",
"stage_label": "Awarded",
"reminders": "default",
"url": "https://grantlas.com/grant/55120",
"org": {
"id": "org_3f9a1c0e7b2d4a61",
"name": "Riverbend Literacy"
}
}
]
}The same fields as GET /v1/orgs/{org}/deadlines, plus org. Archived items are left out. 404 (not_found) when the account has only one organization. reminders says which reminder emails are set for that item: default, custom, or off. kind says what the date is: application_deadline (the item's deadline) or report_due (a report deadline owed to the funder, in any stage). A report_due row names its report with task_id (tsk_…) and title; both are null on an application_deadline row. Plain tasks are not deadlines: read them from the task endpoints. Changed October 2026: report deadlines are now included, and every row has kind, task_id and title.
Reports
Grant resultsGET /v1/orgs/{org}/performance
The organization's grant results for a period, the same figures as Reports in Grantlas: decided, won and not won, win rate, amounts awarded and requested, pending, by year and by funder.
Parameters
orgpath · string · required- An organization id from GET /v1/orgs, like org_3f9a1c0e7b2d4a61.
periodquery · string- this_fy (this fiscal year), last_fy, all (all time), or custom with from and to.
One of: this_fy, last_fy, all, custom · Default: this_fy
fromquery · string- With period=custom: the first day, YYYY-MM-DD.
toquery · string- With period=custom: the last day, YYYY-MM-DD, on or after from.
curl "https://api.grantlas.com/v1/orgs/org_3f9a1c0e7b2d4a61/performance" \
-H "Authorization: Bearer $GRANTLAS_API_KEY"{
"data": {
"period": {
"kind": "this_fy",
"label": "FY 2026–27",
"span": "Jul 1, 2026 – Jun 30, 2027",
"from": "2026-07-01",
"to": "2027-06-30",
"calendar_years": false
},
"decided": 5,
"won": 3,
"lost": 2,
"win_rate": 0.6,
"awarded": {
"sum": 65000,
"without_amount": 1
},
"requested": {
"sum": 140000,
"without_amount": 0
},
"pending": {
"count": 4,
"requested": {
"sum": 85000,
"without_amount": 1
}
},
"pending_as_of": "2026-10-18",
"submitted": {
"count": 6,
"requested": {
"sum": 160000,
"without_amount": 0
},
"decided_without_submitted_date": 1
},
"placed_by_year_only": 0,
"archived_included": 0,
"no_decided_date": 0,
"by_year": [
{
"year": 2026,
"label": "FY 2026–27",
"decided": 5,
"won": 3,
"win_rate": 0.6,
"awarded": {
"sum": 65000,
"without_amount": 1
},
"requested": {
"sum": 140000,
"without_amount": 0
},
"current": true
},
{
"year": 2025,
"label": "FY 2025–26",
"decided": 2,
"won": 1,
"win_rate": null,
"awarded": {
"sum": 20000,
"without_amount": 0
},
"requested": {
"sum": 45000,
"without_amount": 0
},
"current": false
}
],
"by_funder": [
{
"name": "Rocky Mountain Family Trust",
"funder_id": 90211,
"decided": 2,
"won": 2,
"lost": 0,
"awarded": {
"sum": 45000,
"without_amount": 0
},
"requested": {
"sum": 60000,
"without_amount": 0
},
"repeat": true
},
{
"name": "Colorado Health Access Fund",
"funder_id": null,
"decided": 1,
"won": 1,
"lost": 0,
"awarded": {
"sum": 20000,
"without_amount": 0
},
"requested": {
"sum": 25000,
"without_amount": 0
},
"repeat": false
}
],
"by_funder_more": 0,
"links": {
"reports": "https://grantlas.com/reports?period=this_fy",
"board_report": "https://grantlas.com/reports/report?audience=board&period=this_fy"
},
"share_link": {
"url": "https://grantlas.com/r/Hx2Q8m0VtYl1uD9cR4bN7sKf3JpAe6WzG5iTo_XyLhU",
"period": "this_fy",
"includes": {
"not_won": true,
"open_tasks": false,
"notes": false,
"fit": false,
"reports": true
},
"has_code": false,
"created_at": "2026-10-12",
"last_viewed_at": "2026-10-18"
}
}
}Periods follow the organization's fiscal year (fiscal_year_start_month on GET /v1/orgs; January when not set). decided counts won and not won grants whose decided date falls in the period; all includes closed grants with no decided date (no_decided_date says how many), and archived grants count too (archived_included). win_rate is won ÷ decided from 0 to 1, and null below 3 decided grants. Every amount is { sum, without_amount }: sum adds the grants that have an amount and is null when none has one, never 0 for a missing amount; without_amount counts the grants with none. awarded is on won grants; requested is on the period's decided grants. pending is the applications waiting for a decision today, and null (with pending_as_of) when the period doesn't include today. submitted counts applications by their submitted date alone. placed_by_year_only counts decided grants recorded with only a year, which count on July 1 of that year. by_year lists every year with a decided grant whatever the period, newest first, five at most, then year null ("Earlier") for the rest. by_funder lists the period's top 10 funders by amount awarded, then won, then decided; by_funder_more counts the rest. funder_id is the Grantlas funder id when the funder is linked, else null; repeat is true when you won from the same funder before. links open the same period in Grantlas. share_link is the board report's existing share link for this period (this_fy, last_fy, all, or custom with the same two dates), or null when there is none. It is the newest link that works now: a revoked or paused link is never returned, and this API never creates or revokes one. Only the link's address and settings come back, never its code (has_code says whether it has one). Create and revoke links with Share on the report in Grantlas.
FilesGET /v1/orgs/{org}/files
The files kept in Grantlas for the organization, newest first: names and sizes, never contents.
Parameters
orgpath · string · required- An organization id from GET /v1/orgs, like org_3f9a1c0e7b2d4a61.
pagequery · integer- 1-based page.
curl "https://api.grantlas.com/v1/orgs/org_3f9a1c0e7b2d4a61/files" \
-H "Authorization: Bearer $GRANTLAS_API_KEY"{
"data": [
{
"id": "fil_7c1e5a9b3d2f8046",
"name": "2026 budget.xlsx",
"content_type": "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet",
"size_bytes": 48213,
"added_at": "2026-11-02T15:04:00.000Z"
}
]
}100 a page; total counts them all. Files are added and read in the app.
File textGET /v1/orgs/{org}/files/{file}/text
The text of one file kept in Grantlas for the organization, such as a funder's application form or a past proposal.
Parameters
orgpath · string · required- An organization id from GET /v1/orgs, like org_3f9a1c0e7b2d4a61.
filepath · string · required- A file id from GET /v1/orgs/{org}/files, like fil_7c1e5a9b3d2f8046.
curl "https://api.grantlas.com/v1/orgs/org_3f9a1c0e7b2d4a61/files/1/text" \
-H "Authorization: Bearer $GRANTLAS_API_KEY"{
"data": {
"id": "fil_3a8d0c6e1b9f2475",
"name": "Community Fund application 2027.pdf",
"content_type": "application/pdf",
"text": "1. Describe your organization's mission. (250 words)\n\n2. What will this grant fund?",
"truncated": false,
"characters": 83
}
}The same text as the read_file tool for Claude and ChatGPT. PDF, Word (.docx), text (.txt) and CSV files can be read. Any other type, a scanned PDF (no text in it) or a PDF with a password is a 422 unreadable_file, with a message saying why. Long files are cut after the first 100,000 characters: truncated is then true, characters counts the whole text, and the text ends with a note saying it was cut. A file of another organization is a 404, as an id that doesn't exist.
ReportGET /v1/orgs/{org}/report
The report the Create report screen shows for the organization: grant results, applications waiting, and for a client or internal report the open applications by when they're due and the open tasks.
Parameters
orgpath · string · required- An organization id from GET /v1/orgs, like org_3f9a1c0e7b2d4a61.
audiencequery · string- Who the report is for. Client is for consulting accounts.
One of: board, client, internal
periodquery · string- this_fy (this fiscal year), last_fy or all (all time).
One of: this_fy, last_fy, all · Default: this_fy
include_not_wonquery · boolean- true or false: list the grants that were not won. Default: true for client and internal, false for board.
include_tasksquery · boolean- true or false: include the open tasks. Default: true for client and internal. A board report has none.
include_notesquery · boolean- true or false: include each open application's latest note. Default: true for internal only.
include_fitquery · boolean- true or false: include each application's Fit number. Default: false.
include_reportsquery · boolean- true or false: include the report deadlines due to funders (reports_due). Default: true.
curl "https://api.grantlas.com/v1/orgs/org_3f9a1c0e7b2d4a61/report" \
-H "Authorization: Bearer $GRANTLAS_API_KEY"{
"data": {
"audience": "internal",
"org_name": "Riverbend Literacy",
"business_name": null,
"prepared_on": "2026-10-18",
"period": {
"kind": "this_fy",
"label": "FY 2026–27",
"span": "Jul 1, 2026 – Jun 30, 2027",
"from": "2026-07-01",
"to": "2027-06-30"
},
"options": {
"include_not_won": true,
"include_tasks": true,
"include_notes": true,
"include_fit": false,
"include_reports": true
},
"lead": "In FY 2026–27, 2 grants were decided and 1 was won.",
"nothing_decided_or_pending": false,
"figures": {
"decided": 2,
"won": 1,
"lost": 1,
"win_rate": null,
"awarded": {
"sum": 20000,
"without_amount": 0
},
"requested": {
"sum": 45000,
"without_amount": 0
},
"pending": {
"count": 1,
"requested": {
"sum": 25000,
"without_amount": 0
}
},
"submitted": {
"count": 2,
"requested": {
"sum": 50000,
"without_amount": 0
},
"decided_without_submitted_date": 0
}
},
"by_year": [
{
"year": 2026,
"label": "FY 2026–27",
"decided": 2,
"won": 1,
"win_rate": null,
"awarded": {
"sum": 20000,
"without_amount": 0
},
"requested": {
"sum": 45000,
"without_amount": 0
}
}
],
"won": {
"total": 1,
"items": [
{
"item_id": "trk_8c2e5b17d94f0a3c",
"funder": "Colorado Health Access Fund",
"grant": null,
"stage": "Awarded",
"decided_on": "2026-08-12",
"decided_precision": "day",
"submitted_on": "2026-06-01",
"requested": 25000,
"awarded": 20000,
"archived": false
}
],
"more": 0
},
"not_won": {
"total": 0,
"items": [],
"more": 0
},
"waiting": {
"total": 0,
"items": [],
"more": 0,
"requested_total": {
"sum": null,
"without_amount": 0
}
},
"submitted": {
"total": 0,
"items": [],
"more": 0
},
"in_progress": null,
"open_applications": {
"total": 1,
"stage_counts": [
{
"label": "Applying",
"count": 1
}
],
"groups": [
{
"group": "due90",
"items": [
{
"item_id": "trk_8c2e5b17d94f0a3c",
"funder": "Rocky Mountain Family Trust",
"grant": "Literacy Fund 2027",
"stage": "Applying",
"deadline": "2026-11-30",
"deadline_note": null,
"requested": 25000,
"next_task": {
"title": "Send budget",
"due_on": "2026-11-01"
},
"latest_note": null
}
],
"more": 0
},
{
"group": "later",
"items": [],
"more": 0
},
{
"group": "noDate",
"items": [],
"more": 0
},
{
"group": "past",
"items": [],
"more": 0
}
]
},
"open_tasks": {
"overdue": [],
"overdue_total": 0,
"due_90_total": 1,
"due_90": [
{
"task_id": "tsk_4b7d2e9a1c0f6e35",
"item_id": "trk_8c2e5b17d94f0a3c",
"title": "Send budget",
"due_on": "2026-11-01",
"funder": "Rocky Mountain Family Trust",
"grant": "Literacy Fund 2027"
}
],
"no_due_date": 0,
"due_after_90_days": 0,
"more": 0,
"through": "2027-01-16"
},
"reports_due": {
"as_of": "2026-10-18",
"overdue": [],
"due_90": [
{
"title": "Interim report",
"report_type": "interim",
"funder": "Colorado Health Access Fund",
"grant": null,
"due": "2026-12-31",
"not_won": false
}
],
"overdue_total": 0,
"due_90_total": 1
},
"view_url": "https://grantlas.com/reports/report?audience=internal&period=this_fy",
"pdf_url": "https://grantlas.com/reports/report/pdf?audience=internal&period=this_fy",
"share_link": {
"url": "https://grantlas.com/r/Hx2Q8m0VtYl1uD9cR4bN7sKf3JpAe6WzG5iTo_XyLhU",
"period": "this_fy",
"includes": {
"not_won": true,
"open_tasks": false,
"notes": false,
"fit": false,
"reports": true
},
"has_code": false,
"created_at": "2026-10-12",
"last_viewed_at": "2026-10-18"
}
}
}The same report, in the same body, as the grant_report tool for Claude and ChatGPT. audience is board, client or internal; left out, it is client for a Pro consulting account and board otherwise. client is for consulting accounts: for any other account it is a 400. period is this_fy, last_fy or all (the organization's fiscal year; this_fy when left out). include_not_won, include_tasks, include_notes and include_fit are true or false; left out, each takes the audience's own default (not won and tasks on for client and internal, notes on for internal only, fit off). Fit appears only with include_fit=true. who (the team member on a task) appears only on an internal report for a team of two or more. A board report has open_applications and open_tasks null and lists its grants in progress by stage in in_progress. Each list holds at most 300 rows, with more counting the rest; the spreadsheet in Grantlas has every row. Items and tasks use their Tracker item (trk_…) and task (tsk_…) ids. Every amount is { sum, without_amount }, with sum null when no row has an amount, never 0. view_url opens the same report in Grantlas and pdf_url downloads it as a PDF; both open the report for the client currently chosen in the browser (they carry no organization). Fit is for open work only: it is never on a waiting row. open_tasks.overdue_total and due_90_total count every open task, uncapped; the overdue and due_90 lists hold at most 300 rows, with more counting the rest. include_reports (on when left out) adds reports_due: the open report deadlines owed to funders as of as_of, overdue and due in the next 90 days, on won grants for board and client (internal also lists those on grants not marked won, with not_won, and who for a team of two or more). Each row is { title, report_type, funder, grant, due }; overdue_total and due_90_total count every one. reports_due is null with include_reports=false. share_link is the existing share link for this audience and period (this_fy, last_fy or all), or null when there is none. It is the newest link that works now: a revoked or paused link is never returned, and this API never creates or revokes one. Only the link's address and settings come back, never its code (has_code says whether it has one). Create and revoke links with Share on the report in Grantlas.
Saved searches
List saved searchesGET /v1/orgs/{org}/saved-searches
The organization's saved searches, newest first.
Parameters
orgpath · string · required- An organization id from GET /v1/orgs, like org_3f9a1c0e7b2d4a61.
curl "https://api.grantlas.com/v1/orgs/org_3f9a1c0e7b2d4a61/saved-searches" \
-H "Authorization: Bearer $GRANTLAS_API_KEY"{
"data": [
{
"id": "srch_51d7a0c9e3b86f24",
"name": "Food security grants for nonprofits",
"type": "grant",
"filters": {
"keyword": "food security",
"eligibilityType": "nonprofit"
},
"alerts": "on",
"created_at": "2026-09-02T14:00:00.000Z",
"new_matches_supported": true,
"url": "https://grantlas.com/saved-searches"
}
]
}filters uses the same names as the search endpoints' filters. alerts is on or off. new_matches_supported is true for grant searches, the only kind the new-matches endpoint works with.
New matches for a saved searchGET /v1/orgs/{org}/saved-searches/{search}/matches
Grants matching a saved grant search that Grantlas first saw on or after a date or time. For a daily automation, pass the time exactly 24 hours ago, so no match is sent twice.
Parameters
orgpath · string · required- An organization id from GET /v1/orgs, like org_3f9a1c0e7b2d4a61.
searchpath · string · required- A saved-search id from the list above, like srch_51d7a0c9e3b86f24.
sincequery · string · required- A date (2026-09-01, the whole day included) or a time (2026-09-01T06:00:00Z). Grants first seen at or after it are included.
pagequery · integer- Page number, from 1.
Default: 1 · 1 or more
per_pagequery · integer- Items per page, 1 to 100.
Default: 25 · 1 to 100
curl "https://api.grantlas.com/v1/orgs/org_3f9a1c0e7b2d4a61/saved-searches/srch_51d7a0c9e3b86f24/matches" \
-H "Authorization: Bearer $GRANTLAS_API_KEY"{
"data": [
{
"id": 55342,
"title": "Rural Nutrition Access Partnership",
"agency": "Department of Agriculture",
"status": "open",
"source": "federal",
"source_url": "https://www.grants.gov/search-results-detail/355342",
"funding_min": 100000,
"funding_max": 500000,
"deadline": "2026-12-28",
"fit": {
"status": "scored",
"score": 74,
"label": "Good",
"stale": false,
"reason": "Funds nutrition access in rural areas, which your mobile pantry serves."
},
"saved": false,
"tracked": false,
"url": "https://grantlas.com/grant/55342"
}
],
"page": 1,
"per_page": 25,
"total": 1,
"total_pages": 1
}For a forecasted grant, deadline is the expected close date; expected_deadline repeats it. expected_opening: for a forecasted grant whose funder named only a season or year, when it is expected to open, in the funder's words ("early 2027", "fall 2026"); never a date, and deadline stays null. Grants are open or forecasted unless the saved search sets a status (unlike search grants, where no status means every status). The organization's exclusions are applied. A funder search gets 400 funder_search_not_supported, because funder records have no posted date. fit is shown where it has already been analyzed. tracked is true while the record is on the organization's Tracker. An archived Tracker item reads false; tracking it again (POST /v1/orgs/{org}/tracker) restores it, in the stage it had. fit.status is scored (with score 0 to 100, label Great, Good, Okay, Weak or Very weak, and a one-sentence reason), or not_scored. A grant can also be still_scoring (ask again in a minute) or unavailable (the account is out of Grantlas AI credits, or analysis is paused for the day). A funder's fit is always current: it is worked out from the funder's giving record and needs no analysis. fit.stale is true when a grant's fit is from before the organization's last profile change.
Funders
Search fundersGET /v1/orgs/{org}/funders
Foundations and other grantmakers matching the filters, best Fit for this organization first. The organization's exclusions and hidden funders are left out.
Parameters
orgpath · string · required- An organization id from GET /v1/orgs, like org_3f9a1c0e7b2d4a61.
keywordquery · string- Words in the funder's name, mission or giving.
giquery · string- Gives in: comma-separated two-letter states. Based there, or at least 2 recent grants and a real share (10%, 20% for national funders) of its recent grants went there.
stquery · string- Based in: comma-separated two-letter states, e.g. CO,NE. (state= also works, one state.)
statequery · string- Two-letter state, e.g. CO (older form of st).
cityquery · string- Comma-separated cities; alternate spellings (St. Louis, Saint Louis) match.
sectorquery · string- A cause area, as in the app's Cause filter, e.g. education or human-services.
focusquery · string- A giving area, as in the app's Focus area filter, e.g. health. (givingArea= also works.)
givingAreaquery · string- A giving area (older form of focus).
fitquery · string- Only funders at Good or better for this organization, or Great.
One of: good, great
acceptsquery · string- Comma-separated: open (accepts applications from organizations; 1 also works), unstated (the tax form doesn't say), closed (invitation only, individuals only or donor-advised). Left out = all.
timingquery · string- When they accept: year-round, a stated cycle (dated), or no dates given (unstated). Means they accept applications. (cycle=year-round|dated also works.)
One of: year-round, dated, unstated
cyclequery · string- Older form of timing.
One of: year-round, dated
mquery · string- Cycle month: comma-separated 1-12; the filing's cycle names any of them. Means they accept applications.
ftypequery · string- Comma-separated funder types: private, corporate, community, public, federation, charity. Left out = all. corporate = corporate (company-sponsored) foundations. When the list names corporate (or ftv=2 is set), private means private foundations that are not corporate; without either, private includes corporate foundations (older links).
tminquery · integer- Typical (median) grant at least this, dollars. Leaves out funders with no grant history or mostly small gifts.
0 or more
tmaxquery · integer- Typical (median) grant at most this, dollars. Leaves out funders with no grant history or mostly small gifts.
0 or more
gminquery · integer- Yearly giving at least this, dollars.
0 or more
gmaxquery · integer- Yearly giving at most this, dollars.
0 or more
aminquery · integer- Minimum assets, dollars. (minAssets= also works.)
0 or more
amaxquery · integer- Maximum assets, dollars. (maxAssets= also works.)
0 or more
minAssetsquery · integer- Older form of amin.
0 or more
maxAssetsquery · integer- Older form of amax.
0 or more
webquery · string- 1 = only funders with a website on file.
One of: 1
ftvquery · string- 2 = ftype uses the current list, where private means not corporate.
One of: 2
corpquery · string- Older form of ftype=corporate: only corporate (company-sponsored) foundations.
One of: 1
sortquery · string- fit = best Fit first; relevance = the app's order.
One of: fit, relevance · Default: fit
pagequery · integer- Page number, from 1.
Default: 1 · 1 or more
per_pagequery · integer- Results per page, 1 to 25. Results stop at 200, so page × per_page can't go past 200.
Default: 25 · 1 to 25
curl "https://api.grantlas.com/v1/orgs/org_3f9a1c0e7b2d4a61/funders" \
-H "Authorization: Bearer $GRANTLAS_API_KEY"{
"data": [
{
"id": 90211,
"name": "Rocky Mountain Family Trust",
"state": "CO",
"assets": 48000000,
"grant_size_band": "10k-50k",
"giving_areas": [
"human-services",
"health"
],
"funder_type": "private",
"corporate": null,
"accepts_unsolicited": true,
"gives_to_individuals_only": false,
"fit": {
"status": "scored",
"score": 88,
"label": "Great",
"stale": false,
"reason": "Funds food security and nutrition programs along Colorado's Front Range, where you work."
},
"saved": false,
"tracked": true,
"url": "https://grantlas.com/funder/90211"
}
],
"page": 1,
"per_page": 25,
"total": 38,
"total_matching": 38,
"total_pages": 2,
"sort_applied": "fit"
}accepts_unsolicited means the funder accepts unsolicited applications from organizations; a funder that takes them only from individuals (such as scholarships) has accepts_unsolicited false and gives_to_individuals_only true. accepts_unsolicited is null when the funder's tax form doesn't say: public charities and community foundations file a Form 990, which has no such question — check the funder's website. funder_type says what kind of funder it is: private, community, public, federation or charity. corporate is true for a corporate (company-sponsored) foundation, such as the Walmart Foundation; it is found from the foundation's name, so many are missed, and null never means a funder is not corporate. Grant results can take a few seconds while Grantlas analyzes them (up to about 15); only the page you ask for is analyzed. Funder results have their fit right away. Results stop at 200: total counts up to that, and total_matching is the real number of matches. sort_applied says which order you got. fit_within_page means the organization's first full analysis of grants isn't finished yet, so results are in relevance order with each page sorted by fit, and sort_note says so. Because new grants get analyzed as you page, the Fit order can shift slightly between pages: de-duplicate by id. Filter names you don't recognize from this list are ignored, as in the app. tracked is true while the record is on the organization's Tracker. An archived Tracker item reads false; tracking it again (POST /v1/orgs/{org}/tracker) restores it, in the stage it had. fit.status is scored (with score 0 to 100, label Great, Good, Okay, Weak or Very weak, and a one-sentence reason), or not_scored. A grant can also be still_scoring (ask again in a minute) or unavailable (the account is out of Grantlas AI credits, or analysis is paused for the day). A funder's fit is always current: it is worked out from the funder's giving record and needs no analysis. fit.stale is true when a grant's fit is from before the organization's last profile change.
A funderGET /v1/orgs/{org}/funders/{id}
One funder's full profile, with Fit and red flags for this organization.
Parameters
orgpath · string · required- An organization id from GET /v1/orgs, like org_3f9a1c0e7b2d4a61.
idpath · integer · required- The funder's Grantlas id (in every funder result).
1 or more
curl "https://api.grantlas.com/v1/orgs/org_3f9a1c0e7b2d4a61/funders/90211" \
-H "Authorization: Bearer $GRANTLAS_API_KEY"{
"data": {
"id": 90211,
"ein": "84-1234567",
"name": "Rocky Mountain Family Trust",
"city": "Denver",
"state": "CO",
"based_in": "Denver, CO",
"where_it_gives": {
"summary": "Colorado 92%, Wyoming 6%, New Mexico 3% (of 72 grants on file, 2022–2024)",
"states": [
{
"state": "CO",
"name": "Colorado",
"grants": 66,
"share": 0.917
},
{
"state": "WY",
"name": "Wyoming",
"grants": 4,
"share": 0.056
},
{
"state": "NM",
"name": "New Mexico",
"grants": 2,
"share": 0.028
}
],
"other_states": null,
"state_count": 3,
"grants_with_location": 72,
"grants_on_file": 72,
"years": {
"from": 2022,
"to": 2024
},
"nationwide": false
},
"assets": 48000000,
"grant_size_band": "10k-50k",
"funder_type": "private",
"corporate": null,
"accepts_unsolicited": true,
"gives_to_individuals_only": false,
"holds_donor_advised_funds": null,
"website": "https://rockymountainfamilytrust.org",
"mission": null,
"description": "A family foundation supporting food security, health and youth programs along Colorado's Front Range.",
"giving_areas": [
"human-services",
"health"
],
"application_info": "Send a two-page letter of inquiry by email. Full proposals are by invitation after the letter is reviewed.",
"submission_deadlines": "March 1 and September 1",
"award_restrictions": "No grants to individuals or for capital campaigns.",
"officers": [
{
"name": "Margaret Ellison",
"title": "Executive Director"
}
],
"year_founded": 1987,
"ntee_code": "T20",
"metrics": {
"median_grant": 30000,
"low_grant": 5000,
"high_grant": 150000,
"grants_per_year": 24,
"trend_3yr": 1.11,
"geo_concentration": 0.92,
"new_grantee_rate": 0.27
},
"giving_by_year": [
{
"year": 2024,
"total": 840000,
"count": 22
},
{
"year": 2023,
"total": 790000,
"count": 24
},
{
"year": 2022,
"total": 760000,
"count": 26
}
],
"fit": {
"status": "scored",
"score": 88,
"label": "Great",
"stale": false,
"reason": "Funds food security and nutrition programs along Colorado's Front Range, where you work."
},
"red_flags": [],
"saved": false,
"tracked": true,
"hidden": false,
"url": "https://grantlas.com/funder/90211"
}
}accepts_unsolicited means the funder accepts unsolicited applications from organizations; a funder that takes them only from individuals (such as scholarships) has accepts_unsolicited false and gives_to_individuals_only true. accepts_unsolicited is null when the funder's tax form doesn't say: public charities and community foundations file a Form 990, which has no such question — check the funder's website. funder_type says what kind of funder it is: private, community, public, federation or charity. corporate is true for a corporate (company-sponsored) foundation, such as the Walmart Foundation; it is found from the foundation's name, so many are missed, and null never means a funder is not corporate. metrics is null when Grantlas has no giving data for the funder. giving_by_year is newest first. city and state are the funder's office address (based_in), not where it gives. where_it_gives is where its grants went, from the recipient states on every grant on file: summary in words, the largest shares in states (share of grants with a location, by count), the rest in other_states, and nationwide when they went to 20 or more states. states is empty when no grant on file has a location. red_flags lists plain warnings such as "Invitation only" or "Giving sharply declining", and is empty when there are none. A grant is analyzed now if needed, using your account's Grantlas AI credits, which can take a few seconds. Records the organization hasn't saved or tracked (archived Tracker items count as tracked here) count toward the limit of 1,000 lookups a day per account. tracked is true while the record is on the organization's Tracker. An archived Tracker item reads false; tracking it again (POST /v1/orgs/{org}/tracker) restores it, in the stage it had. fit.status is scored (with score 0 to 100, label Great, Good, Okay, Weak or Very weak, and a one-sentence reason), or not_scored. A grant can also be still_scoring (ask again in a minute) or unavailable (the account is out of Grantlas AI credits, or analysis is paused for the day). A funder's fit is always current: it is worked out from the funder's giving record and needs no analysis. fit.stale is true when a grant's fit is from before the organization's last profile change.
Grants
Search grantsGET /v1/orgs/{org}/grants
Grant opportunities matching the filters, best Fit for this organization first. The organization's exclusions are applied.
Parameters
orgpath · string · required- An organization id from GET /v1/orgs, like org_3f9a1c0e7b2d4a61.
listing_typequery · string- dated_grant: grants with a status and deadline. foundation_request: foundations whose IRS filing says they accept grant requests (not open calls; no deadline).
One of: dated_grant, foundation_request · Default: dated_grant
anywherequery · boolean- foundation_request only: true lists every state instead of the organization's own.
gives_inquery · string- foundation_request only: two-letter states, comma-separated: gives in any of them (their filing's stated area or past grants).
based_inquery · string- foundation_request only: two-letter states, comma-separated: based in any of them.
cityquery · string- foundation_request only: cities, comma-separated: based in any of them.
focus_areaquery · string- foundation_request only: a cause area the foundation gives to.
One of: arts, education, environment, health, human-services, international, public-society-benefit, religion, other
fit_minquery · string- foundation_request only: only foundations already analyzed at Good or better, or Great.
One of: good, great
typical_grant_minquery · integer- foundation_request only: median grant at least this, dollars.
0 or more
typical_grant_maxquery · integer- foundation_request only: median grant at most this, dollars.
0 or more
giving_minquery · integer- foundation_request only: yearly giving at least this, dollars.
0 or more
giving_maxquery · integer- foundation_request only: yearly giving at most this, dollars.
0 or more
assets_minquery · integer- foundation_request only: assets at least this, dollars.
0 or more
assets_maxquery · integer- foundation_request only: assets at most this, dollars.
0 or more
cyclequery · string- foundation_request only: year-round (rolling), a stated cycle (dates), or not stated.
One of: rolling, dates, unstated
cycle_monthquery · string- foundation_request only: months 1-12, comma-separated: the filing's cycle names any of them.
has_websitequery · boolean- foundation_request only: true = only foundations with a website on file.
corporate_onlyquery · boolean- foundation_request only: true = only corporate (company-sponsored) foundations. Found by name, so many are missed.
keywordquery · string- Words in the title or description.
agencyquery · string- Government agency name, as the source names it.
statusquery · string- open, forecasted (not open yet; deadline is the expected close date) or closed. Every status when left out.
One of: open, forecasted, closed
sourcequery · string- federal (grants.gov), california (grants.ca.gov) or funder_site (funder websites; available once published, until then it returns nothing). When left out: everything available to the organization (federal, its own added links, funder websites once published), with California grants only for an organization in California.
One of: federal, california, funder_site
eligibilityTypequery · string- Who can apply (federal grants only): nonprofit, government, education, individual or other.
One of: nonprofit, government, education, individual, other
minFundingquery · integer- Minimum award, dollars.
0 or more
maxFundingquery · integer- Maximum award, dollars.
0 or more
deadlineFromquery · string- Deadline on or after, YYYY-MM-DD.
deadlineToquery · string- Deadline on or before, YYYY-MM-DD.
sortquery · string- fit = best Fit first; relevance = the app's order; deadline = upcoming deadlines, soonest first; grants with no deadline or a past deadline are left out.
One of: fit, relevance, deadline · Default: fit
pagequery · integer- Page number, from 1.
Default: 1 · 1 or more
per_pagequery · integer- Results per page, 1 to 25. Results stop at 200, so page × per_page can't go past 200.
Default: 25 · 1 to 25
curl "https://api.grantlas.com/v1/orgs/org_3f9a1c0e7b2d4a61/grants" \
-H "Authorization: Bearer $GRANTLAS_API_KEY"{
"data": [
{
"id": 55120,
"listing_type": "dated_grant",
"title": "Community Food Security Innovation Grants",
"agency": "Health Resources and Services Administration",
"status": "open",
"source": "federal",
"source_url": "https://www.grants.gov/search-results-detail/355120",
"funding_min": 50000,
"funding_max": 250000,
"deadline": "2026-11-13",
"fit": {
"status": "scored",
"score": 81,
"label": "Good",
"stale": false,
"reason": "Supports community food access programs like your pantry network, at an award size you can manage."
},
"saved": true,
"tracked": false,
"url": "https://grantlas.com/grant/55120"
}
],
"page": 1,
"per_page": 25,
"total": 12,
"total_matching": 12,
"total_pages": 1,
"sort_applied": "fit"
}For a forecasted grant, deadline is the expected close date; expected_deadline repeats it. expected_opening: for a forecasted grant whose funder named only a season or year, when it is expected to open, in the funder's words ("early 2027", "fall 2026"); never a date, and deadline stays null. sort=deadline leaves out grants with no deadline or a past deadline, which lowers total_matching. Every item has listing_type. listing_type=foundation_request lists foundations whose IRS filing says they accept grant requests instead: they are not open calls, status is accepts_requests, deadline is always null, application_cycle says when in words (kind rolling, dates or unstated; label; filed_text, the filer's own words; tax_year), id and funder_id are the funder's id and url is its funder page. By default only foundations based in or giving in the organization's state (anywhere=true for all). With it only keyword and the parameters marked foundation_request apply, and sort is fit or relevance. Grant results can take a few seconds while Grantlas analyzes them (up to about 15); only the page you ask for is analyzed. Funder results have their fit right away. Results stop at 200: total counts up to that, and total_matching is the real number of matches. sort_applied says which order you got. fit_within_page means the organization's first full analysis of grants isn't finished yet, so results are in relevance order with each page sorted by fit, and sort_note says so. Because new grants get analyzed as you page, the Fit order can shift slightly between pages: de-duplicate by id. Filter names you don't recognize from this list are ignored, as in the app. tracked is true while the record is on the organization's Tracker. An archived Tracker item reads false; tracking it again (POST /v1/orgs/{org}/tracker) restores it, in the stage it had. fit.status is scored (with score 0 to 100, label Great, Good, Okay, Weak or Very weak, and a one-sentence reason), or not_scored. A grant can also be still_scoring (ask again in a minute) or unavailable (the account is out of Grantlas AI credits, or analysis is paused for the day). A funder's fit is always current: it is worked out from the funder's giving record and needs no analysis. fit.stale is true when a grant's fit is from before the organization's last profile change.
A grantGET /v1/orgs/{org}/grants/{id}
One grant in full, with Fit and an eligibility check for this organization.
Parameters
orgpath · string · required- An organization id from GET /v1/orgs, like org_3f9a1c0e7b2d4a61.
idpath · integer · required- The grant's Grantlas id.
1 or more
curl "https://api.grantlas.com/v1/orgs/org_3f9a1c0e7b2d4a61/grants/90211" \
-H "Authorization: Bearer $GRANTLAS_API_KEY"{
"data": {
"id": 55120,
"title": "Community Food Security Innovation Grants",
"agency": "Health Resources and Services Administration",
"status": "open",
"source": "federal",
"source_url": "https://www.grants.gov/search-results-detail/355120",
"opportunity_number": "HRSA-27-041",
"funding_min": 50000,
"funding_max": 250000,
"deadline": "2026-11-13",
"posted": "2026-09-19",
"eligible_applicants": [
"Nonprofits with 501(c)(3) status"
],
"eligibility_text": "Nonprofit organizations with 501(c)(3) status that run community food programs.",
"description": "Supports community organizations expanding emergency food access and nutrition education in underserved areas.",
"fit": {
"status": "scored",
"score": 81,
"label": "Good",
"stale": false,
"reason": "Supports community food access programs like your pantry network, at an award size you can manage."
},
"eligibility": {
"verdict": "yes",
"stale": false,
"reasoning": "You're a 501(c)(3) running a food pantry network, which is who this grant is for.",
"requirement": "501(c)(3) nonprofit with community food programs"
},
"saved": true,
"tracked": false,
"url": "https://grantlas.com/grant/55120"
}
}For a forecasted grant, deadline is the expected close date; expected_deadline repeats it. expected_opening: for a forecasted grant whose funder named only a season or year, when it is expected to open, in the funder's words ("early 2027", "fall 2026"); never a date, and deadline stays null. eligibility is null until the grant has been checked for this organization. Its verdict is yes, no or unclear, with the reasoning and, when there is one, the requirement it turns on. A grant is analyzed now if needed, using your account's Grantlas AI credits, which can take a few seconds. Records the organization hasn't saved or tracked (archived Tracker items count as tracked here) count toward the limit of 1,000 lookups a day per account. tracked is true while the record is on the organization's Tracker. An archived Tracker item reads false; tracking it again (POST /v1/orgs/{org}/tracker) restores it, in the stage it had. fit.status is scored (with score 0 to 100, label Great, Good, Okay, Weak or Very weak, and a one-sentence reason), or not_scored. A grant can also be still_scoring (ask again in a minute) or unavailable (the account is out of Grantlas AI credits, or analysis is paused for the day). A funder's fit is always current: it is worked out from the funder's giving record and needs no analysis. fit.stale is true when a grant's fit is from before the organization's last profile change.
Grantlas API guide · Google Sheets recipe · Zapier and Make recipe