Grant Applications

The Grant Applications API allows you to retrieve grant applications submitted to your organisation's funding programmes. This includes application details, status, financial information, and monitoring data.

List Grant Applications

Retrieve a paginated list of grant applications with optional filtering.

Endpoint

GET /api/v1/grant-applications

Query Parameters

Pagination:

• limit (number, default: 100, max: 250) - Maximum number of applications to return
• offset (number, default: 0) - Number of applications to skip for pagination

Filtering:

• fundId (string) - Filter by fund ID
• status (string) - Filter by application status:
  • pending - Awaiting review
  • applied - Application submitted
  • in_review - Currently being reviewed
  • reviewed - Review complete
  • recommended - Recommended for approval
  • rejected - Application rejected
  • approved - Grant approved
  • fully_paid - All payments disbursed
  • completed - Grant completed
• granteeId (string) - Filter by grantee ID
• recipientOrgId (string) - Filter by recipient organisation ID

Response

{
  "applications": [
    {
      "applicationId": "app_abc123",
      "fundId": "fund_xyz789",
      "granteeId": "grantee_456",
      "identifier": 42,
      "title": "Youth Digital Skills Programme",
      "description": "A 12-month programme to teach digital skills to young people",
      "currency": "GBP",
      "amountApplied": 25000,
      "amountAwarded": 22000,
      "amountDisbursed": 11000,
      "status": "approved",
      "managedBy": "org123",
      "recipient": {
        "organisationId": "recipient_org_001",
        "name": "Community Youth Trust",
        "email": "grants@communityyouth.org",
        "phone": "+44 20 7123 4567",
        "postcode": "E1 6AN",
        "type": "charity"
      },
      "dates": {
        "awarded": "2025-01-15T10:00:00.000Z",
        "submitted": "2024-12-01T14:30:00.000Z",
        "recommended": "2025-01-10T09:00:00.000Z",
        "rejected": null,
        "grantStart": "2025-02-01T00:00:00.000Z",
        "grantEnd": "2026-01-31T23:59:59.000Z",
        "plannedStart": "2025-02-01",
        "plannedEnd": "2026-01-31"
      },
      "durationMonths": 12,
      "summary": "Approved for delivery in East London area",
      "feedback": "Strong application with clear outcomes",
      "language": "en",
      "fromOpenCall": true,
      "external": {
        "id": "360G-123456",
        "source": "360Giving"
      },
      "created": "2024-12-01T14:30:00.000Z",
      "updated": "2025-01-15T10:30:00.000Z"
    }
  ],
  "offset": 0,
  "limit": 100,
  "total": 156
}

Example Requests

List all applications:

curl -X GET "https://app.plinth.org.uk/api/v1/grant-applications" \
  -H "x-api-key: sk_your_api_key"

Filter by fund:

curl -X GET "https://app.plinth.org.uk/api/v1/grant-applications?fundId=fund_xyz789" \
  -H "x-api-key: sk_your_api_key"

Filter by status:

curl -X GET "https://app.plinth.org.uk/api/v1/grant-applications?status=approved" \
  -H "x-api-key: sk_your_api_key"

Combine filters:

curl -X GET "https://app.plinth.org.uk/api/v1/grant-applications?fundId=fund_xyz789&status=in_review" \
  -H "x-api-key: sk_your_api_key"

Get Single Grant Application

Retrieve a specific application by ID with monitoring details.

Endpoint

GET /api/v1/grant-applications/:applicationId

Path Parameters

• applicationId (string, required) - The unique identifier of the application

Response

The single application response includes additional monitoring details:

{
  "application": {
    "applicationId": "app_abc123",
    "fundId": "fund_xyz789",
    "granteeId": "grantee_456",
    "identifier": 42,
    "title": "Youth Digital Skills Programme",
    "description": "A 12-month programme to teach digital skills to young people",
    "currency": "GBP",
    "amountApplied": 25000,
    "amountAwarded": 22000,
    "amountDisbursed": 11000,
    "status": "approved",
    "managedBy": "org123",
    "recipient": {
      "organisationId": "recipient_org_001",
      "name": "Community Youth Trust",
      "email": "grants@communityyouth.org",
      "phone": "+44 20 7123 4567",
      "postcode": "E1 6AN",
      "registeredId": "1234567",
      "registrationType": "Charity",
      "type": "charity",
      "address": "123 High Street, London",
      "country": "GB"
    },
    "dates": {
      "awarded": "2025-01-15T10:00:00.000Z",
      "submitted": "2024-12-01T14:30:00.000Z",
      "recommended": "2025-01-10T09:00:00.000Z",
      "rejected": null,
      "grantStart": "2025-02-01T00:00:00.000Z",
      "grantEnd": "2026-01-31T23:59:59.000Z",
      "plannedStart": "2025-02-01",
      "plannedEnd": "2026-01-31"
    },
    "durationMonths": 12,
    "summary": "Approved for delivery in East London area",
    "feedback": "Strong application with clear outcomes",
    "language": "en",
    "fromOpenCall": true,
    "external": {
      "id": "360G-123456",
      "source": "360Giving"
    },
    "monitoring": {
      "requests": [
        {
          "id": "mon_req_001",
          "deadline": "2025-08-01T23:59:59.000Z",
          "sendReminder": true,
          "emailReminderSentAt": "2025-07-25T09:00:00.000Z",
          "warningDays": 7,
          "monitoringFormId": "form_mon789",
          "submissions": [
            {
              "date": "2025-07-28T14:00:00.000Z",
              "interactionId": "interaction_001",
              "status": "submitted",
              "rejectionReason": null,
              "funderApproved": true,
              "funderApprovedAt": "2025-07-30T10:00:00.000Z"
            }
          ]
        }
      ],
      "latestSubmissionId": "interaction_001",
      "latestSubmissionDate": "2025-07-28T14:00:00.000Z"
    },
    "actions": {
      "approvedBy": "user_001",
      "rejectedBy": null,
      "recommendedBy": "user_002"
    },
    "created": "2024-12-01T14:30:00.000Z",
    "updated": "2025-01-15T10:30:00.000Z"
  }
}

Example Request

curl -X GET "https://app.plinth.org.uk/api/v1/grant-applications/app_abc123" \
  -H "x-api-key: sk_your_api_key"

Response Fields

Application Object

Recipient Object

Dates Object

Monitoring Object (Single Application)

Application Status Values

Error Responses