GrantLink Public API

Example request

curl --request GET \
+  --url 'https://api.grantlink.app/v1/organization' \
+  --header 'Accept: application/json' \
+  --header 'Authorization: Bearer <oauth-access-token>'

Safe settings for the organization selected only by the verified bearer token.

{
  "id": "org_A4n8wQ2mL6pR",
  "name": "Example Youth Services",
  "slug": "example-youth-services",
  "fiscalYearStartMonth": 7,
  "timezone": "America/New_York",
  "accountingCurrency": "USD",
  "createdAt": "2025-11-02T14:20:00Z"
}

Example request

curl --request GET \
+  --url 'https://api.grantlink.app/v1/accounting-status' \
+  --header 'Accept: application/json' \
+  --header 'Authorization: Bearer <oauth-access-token>'

Coarse QuickBooks Online availability and freshness with no realm, token, job, connection, or provider IDs.

{
  "provider": "quickbooks_online",
  "status": "connected",
  "sourceDataAsOf": "2026-09-01T13:45:22Z",
  "lastSuccessfulSyncAt": "2026-09-01T13:45:30Z",
  "warnings": []
}

Example request

curl --request GET \
+  --url 'https://api.grantlink.app/v1/grants?limit=25&archiveState=active&sort=-createdAt' \
+  --header 'Accept: application/json' \
+  --header 'Authorization: Bearer <oauth-access-token>'

Parameters

Bounded collection document. A page may end before its item limit when the response byte/read budget is reached.

{
  "items": [
    {
      "id": "grt_q7Y2nD8kL5mP",
      "name": "2026 Youth Education Award",
      "grantNumber": "EDU-2026-17",
      "internalCode": "YEA-26",
      "type": "with_donor_restrictions_time_purpose",
      "status": "active",
      "awardAmount": {
        "amount": "125000.00",
        "currency": "USD"
      },
      "period": {
        "startDate": "2026-07-01",
        "endDate": "2027-06-30"
      },
      "funder": {
        "id": "fnd_M3p8vR2xQ9cN",
        "name": "Example Community Foundation"
      },
      "createdAt": "2026-05-14T17:32:08Z",
      "updatedAt": "2026-08-29T20:14:11Z",
      "archivedAt": null
    }
  ],
  "page": {
    "limit": 25,
    "hasMore": false,
    "nextCursor": null
  },
  "links": {
    "self": "https://api.grantlink.app/v1/grants?status=active&limit=25",
    "next": null
  }
}

Example request

curl --request GET \
+  --url 'https://api.grantlink.app/v1/grants/{grantId}' \
+  --header 'Accept: application/json' \
+  --header 'Authorization: Bearer <oauth-access-token>'

Parameters

Complete safe grant settings with compact relationships and no provider, actor, password, or import fields.

{
  "id": "grt_q7Y2nD8kL5mP",
  "name": "2026 Youth Education Award",
  "grantNumber": "EDU-2026-17",
  "internalCode": "YEA-26",
  "type": "with_donor_restrictions_time_purpose",
  "status": "active",
  "awardAmount": {
    "amount": "125000.00",
    "currency": "USD"
  },
  "period": {
    "startDate": "2026-07-01",
    "endDate": "2027-06-30"
  },
  "funder": {
    "id": "fnd_M3p8vR2xQ9cN",
    "name": "Example Community Foundation"
  },
  "createdAt": "2026-05-14T17:32:08Z",
  "updatedAt": "2026-08-29T20:14:11Z",
  "archivedAt": null,
  "description": "Supports after-school learning and family engagement.",
  "match": {
    "requiredAmount": null,
    "ratio": null
  },
  "expenseEligibility": {
    "notBefore": "2026-07-01",
    "notAfter": "2027-06-30"
  },
  "indirectCost": {
    "ratePercent": 10,
    "base": "mtdc",
    "capAmount": null
  },
  "reporting": {
    "cadence": "quarterly",
    "quarterScheme": "grant",
    "dayOffset": 30,
    "finalReportDueDate": "2027-07-30"
  },
  "federalAward": {
    "assistanceListingNumber": null,
    "federalAwardId": null,
    "fundingSource": "private",
    "passThroughEntityName": null,
    "passThroughEntityId": null
  },
  "fundReceiptStatus": "partial",
  "awardedAt": "2026-05-14T17:32:08Z",
  "awardNotificationDate": "2026-05-14",
  "activatedAt": "2026-07-01T00:00:00Z",
  "closeoutStartedAt": null,
  "closeoutDeadline": null,
  "closedAt": null,
  "declinedAt": null,
  "withdrawnAt": null,
  "initiatives": [
    {
      "id": "ini_T4w9bK6sH2jF",
      "name": "Youth Education",
      "code": "YOUTH-ED",
      "designatedAmount": {
        "amount": "100000.00",
        "currency": "USD"
      },
      "designatedPercentage": 80,
      "primary": true,
      "status": "active"
    }
  ]
}

Example request

curl --request GET \
+  --url 'https://api.grantlink.app/v1/grants/{grantId}/financial-position' \
+  --header 'Accept: application/json' \
+  --header 'Authorization: Bearer <oauth-access-token>'

Parameters

Canonical award, receipt, recorded-spend, coverage, and restriction position. receivedCashLessRecordedSpendAmount is funding coverage, not a bank balance; recorded spend can include unpaid bills and journal entries.

{
  "grant": {
    "id": "grt_q7Y2nD8kL5mP",
    "name": "2026 Youth Education Award"
  },
  "currency": "USD",
  "sourceDataAsOf": "2026-09-01T13:45:22Z",
  "warnings": [],
  "awardedAmount": {
    "amount": "125000.00",
    "currency": "USD"
  },
  "receivedCashAmount": {
    "amount": "75000.00",
    "currency": "USD"
  },
  "recordedSpend": {
    "totalAmount": {
      "amount": "62150.43",
      "currency": "USD"
    },
    "directAmount": {
      "amount": "57300.43",
      "currency": "USD"
    },
    "indirectAmount": {
      "amount": "4850.00",
      "currency": "USD"
    }
  },
  "remainingAwardAmount": {
    "amount": "62849.57",
    "currency": "USD"
  },
  "receivedCashLessRecordedSpendAmount": {
    "amount": "12849.57",
    "currency": "USD"
  },
  "restriction": {
    "kind": "time_or_purpose",
    "restrictedAwardRemainingAmount": {
      "amount": "62849.57",
      "currency": "USD"
    },
    "restrictedReceivedLessSpendAmount": {
      "amount": "12849.57",
      "currency": "USD"
    }
  }
}

Example request

curl --request GET \
+  --url 'https://api.grantlink.app/v1/grants/{grantId}/transactions?limit=50&sort=-accountingDate' \
+  --header 'Accept: application/json' \
+  --header 'Authorization: Bearer <oauth-access-token>'

Parameters

Bounded effective assignments with accounting-source freshness and safe warnings.

{
  "grant": {
    "id": "grt_q7Y2nD8kL5mP",
    "name": "2026 Youth Education Award"
  },
  "sourceDataAsOf": "2026-09-01T13:45:22Z",
  "warnings": [],
  "items": [
    {
      "id": "txn_P9r2mX7cV4kL",
      "grant": {
        "id": "grt_q7Y2nD8kL5mP",
        "name": "2026 Youth Education Award"
      },
      "accountingDate": "2026-08-28",
      "sourceType": "bill",
      "reference": "BILL-1048",
      "counterparty": "Example Learning Supplies",
      "memo": "Fall program materials",
      "amount": {
        "amount": "1840.25",
        "currency": "USD"
      },
      "costType": "direct",
      "initiative": {
        "id": "ini_T4w9bK6sH2jF",
        "name": "Youth Education"
      },
      "budgetCategory": {
        "id": "bct_C5n8sQ3aD7eR",
        "name": "Program Supplies",
        "code": "SUP"
      },
      "budgetLine": {
        "id": "bln_A6f1uJ8zN3hW",
        "name": "Learning Materials"
      }
    }
  ],
  "page": {
    "limit": 50,
    "hasMore": false,
    "nextCursor": null
  },
  "links": {
    "self": "https://api.grantlink.app/v1/grants/grt_q7Y2nD8kL5mP/transactions?limit=50",
    "next": null
  }
}

Example request

curl --request GET \
+  --url 'https://api.grantlink.app/v1/funders?limit=25&archiveState=active&sort=-createdAt' \
+  --header 'Accept: application/json' \
+  --header 'Authorization: Bearer <oauth-access-token>'

Parameters

Bounded collection document. A page may end before its item limit when the response byte/read budget is reached.

{
  "items": [
    {
      "id": "fnd_M3p8vR2xQ9cN",
      "name": "Example Community Foundation",
      "shortName": "ECF",
      "type": "foundation",
      "createdAt": "2026-01-05T12:00:00Z",
      "updatedAt": "2026-08-20T15:10:00Z",
      "archivedAt": null
    }
  ],
  "page": {
    "limit": 25,
    "hasMore": false,
    "nextCursor": null
  },
  "links": {
    "self": "https://api.grantlink.app/v1/funders?limit=25",
    "next": null
  }
}

Example request

curl --request GET \
+  --url 'https://api.grantlink.app/v1/funders/{funderId}' \
+  --header 'Accept: application/json' \
+  --header 'Authorization: Bearer <oauth-access-token>'

Parameters

Complete public funder details. Contact name, email, and phone are intentionally excluded in v1.0.

{
  "id": "fnd_M3p8vR2xQ9cN",
  "name": "Example Community Foundation",
  "shortName": "ECF",
  "type": "foundation",
  "description": "A regional community foundation.",
  "website": "https://example.org",
  "createdAt": "2026-01-05T12:00:00Z",
  "updatedAt": "2026-08-20T15:10:00Z",
  "archivedAt": null
}

Example request

curl --request GET \
+  --url 'https://api.grantlink.app/v1/initiatives?limit=25&archiveState=active&sort=-createdAt' \
+  --header 'Accept: application/json' \
+  --header 'Authorization: Bearer <oauth-access-token>'

Parameters

Bounded collection document. A page may end before its item limit when the response byte/read budget is reached.

{
  "items": [
    {
      "id": "ini_T4w9bK6sH2jF",
      "name": "Youth Education",
      "code": "YOUTH-ED",
      "functionalCategory": "program_services",
      "status": "active",
      "period": {
        "startDate": null,
        "endDate": null
      },
      "targetAmount": {
        "amount": "200000.00",
        "currency": "USD"
      },
      "restrictionType": "purpose",
      "parent": null,
      "createdAt": "2026-01-10T09:00:00Z",
      "updatedAt": "2026-08-18T11:30:00Z",
      "archivedAt": null
    }
  ],
  "page": {
    "limit": 25,
    "hasMore": false,
    "nextCursor": null
  },
  "links": {
    "self": "https://api.grantlink.app/v1/initiatives?limit=25",
    "next": null
  }
}

Example request

curl --request GET \
+  --url 'https://api.grantlink.app/v1/initiatives/{initiativeId}' \
+  --header 'Accept: application/json' \
+  --header 'Authorization: Bearer <oauth-access-token>'

Parameters

Complete initiative details with internal display and provider-link fields excluded.

{
  "id": "ini_T4w9bK6sH2jF",
  "name": "Youth Education",
  "code": "YOUTH-ED",
  "functionalCategory": "program_services",
  "status": "active",
  "period": {
    "startDate": null,
    "endDate": null
  },
  "targetAmount": {
    "amount": "200000.00",
    "currency": "USD"
  },
  "restrictionType": "purpose",
  "parent": null,
  "description": "Education services for local youth.",
  "createdAt": "2026-01-10T09:00:00Z",
  "updatedAt": "2026-08-18T11:30:00Z",
  "archivedAt": null
}

Example request

curl --request GET \
+  --url 'https://api.grantlink.app/v1/reporting-cycles?limit=25&sort=dueDate' \
+  --header 'Accept: application/json' \
+  --header 'Authorization: Bearer <oauth-access-token>'

Parameters

Bounded collection document. A page may end before its item limit when the response byte/read budget is reached.

{
  "items": [
    {
      "id": "rcy_R8k2vN5mQ7xC",
      "grant": {
        "id": "grt_q7Y2nD8kL5mP",
        "name": "2026 Youth Education Award"
      },
      "period": {
        "startDate": "2026-07-01",
        "endDate": "2026-09-30"
      },
      "dueDate": "2026-10-30",
      "type": "interim",
      "customLabel": null,
      "status": "upcoming",
      "submittedAt": null
    }
  ],
  "page": {
    "limit": 25,
    "hasMore": false,
    "nextCursor": null
  },
  "links": {
    "self": "https://api.grantlink.app/v1/reporting-cycles?limit=25",
    "next": null
  }
}

Example request

curl --request GET \
+  --url 'https://api.grantlink.app/v1/reporting-cycles/{reportingCycleId}' \
+  --header 'Accept: application/json' \
+  --header 'Authorization: Bearer <oauth-access-token>'

Parameters

A reporting deadline and workflow state without internal notes, reminders, feedback, or actor data.

{
  "id": "rcy_R8k2vN5mQ7xC",
  "grant": {
    "id": "grt_q7Y2nD8kL5mP",
    "name": "2026 Youth Education Award"
  },
  "period": {
    "startDate": "2026-07-01",
    "endDate": "2026-09-30"
  },
  "dueDate": "2026-10-30",
  "type": "interim",
  "customLabel": null,
  "status": "upcoming",
  "submittedAt": null
}