Examples use a fictional festival, summer-fest. Sign in at events.grofomo.com and they switch to your own events.

Organiser profile

GET/v1/organisers/{slug}

An organiser's public profile and their upcoming public events.

Only returned when the organiser has opted in to a public profile; otherwise this is a 404.

No key is required today — send one anywayThe Grofomo mobile app still calls this endpoint without a credential, so it cannot be locked down yet. It will be. A key sent now is accepted and ignored, so an integration built this way keeps working on the day enforcement lands; one built without a key will start returning 401 unauthorized.

Request

curl -sS \
  -H 'X-Grofomo-Key: pk_live_YOUR_PUBLISHABLE_KEY' \
  'https://api.grofomo.com/v1/organisers/riot-promotions'

Path parameters

slugstringrequired: The organiser's slug. Example: `riot-promotions`.

Response

200 OK

{
  "apiVersion": 1,
  "data": {
    "id": "b2d4a6f8-1c3e-4a5b-8d7f-2e9c0a1b3d45",
    "name": "Riot Promotions",
    "slug": "riot-promotions",
    "bio": "Bristol promoters since 2011. Warehouse parties, one festival, and a stubborn dislike of queues.",
    "logoUrl": "https://cdn.grofomo.com/riot-promotions/logo.png",
    "logoVectorUrl": null,
    "backgroundColor": "#080808",
    "textColor": "#FAFAF7",
    "website": "https://riotpromotions.example",
    "socials": {
      "instagram": "https://instagram.com/riotpromotions"
    },
    "upcomingEvents": [
      {
        "id": "6f1c8e2a-4b3d-4c9e-9f21-8a7d5e0b1c34",
        "slug": "summer-fest",
        "name": "Summer Fest",
        "startDate": "2026-07-17",
        "endDate": "2026-07-19",
        "venueName": "Ashton Court",
        "city": "Bristol",
        "country": "GB",
        "artworkUrl": "https://cdn.grofomo.com/summer-fest/brand/poster.jpg"
      }
    ]
  }
}

iduuid
namestring
slugstring
biostring | null: Public "about us" copy.
logoUrlstring | null
logoVectorUrlstring | null
backgroundColorstring | null
textColorstring | null
websitestring | null
socialsobject: Profile URLs keyed by platform slug. Blank entries are stripped server-side.
upcomingEventsobject[]: The organiser's public events that have not finished yet, soonest first.
upcomingEvents[].iduuid
upcomingEvents[].slugstring: Pass this to any of the per-event endpoints.
upcomingEvents[].namestring
upcomingEvents[].startDatestring | null: First day, as `YYYY-MM-DD`.
upcomingEvents[].endDatestring | null: Last day, as `YYYY-MM-DD`.
upcomingEvents[].venueNamestring | null
upcomingEvents[].citystring | null
upcomingEvents[].countrystring | null: Raw ISO 3166-1 alpha-2 code, e.g. "GB".
upcomingEvents[].artworkUrlstring | null: Poster or key artwork, for a listing card.

Generated from OrganiserDetailResponse

Errors

not_foundHTTP 404: No such organiser, or they have not enabled a public profile.