Grantlas API guide

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, like 2026-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 carry fields: each of your own fields by name, null when empty. The Tracker and saved lists take ?tag=Capital campaign to keep only items with that tag.
  • Organizations, Tracker items, tasks, notes and saved searches have ids like org_3f9a1c0e7b2d4a61, trk_8c2e5b17d94f0a3c, tsk_4b7d2e9a1c0f6e35, ntn_7c1e5a9b3d2f8046 and srch_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 }, where error is one of the codes below and message is 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-sentence reason.
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

Read

The account (its plan is pro, agency or trial) and key you're using, and the limits that apply.

Example request
curl "https://api.grantlas.com/v1/me" \
  -H "Authorization: Bearer $GRANTLAS_API_KEY"
Example response · 200 OK
{
  "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

Read

Your organizations (a consultant's clients). The /v1/orgs/{org}/… endpoints need one of these ids.

Example request
curl "https://api.grantlas.com/v1/orgs" \
  -H "Authorization: Bearer $GRANTLAS_API_KEY"
Example response · 200 OK
{
  "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

Read

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

Example request
curl "https://api.grantlas.com/v1/orgs/org_3f9a1c0e7b2d4a61/tracker" \
  -H "Authorization: Bearer $GRANTLAS_API_KEY"
Example response · 200 OK
{
  "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

Read

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

Example request
curl "https://api.grantlas.com/v1/tracker" \
  -H "Authorization: Bearer $GRANTLAS_API_KEY"
Example response · 200 OK
{
  "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

Read & Write

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).
Example request
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}'
Example response · 201 Created
{
  "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"
  }
}
Example request · past grant
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."}'
Example response · past grant · 201 Created
{
  "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}

Read & Write

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.
Example request
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}'
Example response · 200 OK
{
  "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}

Read & Write

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.
Example request
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

Read

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.
Example request
curl "https://api.grantlas.com/v1/orgs/org_3f9a1c0e7b2d4a61/tracker/trk_8c2e5b17d94f0a3c/notes" \
  -H "Authorization: Bearer $GRANTLAS_API_KEY"
Example response · 200 OK
{
  "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

Read & Write

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.
Example request
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."}'
Example response · 201 Created
{
  "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}

Read & Write

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.
Example request
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."}'
Example response · 200 OK
{
  "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}

Read & Write

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.
Example request
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

Read

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.
Example request
curl "https://api.grantlas.com/v1/orgs/org_3f9a1c0e7b2d4a61/tracker/trk_8c2e5b17d94f0a3c/application" \
  -H "Authorization: Bearer $GRANTLAS_API_KEY"
Example response · 200 OK
{
  "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

Read & Write

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".
Example request
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)"}'
Example response · 201 Created
{
  "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

Read & Write

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

Example request
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}'
Example response · 200 OK
{
  "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}

Read & Write

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

Example request
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}'
Example response · 200 OK
{
  "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

Read

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

Example request
curl "https://api.grantlas.com/v1/orgs/org_3f9a1c0e7b2d4a61/tracker/trk_8c2e5b17d94f0a3c/events" \
  -H "Authorization: Bearer $GRANTLAS_API_KEY"
Example response · 200 OK
{
  "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

Read

The account's Tracker stages, in order. Every organization in the account shares them.

Example request
curl "https://api.grantlas.com/v1/stages" \
  -H "Authorization: Bearer $GRANTLAS_API_KEY"
Example response · 200 OK
{
  "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

Read

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.
Example request
curl "https://api.grantlas.com/v1/orgs/org_3f9a1c0e7b2d4a61/tracker/trk_8c2e5b17d94f0a3c/tasks" \
  -H "Authorization: Bearer $GRANTLAS_API_KEY"
Example response · 200 OK
{
  "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

Read & Write

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.
Example request
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"}'
Example response · 201 Created
{
  "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"
  }
}
Example request · report deadlines that repeat
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}'
Example response · report deadlines that repeat · 201 Created
{
  "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}

Read & Write

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

Example request
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"}'
Example response · 200 OK
{
  "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}

Read & Write

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.
Example request
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

Read

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

Example request
curl "https://api.grantlas.com/v1/orgs/org_3f9a1c0e7b2d4a61/answers" \
  -H "Authorization: Bearer $GRANTLAS_API_KEY"
Example response · 200 OK
{
  "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

Read & Write

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.
Example request
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."}'
Example response · 201 Created
{
  "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

Read

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

Example request
curl "https://api.grantlas.com/v1/orgs/org_3f9a1c0e7b2d4a61/saved" \
  -H "Authorization: Bearer $GRANTLAS_API_KEY"
Example response · 200 OK
{
  "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

Read

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

Example request
curl "https://api.grantlas.com/v1/orgs/org_3f9a1c0e7b2d4a61/deadlines" \
  -H "Authorization: Bearer $GRANTLAS_API_KEY"
Example response · 200 OK
{
  "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

Read

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

Example request
curl "https://api.grantlas.com/v1/deadlines" \
  -H "Authorization: Bearer $GRANTLAS_API_KEY"
Example response · 200 OK
{
  "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

Read

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.
Example request
curl "https://api.grantlas.com/v1/orgs/org_3f9a1c0e7b2d4a61/performance" \
  -H "Authorization: Bearer $GRANTLAS_API_KEY"
Example response · 200 OK
{
  "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

Read

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.
Example request
curl "https://api.grantlas.com/v1/orgs/org_3f9a1c0e7b2d4a61/files" \
  -H "Authorization: Bearer $GRANTLAS_API_KEY"
Example response · 200 OK
{
  "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

Read

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.
Example request
curl "https://api.grantlas.com/v1/orgs/org_3f9a1c0e7b2d4a61/files/1/text" \
  -H "Authorization: Bearer $GRANTLAS_API_KEY"
Example response · 200 OK
{
  "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

Read

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.
Example request
curl "https://api.grantlas.com/v1/orgs/org_3f9a1c0e7b2d4a61/report" \
  -H "Authorization: Bearer $GRANTLAS_API_KEY"
Example response · 200 OK
{
  "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

Read

The organization's saved searches, newest first.

Parameters

orgpath · string · required
An organization id from GET /v1/orgs, like org_3f9a1c0e7b2d4a61.
Example request
curl "https://api.grantlas.com/v1/orgs/org_3f9a1c0e7b2d4a61/saved-searches" \
  -H "Authorization: Bearer $GRANTLAS_API_KEY"
Example response · 200 OK
{
  "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

Read

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

Example request
curl "https://api.grantlas.com/v1/orgs/org_3f9a1c0e7b2d4a61/saved-searches/srch_51d7a0c9e3b86f24/matches" \
  -H "Authorization: Bearer $GRANTLAS_API_KEY"
Example response · 200 OK
{
  "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

Read

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

Example request
curl "https://api.grantlas.com/v1/orgs/org_3f9a1c0e7b2d4a61/funders" \
  -H "Authorization: Bearer $GRANTLAS_API_KEY"
Example response · 200 OK
{
  "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}

Read

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

Example request
curl "https://api.grantlas.com/v1/orgs/org_3f9a1c0e7b2d4a61/funders/90211" \
  -H "Authorization: Bearer $GRANTLAS_API_KEY"
Example response · 200 OK
{
  "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

Read

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

Example request
curl "https://api.grantlas.com/v1/orgs/org_3f9a1c0e7b2d4a61/grants" \
  -H "Authorization: Bearer $GRANTLAS_API_KEY"
Example response · 200 OK
{
  "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}

Read

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

Example request
curl "https://api.grantlas.com/v1/orgs/org_3f9a1c0e7b2d4a61/grants/90211" \
  -H "Authorization: Bearer $GRANTLAS_API_KEY"
Example response · 200 OK
{
  "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