Gå til innhold
Kuvert
no
Bransjer
Funksjoner
Priser
Dokumentasjon

Arrangementer

Fire åpne kall gir deres egen nettside de samme kveldene som butikken viser: navn, tider, plakat, line-up, priser, serier og bordpakker. De krever ingen API-nøkkel.

Kallene ligger under https://api.kuvert.dk/v1/merchants/{slug}, der {slug} er butikkens adresse, f.eks. demo-natklubben i shop.kuvert.dk/demo-natklubben. De er åpne som butikken selv: ingen nøkkel, ingen konto og bare det en gjest også kan se. En kveld som fortsatt er et utkast, kommer aldri med.

Kallene

KallGir
GET /v1/merchants/{slug}Butikken og kveldene som er til salgs, i events, den tidligste først. Med ?include=canceled kommer avlyste kvelder med, og med ?include=closed kvelder der nettsalget er stengt, men kvelden ikke er over. Begge kan stå sammen: ?include=canceled,closed.
GET /v1/merchants/{slug}/events/{event}Én kveld med alle priser, hva som er igjen, og om den kan kjøpes akkurat nå. {event} er kveldens slug eller id.
GET /v1/merchants/{slug}/seriesDe faste seriene, hver med kveldene i serien som er til salgs.
GET /v1/merchants/{slug}/table-nightsDe kommende kveldene med bordpakker, og om hver pakke kan bookes akkurat nå.
GET /v1/merchants/{slug}/events/{event}/planKlubbens kart for én kveld med bordpakker: rommene og hvert bord, ledig eller solgt. Det står ingenting om hvem som har kjøpt.

Kveldene

Butikkens eget kall har kveldene med i events. Hver kveld har navn, tider, sted og plakat og feltene et program bygges av. Her er et utdrag av svaret med én kveld:

JSON
{
  "events": [
    {
      "id": "evt_65694ef606f6483083d368ec040601e2",
      "slug": "klubnat-2026-10-17",
      "name": "Klubnat",
      "startsAt": "2026-10-17T21:00:00.000Z",
      "endsAt": "2026-10-18T03:00:00.000Z",
      "venue": "Natklubben, Vejle",
      "bannerUrl": null,
      "bannerWidth": null,
      "bannerHeight": null,
      "salesCloseAt": "2026-10-18T00:00:00.000Z",
      "status": "published",
      "cancelNote": null,
      "series": {
        "id": "ser_216c1567afbb42368340cb9b11146a90",
        "name": "Klubnat",
        "weekdays": [
          5,
          6
        ],
        "isRecurring": true,
        "recurrence": {
          "kind": "weekly",
          "weekdays": [
            5,
            6
          ]
        },
        "description": "Hver fredag og lørdag"
      },
      "seriesDate": "2026-10-17",
      "subtitle": "Husets DJs på to gulve",
      "lineup": [
        {
          "name": "Kasper Ø",
          "role": "warm-up",
          "time": "2026-10-17T21:00:00.000Z"
        },
        {
          "name": "Selma Rask",
          "role": "resident",
          "time": "2026-10-17T23:00:00.000Z"
        }
      ],
      "genres": [
        "House",
        "Hiphop",
        "Top 40"
      ],
      "doorsAt": "2026-10-17T21:00:00.000Z",
      "lastEntryAt": "2026-10-18T01:00:00.000Z",
      "dressCode": "Ingen sportstøj",
      "ticketsUrl": null,
      "host": {
        "slug": "demo-natklubben",
        "name": "Natklubben"
      },
      "cohosts": []
    }
  ]
}
FeltBetyr
id, slugKveldens id og den lesbare adressen. Kveldens side i butikken er shop.kuvert.dk/{slug}/event/{slug}, med id-en hvis kvelden ikke har en slug.
startsAt, endsAtNår kvelden begynner og slutter. endsAt er null hvis kvelden ikke sier det.
salesCloseAtNår nettsalget stenger.
bannerUrl, bannerWidth, bannerHeightPlakaten og størrelsen i piksler, så siden kan holde av plassen før den er hentet. Vis den hel: den er laget for å ses uten beskjæring.
status, cancelNotepublished eller canceled, og meldingen dere skrev da kvelden ble avlyst.
series, seriesDateSerien bak kvelden med navn, ukedager (0 er søndag), regelen og en ferdig setning å vise, f.eks. «Hver fredag og lørdag», og hvilken av seriens dager det er. null på en kveld dere har opprettet selv.
subtitle, genres, dressCodeUndertittelen, sjangrene og antrekkskoden, slik dere skrev dem.
lineupNavnene i rekkefølge, hvert med name, role og time. time har dato med, så et sett etter midnatt havner på riktig dag.
doorsAt, lastEntryAtNår dørene åpner, og når siste gjest slippes inn.
ticketsUrlHvor billettene selges når noen andre selger dem, f.eks. arrangøren. Har kvelden egne priser i Kuvert, selges de her, og feltet brukes ikke.

Én kveld

Kveldens eget kall gir alt: beskrivelsen, aldersgrensen og alle priser i tiers. onSale sier om det kan kjøpes akkurat nå, og refusalCode hvorfor ikke, f.eks. soldOut eller closed. waitlistOpen er true når gjesten kan skrive seg på ventelisten.

JSON
{
  "id": "evt_65694ef606f6483083d368ec040601e2",
  "slug": "klubnat-2026-10-17",
  "name": "Klubnat",
  "startsAt": "2026-10-17T21:00:00.000Z",
  "endsAt": "2026-10-18T03:00:00.000Z",
  "venue": "Natklubben, Vejle",
  "bannerUrl": null,
  "bannerWidth": null,
  "bannerHeight": null,
  "description": "Gratis før midnat på gæstelisten, entré ved døren derefter. Borde med flasker hele natten.",
  "ageLimit": 18,
  "tiers": [
    {
      "id": "etr_e5e5766ded1e456599d7e8925f68bff9",
      "name": "Entré",
      "description": "Spring billetkøen over. Gælder hele natten.",
      "priceOre": 10000,
      "availability": "on_sale",
      "remaining": null,
      "scarcity": null,
      "salesOpenAt": null,
      "salesCloseAt": null,
      "seatsPerTicket": 1,
      "seatsChosenByGuest": false,
      "creditPromisedOre": null,
      "tablePackage": false,
      "includedItems": [],
      "minSeats": 1,
      "arriveBy": null,
      "seller": {
        "slug": "demo-natklubben",
        "name": "Natklubben"
      }
    },
    {
      "id": "etr_773b122865f0469e81c06781c4befa63",
      "name": "Flaske",
      "description": null,
      "priceOre": 240000,
      "availability": "on_sale",
      "remaining": 10,
      "scarcity": null,
      "salesOpenAt": null,
      "salesCloseAt": null,
      "seatsPerTicket": 10,
      "seatsChosenByGuest": true,
      "creditPromisedOre": null,
      "tablePackage": true,
      "picksTable": true,
      "tableSeats": {
        "min": 4,
        "max": 10
      },
      "tablesFree": 10,
      "includedItems": [
        "1 × Absolut Vodka 70 cl",
        "6 × Red Bull",
        "Entré for hele bordet"
      ],
      "minSeats": 1,
      "arriveBy": "2026-10-17T22:30:00.000Z",
      "seller": {
        "slug": "demo-natklubben",
        "name": "Natklubben"
      }
    }
  ],
  "minQuantity": 1,
  "salesCloseAt": "2026-10-18T00:00:00.000Z",
  "pickups": [],
  "remaining": 350,
  "onSale": true,
  "refusal": null,
  "refusalCode": null,
  "refusalCount": null,
  "waitlistOpen": false,
  "questions": [],
  "status": "published",
  "cancelNote": null,
  "series": {
    "id": "ser_216c1567afbb42368340cb9b11146a90",
    "name": "Klubnat",
    "weekdays": [
      5,
      6
    ],
    "isRecurring": true,
    "recurrence": {
      "kind": "weekly",
      "weekdays": [
        5,
        6
      ]
    },
    "description": "Hver fredag og lørdag"
  },
  "seriesDate": "2026-10-17",
  "subtitle": "Husets DJs på to gulve",
  "lineup": [
    {
      "name": "Kasper Ø",
      "role": "warm-up",
      "time": "2026-10-17T21:00:00.000Z"
    },
    {
      "name": "Selma Rask",
      "role": "resident",
      "time": "2026-10-17T23:00:00.000Z"
    }
  ],
  "genres": [
    "House",
    "Hiphop",
    "Top 40"
  ],
  "doorsAt": "2026-10-17T21:00:00.000Z",
  "lastEntryAt": "2026-10-18T01:00:00.000Z",
  "dressCode": "Ingen sportstøj",
  "ticketsUrl": null,
  "host": {
    "slug": "demo-natklubben",
    "name": "Natklubben"
  },
  "cohosts": []
}
FeltBetyr
priceOrePrisen i øre: 10000 er 100 DKK.
availabilityon_sale, not_yet (åpner senere), closed eller sold_out.
remaining, scarcityHvor mange som er igjen til den prisen, og hva butikken viser om det: tallet (count), «få igjen» (few) eller ingenting (null). Vis det scarcity sier, og ikke tallet. remaining er null når prisen ikke har sitt eget antall.
salesOpenAt, salesCloseAt, opensAfterTierIdPrisens eget tidsrom, og prisen den venter på skal bli utsolgt når billettene selges i trinn.
tablePackage, picksTable, tableSeats, tablesFreeEn bordpakke: om gjesten velger bordet på kartet, det minste og største bordet, og hvor mange bord som er ledige.
includedItems, creditPromisedOreDet som følger med en pakke, og barkreditten hvis det finnes en.
ageLimitAldersgrensen i døren, eller null.

Serier

Holder dere den samme kvelden hver uke, gir seriene dere den som én rad: «Hver fredag og lørdag», og kveldene i serien som er til salgs. En serie der alle kveldene fortsatt er utkast, er ikke med.

JSON
{
  "series": [
    {
      "id": "ser_216c1567afbb42368340cb9b11146a90",
      "name": "Klubnat",
      "weekdays": [
        5,
        6
      ],
      "isRecurring": true,
      "recurrence": {
        "kind": "weekly",
        "weekdays": [
          5,
          6
        ]
      },
      "description": "Hver fredag og lørdag",
      "nights": [
        {
          "id": "evt_65694ef606f6483083d368ec040601e2",
          "slug": "klubnat-2026-10-17",
          "name": "Klubnat",
          "startsAt": "2026-10-17T21:00:00.000Z",
          "seriesDate": "2026-10-17"
        },
        {
          "id": "evt_0ba0fd9fb19c42cd80f4ebc11879b462",
          "slug": "klubnat-2026-10-23",
          "name": "Klubnat",
          "startsAt": "2026-10-23T21:00:00.000Z",
          "seriesDate": "2026-10-23"
        }
      ]
    }
  ]
}

Bordpakker

Selger dere bord til kveldene, gir dette kallet de kommende kveldene med bordpakkene, så siden kan sette «Book bord» ved hver kveld uten å hente hver kvelds side. bookable sier om pakken kan bookes akkurat nå.

JSON
{
  "nights": [
    {
      "id": "evt_65694ef606f6483083d368ec040601e2",
      "slug": "klubnat-2026-10-17",
      "name": "Klubnat",
      "startsAt": "2026-10-17T21:00:00.000Z",
      "endsAt": "2026-10-18T03:00:00.000Z",
      "venue": "Natklubben, Vejle",
      "bannerUrl": null,
      "bannerWidth": null,
      "bannerHeight": null,
      "ageLimit": 18,
      "onSale": true,
      "packages": [
        {
          "id": "etr_773b122865f0469e81c06781c4befa63",
          "name": "Flaske",
          "description": null,
          "priceOre": 240000,
          "availability": "on_sale",
          "remaining": 10,
          "scarcity": null,
          "salesOpenAt": null,
          "salesCloseAt": null,
          "seatsPerTicket": 10,
          "seatsChosenByGuest": true,
          "creditPromisedOre": null,
          "tablePackage": true,
          "picksTable": true,
          "tableSeats": {
            "min": 4,
            "max": 10
          },
          "tablesFree": 10,
          "includedItems": [
            "1 × Absolut Vodka 70 cl",
            "6 × Red Bull",
            "Entré for hele bordet"
          ],
          "minSeats": 1,
          "arriveBy": "2026-10-17T22:30:00.000Z",
          "seller": {
            "slug": "demo-natklubben",
            "name": "Natklubben"
          },
          "bookable": true
        }
      ]
    }
  ]
}

Hold programmet oppdatert

Må siden deres vite det med en gang når en kveld endrer seg, kan den abonnere på webhooks i stedet for å spørre hvert minutt: event.published når en kveld legges ut for salg, event.updated når noe offentlig endrer seg (med navnene på feltene i changedFields), event.canceled og event.unpublished. Hver leveranse har hele kvelden i samme form som listen over, med eventId i stedet for id. Et webhook-endepunkt opprettes under Innstillinger → Webhooks eller med en API-nøkkel.

Et eksempel

Det minste som virker: hent kveldene på serveren deres, og bygg en lenke til hver kvelds side i butikken.

JavaScript
const res = await fetch('https://api.kuvert.dk/v1/merchants/demo-natklubben')
const { events } = await res.json()

for (const night of events) {
  const link = `https://shop.kuvert.dk/demo-natklubben/event/${night.slug ?? night.id}`
  console.log(night.name, night.startsAt, night.status, link)
}

Delte kvelder

En kveld kan deles av flere bedrifter, f.eks. en arrangør som selger billettene, og klubben som selger bordene. Kvelden tilhører verten, men den står i programmet hos dem alle og kan hentes under hver av deres slugs, med samme id og samme slug. Den telles én gang i hver bedrifts liste.

FeltBetyr
hostBedriften kvelden tilhører, med slug og name. Kveldens riktige adresse er shop.kuvert.dk/{host.slug}/event/{slug}, også når dere henter den under deres egen slug.
cohostsDe andre bedriftene som selger på kvelden, i den rekkefølgen de ble med. En tom liste på en kveld som ikke er delt.
tiers[].sellerHvem som selger prisen, og som gjesten betaler. Bruk den til å vise deres egne priser for seg eller til å skrive hvem som selger hva.
lineup[].merchantSlugDen opptredendes egen butikk på Kuvert, når verten har koblet navnet til den.

GET /v1/merchants/{slug}/appearances gir kveldene andre bedrifter har booket dere til, enten som medvert eller i line-upen, i samme form som listen over pluss seller (bedriften hvis side selger kvelden) og appearance (cohost eller lineup). Da kan en artists side vise klubbkveldene artisten spiller på, uten at noen må skrive dem inn igjen. En kveld dere selv er medvert på, står også på deres egen liste over, så vis bare den ene, eller filtrer på appearance.

Webhooks for en delt kveld (event.*) går til alle bedriftene på kvelden. order.paid og ticket.issued går bare til den som solgte, og har seller, host og cohosts med, så systemet deres kan skille deres eget salg fra partnerens.

Var siden nyttig?