API documentation

A read-only API so you can pull GreenLaunch data into your own spreadsheets, CRM or internal dashboards. Included with Pro and Team.

Authentication

Create a key on the API keys page and send it as a bearer token. A key only ever returns data belonging to the account that created it.

curl -H "Authorization: Bearer gl_live_..." \
  "https://greenlaunch.uk/api/public/v1/opportunities?kind=pitching&direction=eu-to-uk&limit=10"

Endpoints

Endpoint	Returns	Query parameters
GET /api/public/v1/opportunities	Funding and pitching opportunities.	kind (funding \| pitching), direction (eu-to-uk \| uk-to-eu \| both), status, type, sector, stage, limit (1–100, default 25), offset
GET /api/public/v1/opportunities/{id}	A single opportunity with eligibility, deadline, benefits and effort.	—
GET /api/public/v1/saved	Your saved items, each with your note, application status and the full opportunity record.	—
GET /api/public/v1/readiness	Your overall readiness score, the per-area breakdown and every answer you have given.	—
GET /api/public/v1/cities	The fourteen EU and UK cities with every benchmark figure, its source, year and verification status.	country, region (UK \| EU)
GET /api/public/v1/cities/{slug}	One city: benchmarks, strengths, watch-outs, entity notes and soft-landing programmes.	—

Example response

{
  "apiVersion": "v1",
  "total": 18,
  "limit": 25,
  "offset": 0,
  "data": [
    {
      "id": "pitch-climatetech-supercluster",
      "kind": "pitching",
      "title": "Climate-Tech Supercluster cross-border showcase",
      "provider": "Climate-Tech Supercluster network",
      "type": "Supercluster",
      "direction": "both",
      "location": "London",
      "sectors": ["Water technology"],
      "stages": ["Seed", "Series A"],
      "status": "Open",
      "deadline": "2026-10-14T09:00:00.000Z",
      "eventDate": "2026-11-20T09:00:00.000Z",
      "requirements": ["..."],
      "benefits": ["..."],
      "effort": "Medium — ...",
      "cost": "Fee: none. Travel: self-funded.",
      "summary": "...",
      "dataQuality": {
        "source": "Organiser programme page",
        "confidence": "Medium",
        "demonstrationData": true,
        "notice": "Demonstration record. Verify dates and eligibility ..."
      }
    }
  ]
}

Limits and errors

120 requests a minute per key. Every response carries X-RateLimit-Limit, X-RateLimit-Remaining and X-RateLimit-Reset. Errors come back as { "error": { "code", "message" } }.

401 — The key is missing, unknown or revoked.
403 — The account's plan does not include API access.
404 — No record with that id.
429 — More than 120 requests in a minute on one key.

Data quality

Opportunity records in GreenLaunch are currently demonstration data. Every record carries a dataQuality block with its source, confidence and a notice, so anything you build stays honest about what it is showing. Always confirm dates and eligibility on the organiser's own page before applying.

Questions or need write access, webhooks or a partner integration? Get in touch.