List experiences

GEThttps://api.nexgapp.com/v1/experiencesLive

Returns events published on nexgapp.com that have not started yet, soonest first. Events in the past and drafts are never listed.

Ticket prices are the organiser’s face value. NexG does not sell tickets or add a margin to them; it charges for the day it plans around an event.

Authentication: None needed. A key with public_read gets its own rate limit.
Rate limit cost: 1 token
Caching: Shared caches, 60 seconds
Available since: 21 October 2026

curl "https://api.nexgapp.com/v1/experiences?city=nairobi" \
  -H "X-Api-Key: $NEXG_API_KEY"

Response · 200 OK

{
  "ok": true,
  "data": {
    "items": [
      {
        "id": "4c5d6e7f-8a9b-4c0d-9e1f-2a3b4c5d6e7f",
        "city_id": "c1a5e2d4-7b3f-4e8a-9c6d-2f1b0e4a8d37",
        "name": "RnB House",
        "category": "music",
        "venue_name": "Westlands rooftop",
        "venue_address": "Westlands, Nairobi",
        "starts_at": "2026-11-22T18:00:00+00:00",
        "ends_at": "2026-11-22T23:00:00+00:00",
        "doors_at": "2026-11-22T17:30:00+00:00",
        "cover_path": null,
        "featured": true,
        "anchor_slot": "night",
        "organiser_name": "Example Events",
        "organiser_url": null,
        "ticket_url": null,
        "ticket_bands": [
          {
            "label": "Regular",
            "price_kes": 3500,
            "currency": "KES"
          },
          {
            "label": "VIP",
            "price_kes": 8000,
            "currency": "KES"
          }
        ],
        "nexg_can_hold_tickets": true,
        "practical_note": "Parking fills by 21:00. The driver drops at the door.",
        "suggested_blocks": [
          {
            "kind": "meal",
            "mood": "taste",
            "slot": "evening",
            "title": "Dinner first",
            "swap_group": "evening_taste"
          }
        ]
      }
    ],
    "next_cursor": null
  },
  "meta": {
    "api_version": "v1",
    "limit": 25
  }
}

Query parameters

cityquery · stringOptional
A city slug, such as nairobi. A slug no city has returns an empty list.
qquery · stringOptional
Free text matched against the event name and venue name, ignoring case. Up to 120 characters.
cursorquery · stringOptional
The next_cursor from the previous page, passed back unchanged. Leave it out for the first page. A cursor this endpoint did not issue is refused with 400.
limitquery · integerOptional
Results per page, 1 to 100. Defaults to 25. A value outside that range is refused with 400.

Any other query parameter is refused with 400 invalid_request.

Headers

X-Api-Keyheader · stringOptional
Your API key. Or send it as Authorization: Bearer <key>, but never both in one request.

Response

Experience data.items[]

iduuid
The event’s id.
city_iduuid
The city it takes place in.
namestring or null
The event’s name.
categorystring or null
sport, music, food_drink, culture, family, nightlife or other.
venue_namestring or null
Where it is held.
venue_addressstring or null
The venue’s address.
starts_attimestamp or null
When it starts.
ends_attimestamp or null
When it ends.
doors_attimestamp or null
When doors open.
cover_pathstring or null
The cover image, as a URL or a path on nexgapp.com.
featuredboolean or null
Featured by NexG.
anchor_slotstring or null
The part of the day the event pins when NexG plans around it: early, morning, midday, afternoon, evening, night or late.
organiser_namestring or null
Who runs it.
organiser_urlstring or null
The organiser’s website.
ticket_urlstring or null
Where tickets are sold.
ticket_bandsarray
Ticket prices at the organiser’s face value: a list of { label, price_kes, currency }. price_kes is a positive number of shillings; currency may be absent. Empty when there are no bands. NexG never adds a margin to a ticket.
nexg_can_hold_ticketsboolean or null
Whether NexG can hold tickets for a guest’s day out.
practical_notestring or null
Something a guest should know, such as parking or road closures.
suggested_blocksarray
What a day around the event usually includes, as NexG’s team entered it: a list, usually of { kind, mood, slot, title, swap_group }. Read it defensively.

Errors

Every error has the same shape; see Errors. Branch on error.code and the HTTP status, never on the message.

400invalid_request
Both X-Api-Key and Authorization were sent, or Authorization is not a Bearer key.
401not_found
The key is unknown, revoked or expired, or its merchant cannot use the API right now. All of these get the same answer on purpose.
403not_found
A key was sent but it does not have public_read.
429rate_limited
Your token bucket is empty. Wait the number of seconds in the Retry-After header.
503internal_error
NexG could not check the key or the rate limit. Retry with backoff.
400invalid_request
A query parameter is not one this endpoint accepts, or fails validation. error.fields names it.
500internal_error
NexG could not read the events.
500internal_error
Something unexpected failed on NexG’s side. NexG logs the X-Request-Id: quote it if you report the failure.

Good to know

Ticket bands are entered by hand. An event whose bands cannot be read is left out of the list, and logged for NexG to correct, rather than failing the whole list.