API Reference

Every call the GrantsHub API makes available. All endpoints require an X-API-Key header — get yours from your developer dashboard after registering.

/v1/match

Starter and above

Send an organisation profile, get ranked grant matches back with a fit score and reasons.

POST /v1/match
curl https://api.grantshub.co.uk/v1/match \
  -H "X-API-Key: sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "organisation_type": "charity",
    "sector": "Arts / Culture",
    "region": "Scotland",
    "description": "Community theatre charity seeking funding for a youth outreach programme.",
    "amount_needed": 15000,
    "top_n": 5
  }'

# → 200 OK
{
  "matches": [
    {
      "title": "Scottish Arts Community Fund",
      "funder": "Creative Scotland",
      "amount_min_gbp": 5000,
      "amount_max_gbp": 15000,
      "amount_text": "£5,000 - £15,000",
      "open_date": "2026-04-01",
      "close_date": "2026-09-30",
      "eligibility": "Registered charities and community groups in Scotland.",
      "url": "https://www.creativescotland.com/funding/...",
      "score": 0.91,
      "reasons": ["Sector match: Arts / Culture", "Region match: Scotland", "Within funding range"]
    }
  ],
  "distinct_grant_cap_notice": null
}

Regions & sectors

The region and sector parameters accepted by every endpoint above are closed-vocabulary — send one of the exact values below (case-sensitive), not free text.

Regions

UK-wideEnglandScotlandWalesNorthern IrelandLondonSouth EastSouth WestNorth WestNorth EastYorkshireEast MidlandsWest MidlandsEast of EnglandInternational

Sectors

Arts / CultureDefence / SecurityAgriculture / FoodSustainability / EnvironmentEducation / SkillsCommunity / SocialBusiness / InnovationHealth / Science / ResearchTechnology / DigitalGeneral / Other