API-referanse

Events

Events: list them, read one, create a draft, change its basics, publish it, and its numbers.

List events

GET/events

Lists the workspace's events, oldest change first, with how many attendees and check-ins each has. Filter by status or by part of the name.

Omfang: events:read

Parametere

spørring

cursorstring
Where the page starts: nextCursor from the page before, exactly as it was returned. Leave out for the first page.
limitinteger (int32)
How many on a page, up to 500.
Standard: 100
updatedSincestring (date-time)
Only what changed at or after this moment, in UTC unless it says otherwise. Pass the newest updatedUtc your last sync saw.
statusstring
Only events with this status.
Én av: draft, published, closed
qstring
Only events whose name or address holds this text.

Svar

200 A page of events. EventList
Felt
- dataEventSummary[]
  The events.
  Vis feltene
  - eventIdstring (uuid)
    The event's id.
  - slugstring
    The event's address: /e/{slug}.
  - namestring
    The event's name.
  - statusstring
    Draft, published or closed.
    Én av: draft, published, closed
  - startDatestring (date)
    The first day, in the venue's time zone.
  - endDatestring (date)
    The last day, in the venue's time zone.
  - venueNamestring
    Where it is.
  - attendeesinteger
    How many valid tickets it has.
  - checkedIninteger
    How many attendees were checked in.
  - sessionsinteger
    How many sessions its programme has.
  - timeZonestring
    The venue's IANA time zone, such as Europe/Amsterdam. Dates and the local times of sessions are in it.
  - currencystring
    The currency of its tickets, as ISO 4217.
  - formatstring
    InPerson, online or hybrid.
    Én av: inPerson, online, hybrid
  - modulesstring[]
    The modules switched on, such as checkin and sponsors.
  - urlstring (uri)
    The event's public page.
  - createdUtcstring (date-time)
    When it was made, in UTC.
  - updatedUtcstring (date-time)
    When its basics last changed, in UTC. Pass the latest you have as updatedSince.
- nextCursorstring eller null
  The cursor for the next page; null on the last page.
- hasMoreboolean
  Whether there is another page.
400 invalidCursor, invalidUpdatedSince, invalidRequest.
401 invalidKey, keyExpired, keyRevoked.
403 missingScope.
429 rateLimited.

Avvisninger

invalidKey keyExpired keyRevoked rateLimited missingScope invalidCursor invalidUpdatedSince invalidRequest

Forespørsel

curl "https://attendbeacon.com/api/v1/events?limit=2" \
  -H "Authorization: Bearer $ATTENDBEACON_KEY"

const response = await fetch("https://attendbeacon.com/api/v1/events?limit=2", {
  headers: {
    Authorization: `Bearer ${process.env.ATTENDBEACON_KEY}`
  }
});
if (!response.ok) throw new Error((await response.json()).detail);
const data = await response.json();

using System.Net.Http.Headers;
using System.Text;

using var client = new HttpClient();
client.DefaultRequestHeaders.Authorization = new AuthenticationHeaderValue("Bearer", Environment.GetEnvironmentVariable("ATTENDBEACON_KEY"));

using var request = new HttpRequestMessage(HttpMethod.Get, "https://attendbeacon.com/api/v1/events?limit=2");

using var response = await client.SendAsync(request);
response.EnsureSuccessStatusCode();
var json = await response.Content.ReadAsStringAsync();

import os
import requests

response = requests.get(
    "https://attendbeacon.com/api/v1/events", params={"limit": 2},
    headers={
        "Authorization": f"Bearer {os.environ['ATTENDBEACON_KEY']}"
    }
)
response.raise_for_status()
data = response.json()

$headers = @{
    Authorization = "Bearer $env:ATTENDBEACON_KEY"
}

$data = Invoke-RestMethod -Method Get -Uri "https://attendbeacon.com/api/v1/events?limit=2" -Headers $headers

200 Eksempelsvar

JSON

{
  "data": [
    {
      "eventId": "b3ac0000-0000-4000-8000-000000000001",
      "slug": "beacon-summit",
      "name": "Beacon Summit",
      "status": "published",
      "startDate": "2026-11-12",
      "endDate": "2026-11-13",
      "timeZone": "Europe/Amsterdam",
      "venueName": "Beurs van Berlage",
      "currency": "EUR",
      "format": "inPerson",
      "modules": [
        "payments",
        "addons"
      ],
      "url": "https://attendbeacon.com/e/beacon-summit/",
      "attendees": 86,
      "checkedIn": 0,
      "sessions": 30,
      "createdUtc": "2026-10-14T21:40:48.036Z",
      "updatedUtc": "2026-10-14T21:40:48.036Z"
    },
    {
      "eventId": "b3ac2500-0000-4000-8000-000000000001",
      "slug": "beacon-summit-2025",
      "name": "Beacon Summit 2025",
      "status": "closed",
      "startDate": "2025-11-13",
      "endDate": "2025-11-14",
      "timeZone": "Europe/Amsterdam",
      "venueName": "Beurs van Berlage",
      "currency": "EUR",
      "format": "inPerson",
      "modules": [
        "payments",
        "addons"
      ],
      "url": "https://attendbeacon.com/e/beacon-summit-2025/",
      "attendees": 65,
      "checkedIn": 61,
      "sessions": 12,
      "createdUtc": "2025-06-16T00:00:00.000Z",
      "updatedUtc": "2026-10-14T21:40:49.820Z"
    }
  ],
  "nextCursor": "YzE6MDYzOTI3NjEwODQ5ODIwMDAwMHxiM2FjMjUwMDAwMDA0MDAwODAwMDAwMDAwMDAwMDAwMQ",
  "hasMore": true
}

400 invalidCursor, invalidUpdatedSince, invalidRequest.

JSON

{
  "type": "https://attendbeacon.com/developers/errors#invalidCursor",
  "title": "The cursor is not valid",
  "status": 400,
  "detail": "Pass nextCursor exactly as a list returned it, with the same filters.",
  "instance": "/api/v1/events",
  "code": "invalidCursor",
  "traceId": "00-4bf92f3577b34da6a3ce929d0e0e4736-00f067aa0ba902b7-01",
  "error": "Pass nextCursor exactly as a list returned it, with the same filters."
}

Create a draft event Endrer data

POST/events

Creates an event as a draft, as the workspace's New event does. Nothing is public and nobody is emailed until it is published. Answers the event as GetEvent does, with its ETag.

Omfang: events:write

Send en Idempotency-Key for å gjøre nye forsøk trygge. →

Parametere

header

Idempotency-Keystring
A key of your own, such as a UUID, so a retry after a lost connection is answered with the first answer instead of doing it twice. Kept 24 hours.

Innhold NewEvent

The event.

namestringpåkrevd
Its name, at most 200 characters.
startDatestring (date)påkrevd
The first day, at the venue.
endDatestring (date)
The last day; the first day when left out.
timeZonestring
The venue's IANA time zone. Europe/Amsterdam when left out.
Standard: "Europe/Amsterdam"
venueNamestring
Where it takes place.
venueAddressstring
The venue's address.
summarystring
One or two sentences about it.
formatstring
InPerson (the default), online or hybrid.
Én av: inPerson, online, hybrid
currencystring
The currency of its tickets, as ISO 4217. EUR when left out.
Standard: "EUR"
slugstring
Its address after /e/, lower case letters, digits and hyphens. Made from the name when left out.
languagesstring[]
Its languages as two-letter codes, the first the default. en when left out.
modulesstring[]
The modules to switch on. Every one when left out.

Svar

201 The draft event. Location is its address. EventDetail
Felt
- eventobject
  The event as its public page shows it, with its registration questions and theme as well.
  Vis feltene
  - eventIdstring (uuid)
    The event's id.
  - slugstring
    The event's address: /e/{slug}.
  - namestring
    The event's name.
  - statusstring
    Draft, published or closed.
  - startDatestring (date)
    The first day, in the venue's time zone.
  - endDatestring (date)
    The last day, in the venue's time zone.
  - timeZonestring
    The venue's time zone, such as Europe/Amsterdam.
  - venueNamestring
    Where it is.
  - venueAddressstring
    The venue's address.
  - summarystring
    A line about the event.
  - descriptionstring
    What the event is about.
  - languagesstring[]
    The event's languages, such as en and nl.
  - currencystring
    The currency, as ISO 4217.
  - contactEmailstring (email)
    The organiser's contact address.
  - formatstring
    In person, online or hybrid.
- programmeobject eller null
  Rooms, tracks, sessions, speakers and sponsors. Null without program:read.
  Vis feltene
  - roomsobject[]
    The rooms.
    Vis feltene
    roomIdstring (uuid)
    The room's id.
    namestring
    The room's name.
    locationstring
    Where the room is.
    capacityinteger
    How many it seats.
  - tracksobject[]
    The tracks.
    Vis feltene
    trackIdstring (uuid)
    The track's id.
    namestring
    The track's name.
    colourstring
    The track's colour.
  - sessionsobject[]
    The sessions.
    Vis feltene
    sessionIdstring (uuid)
    The session's id.
    titlestring
    The session's title.
    summarystring
    What it is about.
    kindstring
    Talk, workshop, break and others.
    roomIdstring (uuid)
    The room's id.
    trackIdstring (uuid)
    The track's id.
    startsUtcstring (date-time)
    When it starts, in UTC.
    endsUtcstring (date-time)
    When it ends, in UTC.
    startsLocalstring
    When it starts, in the venue's time.
    endsLocalstring
    When it ends, in the venue's time.
    capacityinteger
    How many it seats, when fewer than its room.
    languagestring
    The language it is given in.
  - speakersobject[]
    The speakers.
    Vis feltene
    speakerIdstring (uuid)
    The speaker's id.
    namestring
    The speaker's name.
    jobTitlestring
    Their job title.
    companystring
    Their company.
    biostring
    About them.
    photoUrlstring
    Their photo's address.
  - sponsorsobject[]
    The sponsors.
    Vis feltene
    sponsorIdstring (uuid)
    The sponsor's id.
    namestring
    The sponsor's name.
    tierstring
    Their sponsorship level.
    websitestring
    Their website.
    boothstring
    Their stand.
- ticketTypesTicketType[] eller null
  The ticket types and what is sold. Null without tickets:read.
  Vis feltene
  - ticketTypeIdstring (uuid)
    The ticket type's id.
  - namestring
    Its name.
  - descriptionstring
    What it includes.
  - pricenumber
    The price, VAT included, with the currency's own decimals.
  - vatRatenumber
    The VAT rate, as a percentage.
  - currencystring
    The currency, as ISO 4217.
  - capacityinteger eller null
    How many may be sold, when limited.
  - takeninteger
    How many are taken.
  - maxPerOrderinteger
    The most one order may hold.
  - visibilitystring
    Public, code (sold with an access code) or hidden.
    Én av: public, code, hidden
  - salesStartUtcstring (date-time)
    When sales start, in UTC.
  - salesEndUtcstring (date-time)
    When sales end, in UTC.
  - sortOrderinteger
    Its place in the list.
  - eventIdstring (uuid)
    The event's id.
  - remaininginteger (int32) eller null
    Places left, or null without a limit.
  - requiresApprovalboolean
    Whether an order for it waits for the organiser's approval.
  - salesStartLocalstring eller null
    When sales start, in the venue's time.
  - salesEndLocalstring eller null
    When sales end, in the venue's time.
  - includedAddOnIdsstring (uuid)[]
    The add-ons it includes, as a bundle.
  - updatedUtcstring (date-time) eller null
    When it last changed, in UTC.
- updatedUtcstring (date-time)
  When the event's basics last changed, in UTC.
400 invalidBody, invalidRequest, invalidIdempotencyKey.
401 invalidKey, keyExpired, keyRevoked.
403 missingScope, demoWorkspace.
409 idempotencyKeyInUse, slugTaken.
422 idempotencyKeyReused.
429 rateLimited.

Avvisninger

invalidKey keyExpired keyRevoked rateLimited missingScope invalidBody invalidRequest demoWorkspace idempotencyKeyInUse idempotencyKeyReused invalidIdempotencyKey slugTaken

Forespørsel

curl -X POST "https://attendbeacon.com/api/v1/events" \
  -H "Authorization: Bearer $ATTENDBEACON_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
  "name": "Beacon Summit 2027",
  "startDate": "2027-11-11",
  "endDate": "2027-11-12",
  "timeZone": "Europe/Amsterdam",
  "venueName": "Beurs van Berlage, Amsterdam",
  "currency": "EUR"
}'

const response = await fetch("https://attendbeacon.com/api/v1/events", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.ATTENDBEACON_KEY}`,
    "Idempotency-Key": crypto.randomUUID(),
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "name": "Beacon Summit 2027",
    "startDate": "2027-11-11",
    "endDate": "2027-11-12",
    "timeZone": "Europe/Amsterdam",
    "venueName": "Beurs van Berlage, Amsterdam",
    "currency": "EUR"
  })
});
if (!response.ok) throw new Error((await response.json()).detail);
const data = await response.json();

using System.Net.Http.Headers;
using System.Text;

using var client = new HttpClient();
client.DefaultRequestHeaders.Authorization = new AuthenticationHeaderValue("Bearer", Environment.GetEnvironmentVariable("ATTENDBEACON_KEY"));

using var request = new HttpRequestMessage(HttpMethod.Post, "https://attendbeacon.com/api/v1/events");
request.Headers.Add("Idempotency-Key", Guid.NewGuid().ToString());
request.Content = new StringContent("""
{
  "name": "Beacon Summit 2027",
  "startDate": "2027-11-11",
  "endDate": "2027-11-12",
  "timeZone": "Europe/Amsterdam",
  "venueName": "Beurs van Berlage, Amsterdam",
  "currency": "EUR"
}
""", Encoding.UTF8, "application/json");

using var response = await client.SendAsync(request);
response.EnsureSuccessStatusCode();
var json = await response.Content.ReadAsStringAsync();

import os, uuid
import requests

response = requests.post(
    "https://attendbeacon.com/api/v1/events",
    headers={
        "Authorization": f"Bearer {os.environ['ATTENDBEACON_KEY']}",
        "Idempotency-Key": str(uuid.uuid4())
    },
    json={
        "name": "Beacon Summit 2027",
        "startDate": "2027-11-11",
        "endDate": "2027-11-12",
        "timeZone": "Europe/Amsterdam",
        "venueName": "Beurs van Berlage, Amsterdam",
        "currency": "EUR"
    }
)
response.raise_for_status()
data = response.json()

$headers = @{
    Authorization = "Bearer $env:ATTENDBEACON_KEY"
    "Idempotency-Key" = [guid]::NewGuid().ToString()
}
$body = @'
{
  "name": "Beacon Summit 2027",
  "startDate": "2027-11-11",
  "endDate": "2027-11-12",
  "timeZone": "Europe/Amsterdam",
  "venueName": "Beurs van Berlage, Amsterdam",
  "currency": "EUR"
}
'@

$data = Invoke-RestMethod -Method Post -Uri "https://attendbeacon.com/api/v1/events" -Headers $headers -ContentType "application/json" -Body $body

201 Eksempelsvar

JSON

{
  "event": {
    "eventId": "b3ac0000-0000-4000-8000-000000000001",
    "slug": "beacon-summit",
    "name": "Beacon Summit",
    "status": "published",
    "startDate": "2026-11-12",
    "endDate": "2026-11-13",
    "timeZone": "Europe/Amsterdam",
    "venueName": "Beurs van Berlage",
    "venueAddress": "Damrak 243, 1012 ZJ Amsterdam",
    "summary": "Two days on building, shipping and running software, in the old stock exchange on the Damrak.",
    "description": "Beacon Summit brings together the people who build software and the people who run it. Two days, four rooms, thirty sessions, and a long table for lunch.\n\n**Bring your laptop** for the workshops on day two.",
    "languages": [
      "en",
      "nl"
    ],
    "currency": "EUR",
    "contactEmail": "hello@beaconsummit.example",
    "theme": {
      "accent": "#4338ca",
      "highlight": "#f59e0b",
      "darkAccent": "#a5b4fc",
      "darkHighlight": "#fbbf24",
      "background": null,
      "surface": null,
      "mode": "auto",
      "font": "Inter",
      "headingFont": "Sora",
      "headingWeight": "heavy",
      "headingSpacing": "tight",
      "radius": 16,
      "buttonStyle": "filled",
      "buttonShape": "pill",
      "cardStyle": "glass",
      "headerStyle": "transparent",
      "logoUrl": null,
      "logoDarkUrl": null,
      "logoSize": "medium",
      "iconUrl": null,
      "heroUrl": "/media/f0de0000000040008000000000000001/b3ac001e000040008000000000000000.jpg",
      "heroLayout": "image",
      "heroVideoUrl": null,
      "heroOverlay": 50,
      "countdown": true,
      "backgroundStyle": "aurora",
      "pattern": "beacons",
      "backgroundUrl": null,
      "backgroundOverlay": 75,
      "motion": "subtle",
      "preset": null,
      "customCss": null,
      "accentInk": "#ffffff",
      "highlightInk": "#0f1b2d"
    },
    "registration": {
      "schemaVersion": 1,
      "askCompany": true,
      "askJobTitle": true,
      "companyRequired": false,
      "askSponsorConsent": true,
      "questions": [
        {
          "id": "dietary",
          "kind": "choice",
          "label": {
            "en": "Dietary requirements",
            "nl": "Dieetwensen",
            "de": "Ernährungswünsche",
            "es": "Requisitos alimentarios",
            "da": "Kostbehov",
            "fr": "Régime alimentaire",
            "fi": "Ruokavalio",
            "nb": "Kostbehov",
            "pt": "Restrições alimentares",
            "sv": "Kostönskemål",
            "pl": "Wymagania dietetyczne"
          },
          "required": false,
          "options": [
            {
              "value": "none",
              "label": {
                "en": "None",
                "nl": "Geen",
                "de": "Keine",
                "es": "Ninguno",
                "da": "Ingen",
                "fr": "Aucun",
                "fi": "Ei mitään",
                "nb": "Ingen",
                "pt": "Nenhuma",
                "sv": "Inga",
                "pl": "Brak"
              }
            },
            {
              "value": "vegetarian",
              "label": {
                "en": "Vegetarian",
                "nl": "Vegetarisch",
                "de": "Vegetarisch",
                "es": "Vegetariano",
                "da": "Vegetar",
                "fr": "Végétarien",
                "fi": "Kasvis",
                "nb": "Vegetar",
                "pt": "Vegetariano",
                "sv": "Vegetarisk",
                "pl": "Wegetariańskie"
              }
            }
          ],
          "ticketTypes": [],
          "onBadge": false,
          "fileTypes": [],
          "maxMegabytes": 10
        },
        {
          "id": "interests",
          "kind": "multiChoice",
          "label": {
            "en": "What are you here for?",
            "nl": "Waarvoor kom je?",
            "de": "Weshalb kommst du?",
            "es": "¿Qué te trae aquí?",
            "da": "Hvad kommer du for?",
            "fr": "Qu’est-ce qui vous amène ?",
            "fi": "Mitä varten tulet?",
            "nb": "Hva kommer du for?",
            "pt": "O que o traz cá?",
            "sv": "Vad kommer du för?",
            "pl": "Co cię tu sprowadza?"
          },
          "required": false,
          "options": [
            {
              "value": "cloud",
              "label": {
                "en": "Cloud and AI",
                "nl": "Cloud en AI",
                "de": "Cloud und KI",
                "es": "Nube e IA",
                "da": "Cloud og AI",
                "fr": "Cloud et IA",
                "fi": "Pilvi ja tekoäly",
                "nb": "Sky og KI",
                "pt": "Cloud e IA",
                "sv": "Moln och AI",
                "pl": "Chmura i AI"
              }
            },
            {
              "value": "product",
              "label": {
                "en": "Product",
                "nl": "Product",
                "de": "Produkt",
                "es": "Producto",
                "da": "Produkt",
                "fr": "Produit",
                "fi": "Tuote",
                "nb": "Produkt",
                "pt": "Produto",
                "sv": "Produkt",
                "pl": "Produkt"
              }
            }
          ],
          "ticketTypes": [],
          "onBadge": false,
          "fileTypes": [],
          "maxMegabytes": 10
        }
      ]
    },
    "paymentProvider": null,
    "updatedUtc": null,
    "format": "inPerson",
    "capabilities": {
      "doors": true,
      "badges": true,
      "screens": true,
      "venue": true,
      "selfCheckIn": true,
      "boothScanning": true,
      "boothRedemption": true,
      "walletPass": true,
      "crewOnSite": true,
      "meetingTables": true,
      "onlineAccess": false,
      "venueMap": true
    },
    "modules": [
      "payments",
      "addons"
    ],
    "modulesChosen": null,
    "online": null
  },
  "programme": {
    "rooms": [
      {
        "roomId": "b3ac0001-0000-4000-8000-000000000000",
        "name": "Main Hall",
        "location": "Ground floor, straight ahead",
        "capacity": 600,
        "sortOrder": 0
      },
      {
        "roomId": "b3ac0001-0000-4000-8000-000000000001",
        "name": "Graanbeurs",
        "location": "Ground floor, left wing",
        "capacity": 220,
        "sortOrder": 1
      }
    ],
    "tracks": [
      {
        "trackId": "b3ac0002-0000-4000-8000-000000000000",
        "name": "Cloud & AI",
        "colour": "#2b8fd0",
        "sortOrder": 0
      },
      {
        "trackId": "b3ac0002-0000-4000-8000-000000000001",
        "name": "Product",
        "colour": "#c2410c",
        "sortOrder": 1
      }
    ],
    "sessions": [
      {
        "sessionId": "b3ac0004-0000-4000-8000-000000000000",
        "title": "Registration and coffee",
        "summary": null,
        "kind": "other",
        "roomId": null,
        "trackId": null,
        "startsUtc": "2026-11-12T07:30:00.000Z",
        "endsUtc": "2026-11-12T08:30:00.000Z",
        "startsLocal": "2026-11-12T08:30",
        "endsLocal": "2026-11-12T09:30",
        "capacity": null,
        "onlineUrl": null,
        "joinProvider": null,
        "language": null,
        "speakerIds": []
      },
      {
        "sessionId": "b3ac0004-0000-4000-8000-000000000001",
        "title": "Opening keynote: software that finds its way",
        "summary": "Opening keynote: software that finds its way. What worked, what did not, and what to try on Monday.",
        "kind": "keynote",
        "roomId": "b3ac0001-0000-4000-8000-000000000000",
        "trackId": null,
        "startsUtc": "2026-11-12T08:30:00.000Z",
        "endsUtc": "2026-11-12T09:15:00.000Z",
        "startsLocal": "2026-11-12T09:30",
        "endsLocal": "2026-11-12T10:15",
        "capacity": null,
        "onlineUrl": null,
        "joinProvider": null,
        "language": null,
        "speakerIds": [
          "b3ac0003-0000-4000-8000-000000000009"
        ]
      }
    ],
    "speakers": [
      {
        "speakerId": "b3ac0003-0000-4000-8000-000000000000",
        "name": "Ada Verhoeven",
        "jobTitle": "Principal Engineer",
        "company": "Northwind Cloud",
        "bio": "Ada builds the platforms other engineers build on, and writes about what breaks.",
        "photoUrl": "/media/f0de0000000040008000000000000001/b3ac00fa000040008000000000000000.jpg",
        "email": null,
        "links": [],
        "sortOrder": 0
      },
      {
        "speakerId": "b3ac0003-0000-4000-8000-000000000001",
        "name": "Malik Osei",
        "jobTitle": "VP Product",
        "company": "Contoso",
        "bio": "Malik has shipped products in four countries and still reads every support ticket.",
        "photoUrl": "/media/f0de0000000040008000000000000001/b3ac00fa000040008000000000000001.jpg",
        "email": null,
        "links": [],
        "sortOrder": 1
      }
    ],
    "sponsors": [
      {
        "sponsorId": "b3ac0005-0000-4000-8000-000000000000",
        "name": "Northwind Cloud",
        "tier": "Platinum",
        "tierOrder": 0,
        "website": "https://northwindcloud.example",
        "logoUrl": "/media/f0de0000000040008000000000000001/b3ac00fb000040008000000000000000.png",
        "description": "The cloud for teams who would rather be building.",
        "booth": "A1",
        "sortOrder": 0
      },
      {
        "sponsorId": "b3ac0005-0000-4000-8000-000000000001",
        "name": "Contoso",
        "tier": "Gold",
        "tierOrder": 1,
        "website": "https://contoso.example",
        "logoUrl": "/media/f0de0000000040008000000000000001/b3ac00fb000040008000000000000001.png",
        "description": "Software for the way people work now.",
        "booth": "B2",
        "sortOrder": 1
      }
    ]
  },
  "ticketTypes": [
    {
      "ticketTypeId": "b3ac0006-0000-4000-8000-000000000000",
      "name": "Community pass",
      "description": "Both days, lunch included. Free for members of a local user group.",
      "price": 0,
      "vatRate": 21,
      "currency": "EUR",
      "capacity": 300,
      "taken": 24,
      "maxPerOrder": 10,
      "visibility": "public",
      "salesStartUtc": null,
      "salesEndUtc": "2026-11-13T11:00:00.000Z",
      "sortOrder": 0
    },
    {
      "ticketTypeId": "b3ac0006-0000-4000-8000-000000000001",
      "name": "Conference pass",
      "description": "Both days, lunch and drinks. A workshop seat is booked as an extra.",
      "price": 395,
      "vatRate": 21,
      "currency": "EUR",
      "capacity": 500,
      "taken": 38,
      "maxPerOrder": 10,
      "visibility": "public",
      "salesStartUtc": null,
      "salesEndUtc": "2026-11-13T11:00:00.000Z",
      "sortOrder": 1
    }
  ],
  "updatedUtc": "2026-10-14T21:40:48.036Z"
}

400 invalidBody, invalidRequest, invalidIdempotencyKey.

JSON

{
  "type": "https://attendbeacon.com/developers/errors#invalidBody",
  "title": "The body is not readable",
  "status": 400,
  "detail": "The body is not JSON, or a field has the wrong type.",
  "instance": "/api/v1/events",
  "code": "invalidBody",
  "traceId": "00-4bf92f3577b34da6a3ce929d0e0e4736-00f067aa0ba902b7-01",
  "error": "The body is not JSON, or a field has the wrong type."
}

Get an event

GET/events/{eventId}

Gets an event with its programme (rooms, tracks, sessions, speakers, sponsors) when the key reads the programme, and its ticket types when it reads tickets. Never an access code or a speaker's address.

Omfang: events:read

Svarer med en ETag; send If-None-Match for å slippe en ny nedlasting.

Parametere

sti

eventIdstring (uuid)påkrevd
The event's id.

header

If-None-Matchstring
The ETag you have: when it is still current the answer is 304 with no body.

Svar

200 The event. EventDetail
Felt
- eventobject
  The event as its public page shows it, with its registration questions and theme as well.
  Vis feltene
  - eventIdstring (uuid)
    The event's id.
  - slugstring
    The event's address: /e/{slug}.
  - namestring
    The event's name.
  - statusstring
    Draft, published or closed.
  - startDatestring (date)
    The first day, in the venue's time zone.
  - endDatestring (date)
    The last day, in the venue's time zone.
  - timeZonestring
    The venue's time zone, such as Europe/Amsterdam.
  - venueNamestring
    Where it is.
  - venueAddressstring
    The venue's address.
  - summarystring
    A line about the event.
  - descriptionstring
    What the event is about.
  - languagesstring[]
    The event's languages, such as en and nl.
  - currencystring
    The currency, as ISO 4217.
  - contactEmailstring (email)
    The organiser's contact address.
  - formatstring
    In person, online or hybrid.
- programmeobject eller null
  Rooms, tracks, sessions, speakers and sponsors. Null without program:read.
  Vis feltene
  - roomsobject[]
    The rooms.
    Vis feltene
    roomIdstring (uuid)
    The room's id.
    namestring
    The room's name.
    locationstring
    Where the room is.
    capacityinteger
    How many it seats.
  - tracksobject[]
    The tracks.
    Vis feltene
    trackIdstring (uuid)
    The track's id.
    namestring
    The track's name.
    colourstring
    The track's colour.
  - sessionsobject[]
    The sessions.
    Vis feltene
    sessionIdstring (uuid)
    The session's id.
    titlestring
    The session's title.
    summarystring
    What it is about.
    kindstring
    Talk, workshop, break and others.
    roomIdstring (uuid)
    The room's id.
    trackIdstring (uuid)
    The track's id.
    startsUtcstring (date-time)
    When it starts, in UTC.
    endsUtcstring (date-time)
    When it ends, in UTC.
    startsLocalstring
    When it starts, in the venue's time.
    endsLocalstring
    When it ends, in the venue's time.
    capacityinteger
    How many it seats, when fewer than its room.
    languagestring
    The language it is given in.
  - speakersobject[]
    The speakers.
    Vis feltene
    speakerIdstring (uuid)
    The speaker's id.
    namestring
    The speaker's name.
    jobTitlestring
    Their job title.
    companystring
    Their company.
    biostring
    About them.
    photoUrlstring
    Their photo's address.
  - sponsorsobject[]
    The sponsors.
    Vis feltene
    sponsorIdstring (uuid)
    The sponsor's id.
    namestring
    The sponsor's name.
    tierstring
    Their sponsorship level.
    websitestring
    Their website.
    boothstring
    Their stand.
- ticketTypesTicketType[] eller null
  The ticket types and what is sold. Null without tickets:read.
  Vis feltene
  - ticketTypeIdstring (uuid)
    The ticket type's id.
  - namestring
    Its name.
  - descriptionstring
    What it includes.
  - pricenumber
    The price, VAT included, with the currency's own decimals.
  - vatRatenumber
    The VAT rate, as a percentage.
  - currencystring
    The currency, as ISO 4217.
  - capacityinteger eller null
    How many may be sold, when limited.
  - takeninteger
    How many are taken.
  - maxPerOrderinteger
    The most one order may hold.
  - visibilitystring
    Public, code (sold with an access code) or hidden.
    Én av: public, code, hidden
  - salesStartUtcstring (date-time)
    When sales start, in UTC.
  - salesEndUtcstring (date-time)
    When sales end, in UTC.
  - sortOrderinteger
    Its place in the list.
  - eventIdstring (uuid)
    The event's id.
  - remaininginteger (int32) eller null
    Places left, or null without a limit.
  - requiresApprovalboolean
    Whether an order for it waits for the organiser's approval.
  - salesStartLocalstring eller null
    When sales start, in the venue's time.
  - salesEndLocalstring eller null
    When sales end, in the venue's time.
  - includedAddOnIdsstring (uuid)[]
    The add-ons it includes, as a bundle.
  - updatedUtcstring (date-time) eller null
    When it last changed, in UTC.
- updatedUtcstring (date-time)
  When the event's basics last changed, in UTC.
304 Not modified: If-None-Match named the representation as it is.
401 invalidKey, keyExpired, keyRevoked.
403 missingScope.
404 eventNotFound.
429 rateLimited.

Avvisninger

invalidKey keyExpired keyRevoked rateLimited missingScope eventNotFound

Forespørsel

curl "https://attendbeacon.com/api/v1/events/b3ac0000-0000-4000-8000-000000000001" \
  -H "Authorization: Bearer $ATTENDBEACON_KEY"

const response = await fetch("https://attendbeacon.com/api/v1/events/b3ac0000-0000-4000-8000-000000000001", {
  headers: {
    Authorization: `Bearer ${process.env.ATTENDBEACON_KEY}`
  }
});
if (!response.ok) throw new Error((await response.json()).detail);
const data = await response.json();

using System.Net.Http.Headers;
using System.Text;

using var client = new HttpClient();
client.DefaultRequestHeaders.Authorization = new AuthenticationHeaderValue("Bearer", Environment.GetEnvironmentVariable("ATTENDBEACON_KEY"));

using var request = new HttpRequestMessage(HttpMethod.Get, "https://attendbeacon.com/api/v1/events/b3ac0000-0000-4000-8000-000000000001");

using var response = await client.SendAsync(request);
response.EnsureSuccessStatusCode();
var json = await response.Content.ReadAsStringAsync();

import os
import requests

response = requests.get(
    "https://attendbeacon.com/api/v1/events/b3ac0000-0000-4000-8000-000000000001",
    headers={
        "Authorization": f"Bearer {os.environ['ATTENDBEACON_KEY']}"
    }
)
response.raise_for_status()
data = response.json()

$headers = @{
    Authorization = "Bearer $env:ATTENDBEACON_KEY"
}

$data = Invoke-RestMethod -Method Get -Uri "https://attendbeacon.com/api/v1/events/b3ac0000-0000-4000-8000-000000000001" -Headers $headers

200 Eksempelsvar

JSON

{
  "event": {
    "eventId": "b3ac0000-0000-4000-8000-000000000001",
    "slug": "beacon-summit",
    "name": "Beacon Summit",
    "status": "published",
    "startDate": "2026-11-12",
    "endDate": "2026-11-13",
    "timeZone": "Europe/Amsterdam",
    "venueName": "Beurs van Berlage",
    "venueAddress": "Damrak 243, 1012 ZJ Amsterdam",
    "summary": "Two days on building, shipping and running software, in the old stock exchange on the Damrak.",
    "description": "Beacon Summit brings together the people who build software and the people who run it. Two days, four rooms, thirty sessions, and a long table for lunch.\n\n**Bring your laptop** for the workshops on day two.",
    "languages": [
      "en",
      "nl"
    ],
    "currency": "EUR",
    "contactEmail": "hello@beaconsummit.example",
    "theme": {
      "accent": "#4338ca",
      "highlight": "#f59e0b",
      "darkAccent": "#a5b4fc",
      "darkHighlight": "#fbbf24",
      "background": null,
      "surface": null,
      "mode": "auto",
      "font": "Inter",
      "headingFont": "Sora",
      "headingWeight": "heavy",
      "headingSpacing": "tight",
      "radius": 16,
      "buttonStyle": "filled",
      "buttonShape": "pill",
      "cardStyle": "glass",
      "headerStyle": "transparent",
      "logoUrl": null,
      "logoDarkUrl": null,
      "logoSize": "medium",
      "iconUrl": null,
      "heroUrl": "/media/f0de0000000040008000000000000001/b3ac001e000040008000000000000000.jpg",
      "heroLayout": "image",
      "heroVideoUrl": null,
      "heroOverlay": 50,
      "countdown": true,
      "backgroundStyle": "aurora",
      "pattern": "beacons",
      "backgroundUrl": null,
      "backgroundOverlay": 75,
      "motion": "subtle",
      "preset": null,
      "customCss": null,
      "accentInk": "#ffffff",
      "highlightInk": "#0f1b2d"
    },
    "registration": {
      "schemaVersion": 1,
      "askCompany": true,
      "askJobTitle": true,
      "companyRequired": false,
      "askSponsorConsent": true,
      "questions": [
        {
          "id": "dietary",
          "kind": "choice",
          "label": {
            "en": "Dietary requirements",
            "nl": "Dieetwensen",
            "de": "Ernährungswünsche",
            "es": "Requisitos alimentarios",
            "da": "Kostbehov",
            "fr": "Régime alimentaire",
            "fi": "Ruokavalio",
            "nb": "Kostbehov",
            "pt": "Restrições alimentares",
            "sv": "Kostönskemål",
            "pl": "Wymagania dietetyczne"
          },
          "required": false,
          "options": [
            {
              "value": "none",
              "label": {
                "en": "None",
                "nl": "Geen",
                "de": "Keine",
                "es": "Ninguno",
                "da": "Ingen",
                "fr": "Aucun",
                "fi": "Ei mitään",
                "nb": "Ingen",
                "pt": "Nenhuma",
                "sv": "Inga",
                "pl": "Brak"
              }
            },
            {
              "value": "vegetarian",
              "label": {
                "en": "Vegetarian",
                "nl": "Vegetarisch",
                "de": "Vegetarisch",
                "es": "Vegetariano",
                "da": "Vegetar",
                "fr": "Végétarien",
                "fi": "Kasvis",
                "nb": "Vegetar",
                "pt": "Vegetariano",
                "sv": "Vegetarisk",
                "pl": "Wegetariańskie"
              }
            }
          ],
          "ticketTypes": [],
          "onBadge": false,
          "fileTypes": [],
          "maxMegabytes": 10
        },
        {
          "id": "interests",
          "kind": "multiChoice",
          "label": {
            "en": "What are you here for?",
            "nl": "Waarvoor kom je?",
            "de": "Weshalb kommst du?",
            "es": "¿Qué te trae aquí?",
            "da": "Hvad kommer du for?",
            "fr": "Qu’est-ce qui vous amène ?",
            "fi": "Mitä varten tulet?",
            "nb": "Hva kommer du for?",
            "pt": "O que o traz cá?",
            "sv": "Vad kommer du för?",
            "pl": "Co cię tu sprowadza?"
          },
          "required": false,
          "options": [
            {
              "value": "cloud",
              "label": {
                "en": "Cloud and AI",
                "nl": "Cloud en AI",
                "de": "Cloud und KI",
                "es": "Nube e IA",
                "da": "Cloud og AI",
                "fr": "Cloud et IA",
                "fi": "Pilvi ja tekoäly",
                "nb": "Sky og KI",
                "pt": "Cloud e IA",
                "sv": "Moln och AI",
                "pl": "Chmura i AI"
              }
            },
            {
              "value": "product",
              "label": {
                "en": "Product",
                "nl": "Product",
                "de": "Produkt",
                "es": "Producto",
                "da": "Produkt",
                "fr": "Produit",
                "fi": "Tuote",
                "nb": "Produkt",
                "pt": "Produto",
                "sv": "Produkt",
                "pl": "Produkt"
              }
            }
          ],
          "ticketTypes": [],
          "onBadge": false,
          "fileTypes": [],
          "maxMegabytes": 10
        }
      ]
    },
    "paymentProvider": null,
    "updatedUtc": null,
    "format": "inPerson",
    "capabilities": {
      "doors": true,
      "badges": true,
      "screens": true,
      "venue": true,
      "selfCheckIn": true,
      "boothScanning": true,
      "boothRedemption": true,
      "walletPass": true,
      "crewOnSite": true,
      "meetingTables": true,
      "onlineAccess": false,
      "venueMap": true
    },
    "modules": [
      "payments",
      "addons"
    ],
    "modulesChosen": null,
    "online": null
  },
  "programme": {
    "rooms": [
      {
        "roomId": "b3ac0001-0000-4000-8000-000000000000",
        "name": "Main Hall",
        "location": "Ground floor, straight ahead",
        "capacity": 600,
        "sortOrder": 0
      },
      {
        "roomId": "b3ac0001-0000-4000-8000-000000000001",
        "name": "Graanbeurs",
        "location": "Ground floor, left wing",
        "capacity": 220,
        "sortOrder": 1
      }
    ],
    "tracks": [
      {
        "trackId": "b3ac0002-0000-4000-8000-000000000000",
        "name": "Cloud & AI",
        "colour": "#2b8fd0",
        "sortOrder": 0
      },
      {
        "trackId": "b3ac0002-0000-4000-8000-000000000001",
        "name": "Product",
        "colour": "#c2410c",
        "sortOrder": 1
      }
    ],
    "sessions": [
      {
        "sessionId": "b3ac0004-0000-4000-8000-000000000000",
        "title": "Registration and coffee",
        "summary": null,
        "kind": "other",
        "roomId": null,
        "trackId": null,
        "startsUtc": "2026-11-12T07:30:00.000Z",
        "endsUtc": "2026-11-12T08:30:00.000Z",
        "startsLocal": "2026-11-12T08:30",
        "endsLocal": "2026-11-12T09:30",
        "capacity": null,
        "onlineUrl": null,
        "joinProvider": null,
        "language": null,
        "speakerIds": []
      },
      {
        "sessionId": "b3ac0004-0000-4000-8000-000000000001",
        "title": "Opening keynote: software that finds its way",
        "summary": "Opening keynote: software that finds its way. What worked, what did not, and what to try on Monday.",
        "kind": "keynote",
        "roomId": "b3ac0001-0000-4000-8000-000000000000",
        "trackId": null,
        "startsUtc": "2026-11-12T08:30:00.000Z",
        "endsUtc": "2026-11-12T09:15:00.000Z",
        "startsLocal": "2026-11-12T09:30",
        "endsLocal": "2026-11-12T10:15",
        "capacity": null,
        "onlineUrl": null,
        "joinProvider": null,
        "language": null,
        "speakerIds": [
          "b3ac0003-0000-4000-8000-000000000009"
        ]
      }
    ],
    "speakers": [
      {
        "speakerId": "b3ac0003-0000-4000-8000-000000000000",
        "name": "Ada Verhoeven",
        "jobTitle": "Principal Engineer",
        "company": "Northwind Cloud",
        "bio": "Ada builds the platforms other engineers build on, and writes about what breaks.",
        "photoUrl": "/media/f0de0000000040008000000000000001/b3ac00fa000040008000000000000000.jpg",
        "email": null,
        "links": [],
        "sortOrder": 0
      },
      {
        "speakerId": "b3ac0003-0000-4000-8000-000000000001",
        "name": "Malik Osei",
        "jobTitle": "VP Product",
        "company": "Contoso",
        "bio": "Malik has shipped products in four countries and still reads every support ticket.",
        "photoUrl": "/media/f0de0000000040008000000000000001/b3ac00fa000040008000000000000001.jpg",
        "email": null,
        "links": [],
        "sortOrder": 1
      }
    ],
    "sponsors": [
      {
        "sponsorId": "b3ac0005-0000-4000-8000-000000000000",
        "name": "Northwind Cloud",
        "tier": "Platinum",
        "tierOrder": 0,
        "website": "https://northwindcloud.example",
        "logoUrl": "/media/f0de0000000040008000000000000001/b3ac00fb000040008000000000000000.png",
        "description": "The cloud for teams who would rather be building.",
        "booth": "A1",
        "sortOrder": 0
      },
      {
        "sponsorId": "b3ac0005-0000-4000-8000-000000000001",
        "name": "Contoso",
        "tier": "Gold",
        "tierOrder": 1,
        "website": "https://contoso.example",
        "logoUrl": "/media/f0de0000000040008000000000000001/b3ac00fb000040008000000000000001.png",
        "description": "Software for the way people work now.",
        "booth": "B2",
        "sortOrder": 1
      }
    ]
  },
  "ticketTypes": [
    {
      "ticketTypeId": "b3ac0006-0000-4000-8000-000000000000",
      "name": "Community pass",
      "description": "Both days, lunch included. Free for members of a local user group.",
      "price": 0,
      "vatRate": 21,
      "currency": "EUR",
      "capacity": 300,
      "taken": 24,
      "maxPerOrder": 10,
      "visibility": "public",
      "salesStartUtc": null,
      "salesEndUtc": "2026-11-13T11:00:00.000Z",
      "sortOrder": 0
    },
    {
      "ticketTypeId": "b3ac0006-0000-4000-8000-000000000001",
      "name": "Conference pass",
      "description": "Both days, lunch and drinks. A workshop seat is booked as an extra.",
      "price": 395,
      "vatRate": 21,
      "currency": "EUR",
      "capacity": 500,
      "taken": 38,
      "maxPerOrder": 10,
      "visibility": "public",
      "salesStartUtc": null,
      "salesEndUtc": "2026-11-13T11:00:00.000Z",
      "sortOrder": 1
    }
  ],
  "updatedUtc": "2026-10-14T21:40:48.036Z"
}

401 invalidKey, keyExpired, keyRevoked.

JSON

{
  "type": "https://attendbeacon.com/developers/errors#invalidKey",
  "title": "No working API key",
  "status": 401,
  "detail": "No key was sent, or it is not one this platform made. Send it as Authorization: Bearer abk_... or in X-Api-Key.",
  "instance": "/api/v1/events/b3ac0000-0000-4000-8000-000000000001",
  "code": "invalidKey",
  "traceId": "00-4bf92f3577b34da6a3ce929d0e0e4736-00f067aa0ba902b7-01",
  "error": "No key was sent, or it is not one this platform made. Send it as Authorization: Bearer abk_... or in X-Api-Key."
}

Change an event Endrer data

PATCH/events/{eventId}

Changes an event's basics as a JSON merge patch: name, dates, time zone, venue, summary, description, contact address, languages. Send If-Match with the ETag you read, so a change made in between is not overwritten.

Omfang: events:write

Send If-Match med ETag-en du leste, slik at en endring i mellomtiden ikke overskrives.

Parametere

sti

eventIdstring (uuid)påkrevd
The event's id.

header

If-Matchstring
The ETag you read, so a change made since is refused (412) rather than overwritten.

Innhold EventPatch

The fields to change.

namestring
Its name.
startDatestring (date)
The first day, at the venue.
endDatestring (date)
The last day, at the venue.
timeZonestring
The venue's IANA time zone.
slugstring
Its address after /e/. Changing it breaks links people already have.
venueNamestring eller null
Where it takes place.
venueAddressstring eller null
The venue's address.
summarystring eller null
One or two sentences about it.
descriptionstring eller null
What it is about, in Markdown.
contactEmailstring eller null
Where attendees' questions go.
languagesstring[]
Its languages, the first the default.

Svar

200 The event as it is now. EventDetail
Felt
- eventobject
  The event as its public page shows it, with its registration questions and theme as well.
  Vis feltene
  - eventIdstring (uuid)
    The event's id.
  - slugstring
    The event's address: /e/{slug}.
  - namestring
    The event's name.
  - statusstring
    Draft, published or closed.
  - startDatestring (date)
    The first day, in the venue's time zone.
  - endDatestring (date)
    The last day, in the venue's time zone.
  - timeZonestring
    The venue's time zone, such as Europe/Amsterdam.
  - venueNamestring
    Where it is.
  - venueAddressstring
    The venue's address.
  - summarystring
    A line about the event.
  - descriptionstring
    What the event is about.
  - languagesstring[]
    The event's languages, such as en and nl.
  - currencystring
    The currency, as ISO 4217.
  - contactEmailstring (email)
    The organiser's contact address.
  - formatstring
    In person, online or hybrid.
- programmeobject eller null
  Rooms, tracks, sessions, speakers and sponsors. Null without program:read.
  Vis feltene
  - roomsobject[]
    The rooms.
    Vis feltene
    roomIdstring (uuid)
    The room's id.
    namestring
    The room's name.
    locationstring
    Where the room is.
    capacityinteger
    How many it seats.
  - tracksobject[]
    The tracks.
    Vis feltene
    trackIdstring (uuid)
    The track's id.
    namestring
    The track's name.
    colourstring
    The track's colour.
  - sessionsobject[]
    The sessions.
    Vis feltene
    sessionIdstring (uuid)
    The session's id.
    titlestring
    The session's title.
    summarystring
    What it is about.
    kindstring
    Talk, workshop, break and others.
    roomIdstring (uuid)
    The room's id.
    trackIdstring (uuid)
    The track's id.
    startsUtcstring (date-time)
    When it starts, in UTC.
    endsUtcstring (date-time)
    When it ends, in UTC.
    startsLocalstring
    When it starts, in the venue's time.
    endsLocalstring
    When it ends, in the venue's time.
    capacityinteger
    How many it seats, when fewer than its room.
    languagestring
    The language it is given in.
  - speakersobject[]
    The speakers.
    Vis feltene
    speakerIdstring (uuid)
    The speaker's id.
    namestring
    The speaker's name.
    jobTitlestring
    Their job title.
    companystring
    Their company.
    biostring
    About them.
    photoUrlstring
    Their photo's address.
  - sponsorsobject[]
    The sponsors.
    Vis feltene
    sponsorIdstring (uuid)
    The sponsor's id.
    namestring
    The sponsor's name.
    tierstring
    Their sponsorship level.
    websitestring
    Their website.
    boothstring
    Their stand.
- ticketTypesTicketType[] eller null
  The ticket types and what is sold. Null without tickets:read.
  Vis feltene
  - ticketTypeIdstring (uuid)
    The ticket type's id.
  - namestring
    Its name.
  - descriptionstring
    What it includes.
  - pricenumber
    The price, VAT included, with the currency's own decimals.
  - vatRatenumber
    The VAT rate, as a percentage.
  - currencystring
    The currency, as ISO 4217.
  - capacityinteger eller null
    How many may be sold, when limited.
  - takeninteger
    How many are taken.
  - maxPerOrderinteger
    The most one order may hold.
  - visibilitystring
    Public, code (sold with an access code) or hidden.
    Én av: public, code, hidden
  - salesStartUtcstring (date-time)
    When sales start, in UTC.
  - salesEndUtcstring (date-time)
    When sales end, in UTC.
  - sortOrderinteger
    Its place in the list.
  - eventIdstring (uuid)
    The event's id.
  - remaininginteger (int32) eller null
    Places left, or null without a limit.
  - requiresApprovalboolean
    Whether an order for it waits for the organiser's approval.
  - salesStartLocalstring eller null
    When sales start, in the venue's time.
  - salesEndLocalstring eller null
    When sales end, in the venue's time.
  - includedAddOnIdsstring (uuid)[]
    The add-ons it includes, as a bundle.
  - updatedUtcstring (date-time) eller null
    When it last changed, in UTC.
- updatedUtcstring (date-time)
  When the event's basics last changed, in UTC.
400 invalidBody, invalidRequest.
401 invalidKey, keyExpired, keyRevoked.
403 missingScope, demoWorkspace.
404 eventNotFound.
409 slugTaken.
412 preconditionFailed.
429 rateLimited.

Avvisninger

invalidKey keyExpired keyRevoked rateLimited missingScope eventNotFound invalidBody invalidRequest demoWorkspace preconditionFailed slugTaken

Forespørsel

curl -X PATCH "https://attendbeacon.com/api/v1/events/b3ac0000-0000-4000-8000-000000000001" \
  -H "Authorization: Bearer $ATTENDBEACON_KEY" \
  -H "If-Match: $ETAG" \
  -H "Content-Type: application/json" \
  -d '{
  "venueName": "Beurs van Berlage",
  "summary": "Two days of cloud, data and AI in Amsterdam."
}'

const response = await fetch("https://attendbeacon.com/api/v1/events/b3ac0000-0000-4000-8000-000000000001", {
  method: "PATCH",
  headers: {
    Authorization: `Bearer ${process.env.ATTENDBEACON_KEY}`,
    "If-Match": etag,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "venueName": "Beurs van Berlage",
    "summary": "Two days of cloud, data and AI in Amsterdam."
  })
});
if (!response.ok) throw new Error((await response.json()).detail);
const data = await response.json();

using System.Net.Http.Headers;
using System.Text;

using var client = new HttpClient();
client.DefaultRequestHeaders.Authorization = new AuthenticationHeaderValue("Bearer", Environment.GetEnvironmentVariable("ATTENDBEACON_KEY"));

using var request = new HttpRequestMessage(HttpMethod.Patch, "https://attendbeacon.com/api/v1/events/b3ac0000-0000-4000-8000-000000000001");
request.Headers.IfMatch.Add(new EntityTagHeaderValue(etag));
request.Content = new StringContent("""
{
  "venueName": "Beurs van Berlage",
  "summary": "Two days of cloud, data and AI in Amsterdam."
}
""", Encoding.UTF8, "application/json");

using var response = await client.SendAsync(request);
response.EnsureSuccessStatusCode();
var json = await response.Content.ReadAsStringAsync();

import os
import requests

response = requests.patch(
    "https://attendbeacon.com/api/v1/events/b3ac0000-0000-4000-8000-000000000001",
    headers={
        "Authorization": f"Bearer {os.environ['ATTENDBEACON_KEY']}",
        "If-Match": etag
    },
    json={
        "venueName": "Beurs van Berlage",
        "summary": "Two days of cloud, data and AI in Amsterdam."
    }
)
response.raise_for_status()
data = response.json()

$headers = @{
    Authorization = "Bearer $env:ATTENDBEACON_KEY"
    "If-Match" = $etag
}
$body = @'
{
  "venueName": "Beurs van Berlage",
  "summary": "Two days of cloud, data and AI in Amsterdam."
}
'@

$data = Invoke-RestMethod -Method Patch -Uri "https://attendbeacon.com/api/v1/events/b3ac0000-0000-4000-8000-000000000001" -Headers $headers -ContentType "application/json" -Body $body

200 Eksempelsvar

JSON

{
  "event": {
    "eventId": "b3ac0000-0000-4000-8000-000000000001",
    "slug": "beacon-summit",
    "name": "Beacon Summit",
    "status": "published",
    "startDate": "2026-11-12",
    "endDate": "2026-11-13",
    "timeZone": "Europe/Amsterdam",
    "venueName": "Beurs van Berlage",
    "venueAddress": "Damrak 243, 1012 ZJ Amsterdam",
    "summary": "Two days on building, shipping and running software, in the old stock exchange on the Damrak.",
    "description": "Beacon Summit brings together the people who build software and the people who run it. Two days, four rooms, thirty sessions, and a long table for lunch.\n\n**Bring your laptop** for the workshops on day two.",
    "languages": [
      "en",
      "nl"
    ],
    "currency": "EUR",
    "contactEmail": "hello@beaconsummit.example",
    "theme": {
      "accent": "#4338ca",
      "highlight": "#f59e0b",
      "darkAccent": "#a5b4fc",
      "darkHighlight": "#fbbf24",
      "background": null,
      "surface": null,
      "mode": "auto",
      "font": "Inter",
      "headingFont": "Sora",
      "headingWeight": "heavy",
      "headingSpacing": "tight",
      "radius": 16,
      "buttonStyle": "filled",
      "buttonShape": "pill",
      "cardStyle": "glass",
      "headerStyle": "transparent",
      "logoUrl": null,
      "logoDarkUrl": null,
      "logoSize": "medium",
      "iconUrl": null,
      "heroUrl": "/media/f0de0000000040008000000000000001/b3ac001e000040008000000000000000.jpg",
      "heroLayout": "image",
      "heroVideoUrl": null,
      "heroOverlay": 50,
      "countdown": true,
      "backgroundStyle": "aurora",
      "pattern": "beacons",
      "backgroundUrl": null,
      "backgroundOverlay": 75,
      "motion": "subtle",
      "preset": null,
      "customCss": null,
      "accentInk": "#ffffff",
      "highlightInk": "#0f1b2d"
    },
    "registration": {
      "schemaVersion": 1,
      "askCompany": true,
      "askJobTitle": true,
      "companyRequired": false,
      "askSponsorConsent": true,
      "questions": [
        {
          "id": "dietary",
          "kind": "choice",
          "label": {
            "en": "Dietary requirements",
            "nl": "Dieetwensen",
            "de": "Ernährungswünsche",
            "es": "Requisitos alimentarios",
            "da": "Kostbehov",
            "fr": "Régime alimentaire",
            "fi": "Ruokavalio",
            "nb": "Kostbehov",
            "pt": "Restrições alimentares",
            "sv": "Kostönskemål",
            "pl": "Wymagania dietetyczne"
          },
          "required": false,
          "options": [
            {
              "value": "none",
              "label": {
                "en": "None",
                "nl": "Geen",
                "de": "Keine",
                "es": "Ninguno",
                "da": "Ingen",
                "fr": "Aucun",
                "fi": "Ei mitään",
                "nb": "Ingen",
                "pt": "Nenhuma",
                "sv": "Inga",
                "pl": "Brak"
              }
            },
            {
              "value": "vegetarian",
              "label": {
                "en": "Vegetarian",
                "nl": "Vegetarisch",
                "de": "Vegetarisch",
                "es": "Vegetariano",
                "da": "Vegetar",
                "fr": "Végétarien",
                "fi": "Kasvis",
                "nb": "Vegetar",
                "pt": "Vegetariano",
                "sv": "Vegetarisk",
                "pl": "Wegetariańskie"
              }
            }
          ],
          "ticketTypes": [],
          "onBadge": false,
          "fileTypes": [],
          "maxMegabytes": 10
        },
        {
          "id": "interests",
          "kind": "multiChoice",
          "label": {
            "en": "What are you here for?",
            "nl": "Waarvoor kom je?",
            "de": "Weshalb kommst du?",
            "es": "¿Qué te trae aquí?",
            "da": "Hvad kommer du for?",
            "fr": "Qu’est-ce qui vous amène ?",
            "fi": "Mitä varten tulet?",
            "nb": "Hva kommer du for?",
            "pt": "O que o traz cá?",
            "sv": "Vad kommer du för?",
            "pl": "Co cię tu sprowadza?"
          },
          "required": false,
          "options": [
            {
              "value": "cloud",
              "label": {
                "en": "Cloud and AI",
                "nl": "Cloud en AI",
                "de": "Cloud und KI",
                "es": "Nube e IA",
                "da": "Cloud og AI",
                "fr": "Cloud et IA",
                "fi": "Pilvi ja tekoäly",
                "nb": "Sky og KI",
                "pt": "Cloud e IA",
                "sv": "Moln och AI",
                "pl": "Chmura i AI"
              }
            },
            {
              "value": "product",
              "label": {
                "en": "Product",
                "nl": "Product",
                "de": "Produkt",
                "es": "Producto",
                "da": "Produkt",
                "fr": "Produit",
                "fi": "Tuote",
                "nb": "Produkt",
                "pt": "Produto",
                "sv": "Produkt",
                "pl": "Produkt"
              }
            }
          ],
          "ticketTypes": [],
          "onBadge": false,
          "fileTypes": [],
          "maxMegabytes": 10
        }
      ]
    },
    "paymentProvider": null,
    "updatedUtc": null,
    "format": "inPerson",
    "capabilities": {
      "doors": true,
      "badges": true,
      "screens": true,
      "venue": true,
      "selfCheckIn": true,
      "boothScanning": true,
      "boothRedemption": true,
      "walletPass": true,
      "crewOnSite": true,
      "meetingTables": true,
      "onlineAccess": false,
      "venueMap": true
    },
    "modules": [
      "payments",
      "addons"
    ],
    "modulesChosen": null,
    "online": null
  },
  "programme": {
    "rooms": [
      {
        "roomId": "b3ac0001-0000-4000-8000-000000000000",
        "name": "Main Hall",
        "location": "Ground floor, straight ahead",
        "capacity": 600,
        "sortOrder": 0
      },
      {
        "roomId": "b3ac0001-0000-4000-8000-000000000001",
        "name": "Graanbeurs",
        "location": "Ground floor, left wing",
        "capacity": 220,
        "sortOrder": 1
      }
    ],
    "tracks": [
      {
        "trackId": "b3ac0002-0000-4000-8000-000000000000",
        "name": "Cloud & AI",
        "colour": "#2b8fd0",
        "sortOrder": 0
      },
      {
        "trackId": "b3ac0002-0000-4000-8000-000000000001",
        "name": "Product",
        "colour": "#c2410c",
        "sortOrder": 1
      }
    ],
    "sessions": [
      {
        "sessionId": "b3ac0004-0000-4000-8000-000000000000",
        "title": "Registration and coffee",
        "summary": null,
        "kind": "other",
        "roomId": null,
        "trackId": null,
        "startsUtc": "2026-11-12T07:30:00.000Z",
        "endsUtc": "2026-11-12T08:30:00.000Z",
        "startsLocal": "2026-11-12T08:30",
        "endsLocal": "2026-11-12T09:30",
        "capacity": null,
        "onlineUrl": null,
        "joinProvider": null,
        "language": null,
        "speakerIds": []
      },
      {
        "sessionId": "b3ac0004-0000-4000-8000-000000000001",
        "title": "Opening keynote: software that finds its way",
        "summary": "Opening keynote: software that finds its way. What worked, what did not, and what to try on Monday.",
        "kind": "keynote",
        "roomId": "b3ac0001-0000-4000-8000-000000000000",
        "trackId": null,
        "startsUtc": "2026-11-12T08:30:00.000Z",
        "endsUtc": "2026-11-12T09:15:00.000Z",
        "startsLocal": "2026-11-12T09:30",
        "endsLocal": "2026-11-12T10:15",
        "capacity": null,
        "onlineUrl": null,
        "joinProvider": null,
        "language": null,
        "speakerIds": [
          "b3ac0003-0000-4000-8000-000000000009"
        ]
      }
    ],
    "speakers": [
      {
        "speakerId": "b3ac0003-0000-4000-8000-000000000000",
        "name": "Ada Verhoeven",
        "jobTitle": "Principal Engineer",
        "company": "Northwind Cloud",
        "bio": "Ada builds the platforms other engineers build on, and writes about what breaks.",
        "photoUrl": "/media/f0de0000000040008000000000000001/b3ac00fa000040008000000000000000.jpg",
        "email": null,
        "links": [],
        "sortOrder": 0
      },
      {
        "speakerId": "b3ac0003-0000-4000-8000-000000000001",
        "name": "Malik Osei",
        "jobTitle": "VP Product",
        "company": "Contoso",
        "bio": "Malik has shipped products in four countries and still reads every support ticket.",
        "photoUrl": "/media/f0de0000000040008000000000000001/b3ac00fa000040008000000000000001.jpg",
        "email": null,
        "links": [],
        "sortOrder": 1
      }
    ],
    "sponsors": [
      {
        "sponsorId": "b3ac0005-0000-4000-8000-000000000000",
        "name": "Northwind Cloud",
        "tier": "Platinum",
        "tierOrder": 0,
        "website": "https://northwindcloud.example",
        "logoUrl": "/media/f0de0000000040008000000000000001/b3ac00fb000040008000000000000000.png",
        "description": "The cloud for teams who would rather be building.",
        "booth": "A1",
        "sortOrder": 0
      },
      {
        "sponsorId": "b3ac0005-0000-4000-8000-000000000001",
        "name": "Contoso",
        "tier": "Gold",
        "tierOrder": 1,
        "website": "https://contoso.example",
        "logoUrl": "/media/f0de0000000040008000000000000001/b3ac00fb000040008000000000000001.png",
        "description": "Software for the way people work now.",
        "booth": "B2",
        "sortOrder": 1
      }
    ]
  },
  "ticketTypes": [
    {
      "ticketTypeId": "b3ac0006-0000-4000-8000-000000000000",
      "name": "Community pass",
      "description": "Both days, lunch included. Free for members of a local user group.",
      "price": 0,
      "vatRate": 21,
      "currency": "EUR",
      "capacity": 300,
      "taken": 24,
      "maxPerOrder": 10,
      "visibility": "public",
      "salesStartUtc": null,
      "salesEndUtc": "2026-11-13T11:00:00.000Z",
      "sortOrder": 0
    },
    {
      "ticketTypeId": "b3ac0006-0000-4000-8000-000000000001",
      "name": "Conference pass",
      "description": "Both days, lunch and drinks. A workshop seat is booked as an extra.",
      "price": 395,
      "vatRate": 21,
      "currency": "EUR",
      "capacity": 500,
      "taken": 38,
      "maxPerOrder": 10,
      "visibility": "public",
      "salesStartUtc": null,
      "salesEndUtc": "2026-11-13T11:00:00.000Z",
      "sortOrder": 1
    }
  ],
  "updatedUtc": "2026-10-14T21:40:48.036Z"
}

400 invalidBody, invalidRequest.

JSON

{
  "type": "https://attendbeacon.com/developers/errors#invalidBody",
  "title": "The body is not readable",
  "status": 400,
  "detail": "The body is not JSON, or a field has the wrong type.",
  "instance": "/api/v1/events/b3ac0000-0000-4000-8000-000000000001",
  "code": "invalidBody",
  "traceId": "00-4bf92f3577b34da6a3ce929d0e0e4736-00f067aa0ba902b7-01",
  "error": "The body is not JSON, or a field has the wrong type."
}

Publish or unpublish an event Endrer data

PUT/events/{eventId}/status

Publishes an event, takes it back to draft or closes it, by the workspace's rules. Publishing makes its page public and opens registration as its ticket types allow.

Omfang: events:write

Send If-Match med ETag-en du leste, slik at en endring i mellomtiden ikke overskrives.

Parametere

sti

eventIdstring (uuid)påkrevd
The event's id.

header

If-Matchstring
The ETag you read, so a change made since is refused (412) rather than overwritten.

Innhold EventStatusChange

The status.

statusstringpåkrevd
Draft (only the workspace sees it), published (its page is public and registration follows its ticket types) or closed (over: the page stays, registration stops).
Én av: draft, published, closed

Svar

200 The event as it is now. EventDetail
Felt
- eventobject
  The event as its public page shows it, with its registration questions and theme as well.
  Vis feltene
  - eventIdstring (uuid)
    The event's id.
  - slugstring
    The event's address: /e/{slug}.
  - namestring
    The event's name.
  - statusstring
    Draft, published or closed.
  - startDatestring (date)
    The first day, in the venue's time zone.
  - endDatestring (date)
    The last day, in the venue's time zone.
  - timeZonestring
    The venue's time zone, such as Europe/Amsterdam.
  - venueNamestring
    Where it is.
  - venueAddressstring
    The venue's address.
  - summarystring
    A line about the event.
  - descriptionstring
    What the event is about.
  - languagesstring[]
    The event's languages, such as en and nl.
  - currencystring
    The currency, as ISO 4217.
  - contactEmailstring (email)
    The organiser's contact address.
  - formatstring
    In person, online or hybrid.
- programmeobject eller null
  Rooms, tracks, sessions, speakers and sponsors. Null without program:read.
  Vis feltene
  - roomsobject[]
    The rooms.
    Vis feltene
    roomIdstring (uuid)
    The room's id.
    namestring
    The room's name.
    locationstring
    Where the room is.
    capacityinteger
    How many it seats.
  - tracksobject[]
    The tracks.
    Vis feltene
    trackIdstring (uuid)
    The track's id.
    namestring
    The track's name.
    colourstring
    The track's colour.
  - sessionsobject[]
    The sessions.
    Vis feltene
    sessionIdstring (uuid)
    The session's id.
    titlestring
    The session's title.
    summarystring
    What it is about.
    kindstring
    Talk, workshop, break and others.
    roomIdstring (uuid)
    The room's id.
    trackIdstring (uuid)
    The track's id.
    startsUtcstring (date-time)
    When it starts, in UTC.
    endsUtcstring (date-time)
    When it ends, in UTC.
    startsLocalstring
    When it starts, in the venue's time.
    endsLocalstring
    When it ends, in the venue's time.
    capacityinteger
    How many it seats, when fewer than its room.
    languagestring
    The language it is given in.
  - speakersobject[]
    The speakers.
    Vis feltene
    speakerIdstring (uuid)
    The speaker's id.
    namestring
    The speaker's name.
    jobTitlestring
    Their job title.
    companystring
    Their company.
    biostring
    About them.
    photoUrlstring
    Their photo's address.
  - sponsorsobject[]
    The sponsors.
    Vis feltene
    sponsorIdstring (uuid)
    The sponsor's id.
    namestring
    The sponsor's name.
    tierstring
    Their sponsorship level.
    websitestring
    Their website.
    boothstring
    Their stand.
- ticketTypesTicketType[] eller null
  The ticket types and what is sold. Null without tickets:read.
  Vis feltene
  - ticketTypeIdstring (uuid)
    The ticket type's id.
  - namestring
    Its name.
  - descriptionstring
    What it includes.
  - pricenumber
    The price, VAT included, with the currency's own decimals.
  - vatRatenumber
    The VAT rate, as a percentage.
  - currencystring
    The currency, as ISO 4217.
  - capacityinteger eller null
    How many may be sold, when limited.
  - takeninteger
    How many are taken.
  - maxPerOrderinteger
    The most one order may hold.
  - visibilitystring
    Public, code (sold with an access code) or hidden.
    Én av: public, code, hidden
  - salesStartUtcstring (date-time)
    When sales start, in UTC.
  - salesEndUtcstring (date-time)
    When sales end, in UTC.
  - sortOrderinteger
    Its place in the list.
  - eventIdstring (uuid)
    The event's id.
  - remaininginteger (int32) eller null
    Places left, or null without a limit.
  - requiresApprovalboolean
    Whether an order for it waits for the organiser's approval.
  - salesStartLocalstring eller null
    When sales start, in the venue's time.
  - salesEndLocalstring eller null
    When sales end, in the venue's time.
  - includedAddOnIdsstring (uuid)[]
    The add-ons it includes, as a bundle.
  - updatedUtcstring (date-time) eller null
    When it last changed, in UTC.
- updatedUtcstring (date-time)
  When the event's basics last changed, in UTC.
400 invalidBody, invalidRequest.
401 invalidKey, keyExpired, keyRevoked.
403 missingScope, demoWorkspace.
404 eventNotFound.
409 historyNeedsLicence.
412 preconditionFailed.
429 rateLimited.

Avvisninger

invalidKey keyExpired keyRevoked rateLimited missingScope eventNotFound invalidBody invalidRequest demoWorkspace preconditionFailed historyNeedsLicence

Forespørsel

curl -X PUT "https://attendbeacon.com/api/v1/events/b3ac0000-0000-4000-8000-000000000001/status" \
  -H "Authorization: Bearer $ATTENDBEACON_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "status": "published"
}'

const response = await fetch("https://attendbeacon.com/api/v1/events/b3ac0000-0000-4000-8000-000000000001/status", {
  method: "PUT",
  headers: {
    Authorization: `Bearer ${process.env.ATTENDBEACON_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "status": "published"
  })
});
if (!response.ok) throw new Error((await response.json()).detail);
const data = await response.json();

using System.Net.Http.Headers;
using System.Text;

using var client = new HttpClient();
client.DefaultRequestHeaders.Authorization = new AuthenticationHeaderValue("Bearer", Environment.GetEnvironmentVariable("ATTENDBEACON_KEY"));

using var request = new HttpRequestMessage(HttpMethod.Put, "https://attendbeacon.com/api/v1/events/b3ac0000-0000-4000-8000-000000000001/status");
request.Content = new StringContent("""
{
  "status": "published"
}
""", Encoding.UTF8, "application/json");

using var response = await client.SendAsync(request);
response.EnsureSuccessStatusCode();
var json = await response.Content.ReadAsStringAsync();

import os
import requests

response = requests.put(
    "https://attendbeacon.com/api/v1/events/b3ac0000-0000-4000-8000-000000000001/status",
    headers={
        "Authorization": f"Bearer {os.environ['ATTENDBEACON_KEY']}"
    },
    json={
        "status": "published"
    }
)
response.raise_for_status()
data = response.json()

$headers = @{
    Authorization = "Bearer $env:ATTENDBEACON_KEY"
}
$body = @'
{
  "status": "published"
}
'@

$data = Invoke-RestMethod -Method Put -Uri "https://attendbeacon.com/api/v1/events/b3ac0000-0000-4000-8000-000000000001/status" -Headers $headers -ContentType "application/json" -Body $body

200 Eksempelsvar

JSON

{
  "event": {
    "eventId": "b3ac0000-0000-4000-8000-000000000001",
    "slug": "beacon-summit",
    "name": "Beacon Summit",
    "status": "published",
    "startDate": "2026-11-12",
    "endDate": "2026-11-13",
    "timeZone": "Europe/Amsterdam",
    "venueName": "Beurs van Berlage",
    "venueAddress": "Damrak 243, 1012 ZJ Amsterdam",
    "summary": "Two days on building, shipping and running software, in the old stock exchange on the Damrak.",
    "description": "Beacon Summit brings together the people who build software and the people who run it. Two days, four rooms, thirty sessions, and a long table for lunch.\n\n**Bring your laptop** for the workshops on day two.",
    "languages": [
      "en",
      "nl"
    ],
    "currency": "EUR",
    "contactEmail": "hello@beaconsummit.example",
    "theme": {
      "accent": "#4338ca",
      "highlight": "#f59e0b",
      "darkAccent": "#a5b4fc",
      "darkHighlight": "#fbbf24",
      "background": null,
      "surface": null,
      "mode": "auto",
      "font": "Inter",
      "headingFont": "Sora",
      "headingWeight": "heavy",
      "headingSpacing": "tight",
      "radius": 16,
      "buttonStyle": "filled",
      "buttonShape": "pill",
      "cardStyle": "glass",
      "headerStyle": "transparent",
      "logoUrl": null,
      "logoDarkUrl": null,
      "logoSize": "medium",
      "iconUrl": null,
      "heroUrl": "/media/f0de0000000040008000000000000001/b3ac001e000040008000000000000000.jpg",
      "heroLayout": "image",
      "heroVideoUrl": null,
      "heroOverlay": 50,
      "countdown": true,
      "backgroundStyle": "aurora",
      "pattern": "beacons",
      "backgroundUrl": null,
      "backgroundOverlay": 75,
      "motion": "subtle",
      "preset": null,
      "customCss": null,
      "accentInk": "#ffffff",
      "highlightInk": "#0f1b2d"
    },
    "registration": {
      "schemaVersion": 1,
      "askCompany": true,
      "askJobTitle": true,
      "companyRequired": false,
      "askSponsorConsent": true,
      "questions": [
        {
          "id": "dietary",
          "kind": "choice",
          "label": {
            "en": "Dietary requirements",
            "nl": "Dieetwensen",
            "de": "Ernährungswünsche",
            "es": "Requisitos alimentarios",
            "da": "Kostbehov",
            "fr": "Régime alimentaire",
            "fi": "Ruokavalio",
            "nb": "Kostbehov",
            "pt": "Restrições alimentares",
            "sv": "Kostönskemål",
            "pl": "Wymagania dietetyczne"
          },
          "required": false,
          "options": [
            {
              "value": "none",
              "label": {
                "en": "None",
                "nl": "Geen",
                "de": "Keine",
                "es": "Ninguno",
                "da": "Ingen",
                "fr": "Aucun",
                "fi": "Ei mitään",
                "nb": "Ingen",
                "pt": "Nenhuma",
                "sv": "Inga",
                "pl": "Brak"
              }
            },
            {
              "value": "vegetarian",
              "label": {
                "en": "Vegetarian",
                "nl": "Vegetarisch",
                "de": "Vegetarisch",
                "es": "Vegetariano",
                "da": "Vegetar",
                "fr": "Végétarien",
                "fi": "Kasvis",
                "nb": "Vegetar",
                "pt": "Vegetariano",
                "sv": "Vegetarisk",
                "pl": "Wegetariańskie"
              }
            }
          ],
          "ticketTypes": [],
          "onBadge": false,
          "fileTypes": [],
          "maxMegabytes": 10
        },
        {
          "id": "interests",
          "kind": "multiChoice",
          "label": {
            "en": "What are you here for?",
            "nl": "Waarvoor kom je?",
            "de": "Weshalb kommst du?",
            "es": "¿Qué te trae aquí?",
            "da": "Hvad kommer du for?",
            "fr": "Qu’est-ce qui vous amène ?",
            "fi": "Mitä varten tulet?",
            "nb": "Hva kommer du for?",
            "pt": "O que o traz cá?",
            "sv": "Vad kommer du för?",
            "pl": "Co cię tu sprowadza?"
          },
          "required": false,
          "options": [
            {
              "value": "cloud",
              "label": {
                "en": "Cloud and AI",
                "nl": "Cloud en AI",
                "de": "Cloud und KI",
                "es": "Nube e IA",
                "da": "Cloud og AI",
                "fr": "Cloud et IA",
                "fi": "Pilvi ja tekoäly",
                "nb": "Sky og KI",
                "pt": "Cloud e IA",
                "sv": "Moln och AI",
                "pl": "Chmura i AI"
              }
            },
            {
              "value": "product",
              "label": {
                "en": "Product",
                "nl": "Product",
                "de": "Produkt",
                "es": "Producto",
                "da": "Produkt",
                "fr": "Produit",
                "fi": "Tuote",
                "nb": "Produkt",
                "pt": "Produto",
                "sv": "Produkt",
                "pl": "Produkt"
              }
            }
          ],
          "ticketTypes": [],
          "onBadge": false,
          "fileTypes": [],
          "maxMegabytes": 10
        }
      ]
    },
    "paymentProvider": null,
    "updatedUtc": null,
    "format": "inPerson",
    "capabilities": {
      "doors": true,
      "badges": true,
      "screens": true,
      "venue": true,
      "selfCheckIn": true,
      "boothScanning": true,
      "boothRedemption": true,
      "walletPass": true,
      "crewOnSite": true,
      "meetingTables": true,
      "onlineAccess": false,
      "venueMap": true
    },
    "modules": [
      "payments",
      "addons"
    ],
    "modulesChosen": null,
    "online": null
  },
  "programme": {
    "rooms": [
      {
        "roomId": "b3ac0001-0000-4000-8000-000000000000",
        "name": "Main Hall",
        "location": "Ground floor, straight ahead",
        "capacity": 600,
        "sortOrder": 0
      },
      {
        "roomId": "b3ac0001-0000-4000-8000-000000000001",
        "name": "Graanbeurs",
        "location": "Ground floor, left wing",
        "capacity": 220,
        "sortOrder": 1
      }
    ],
    "tracks": [
      {
        "trackId": "b3ac0002-0000-4000-8000-000000000000",
        "name": "Cloud & AI",
        "colour": "#2b8fd0",
        "sortOrder": 0
      },
      {
        "trackId": "b3ac0002-0000-4000-8000-000000000001",
        "name": "Product",
        "colour": "#c2410c",
        "sortOrder": 1
      }
    ],
    "sessions": [
      {
        "sessionId": "b3ac0004-0000-4000-8000-000000000000",
        "title": "Registration and coffee",
        "summary": null,
        "kind": "other",
        "roomId": null,
        "trackId": null,
        "startsUtc": "2026-11-12T07:30:00.000Z",
        "endsUtc": "2026-11-12T08:30:00.000Z",
        "startsLocal": "2026-11-12T08:30",
        "endsLocal": "2026-11-12T09:30",
        "capacity": null,
        "onlineUrl": null,
        "joinProvider": null,
        "language": null,
        "speakerIds": []
      },
      {
        "sessionId": "b3ac0004-0000-4000-8000-000000000001",
        "title": "Opening keynote: software that finds its way",
        "summary": "Opening keynote: software that finds its way. What worked, what did not, and what to try on Monday.",
        "kind": "keynote",
        "roomId": "b3ac0001-0000-4000-8000-000000000000",
        "trackId": null,
        "startsUtc": "2026-11-12T08:30:00.000Z",
        "endsUtc": "2026-11-12T09:15:00.000Z",
        "startsLocal": "2026-11-12T09:30",
        "endsLocal": "2026-11-12T10:15",
        "capacity": null,
        "onlineUrl": null,
        "joinProvider": null,
        "language": null,
        "speakerIds": [
          "b3ac0003-0000-4000-8000-000000000009"
        ]
      }
    ],
    "speakers": [
      {
        "speakerId": "b3ac0003-0000-4000-8000-000000000000",
        "name": "Ada Verhoeven",
        "jobTitle": "Principal Engineer",
        "company": "Northwind Cloud",
        "bio": "Ada builds the platforms other engineers build on, and writes about what breaks.",
        "photoUrl": "/media/f0de0000000040008000000000000001/b3ac00fa000040008000000000000000.jpg",
        "email": null,
        "links": [],
        "sortOrder": 0
      },
      {
        "speakerId": "b3ac0003-0000-4000-8000-000000000001",
        "name": "Malik Osei",
        "jobTitle": "VP Product",
        "company": "Contoso",
        "bio": "Malik has shipped products in four countries and still reads every support ticket.",
        "photoUrl": "/media/f0de0000000040008000000000000001/b3ac00fa000040008000000000000001.jpg",
        "email": null,
        "links": [],
        "sortOrder": 1
      }
    ],
    "sponsors": [
      {
        "sponsorId": "b3ac0005-0000-4000-8000-000000000000",
        "name": "Northwind Cloud",
        "tier": "Platinum",
        "tierOrder": 0,
        "website": "https://northwindcloud.example",
        "logoUrl": "/media/f0de0000000040008000000000000001/b3ac00fb000040008000000000000000.png",
        "description": "The cloud for teams who would rather be building.",
        "booth": "A1",
        "sortOrder": 0
      },
      {
        "sponsorId": "b3ac0005-0000-4000-8000-000000000001",
        "name": "Contoso",
        "tier": "Gold",
        "tierOrder": 1,
        "website": "https://contoso.example",
        "logoUrl": "/media/f0de0000000040008000000000000001/b3ac00fb000040008000000000000001.png",
        "description": "Software for the way people work now.",
        "booth": "B2",
        "sortOrder": 1
      }
    ]
  },
  "ticketTypes": [
    {
      "ticketTypeId": "b3ac0006-0000-4000-8000-000000000000",
      "name": "Community pass",
      "description": "Both days, lunch included. Free for members of a local user group.",
      "price": 0,
      "vatRate": 21,
      "currency": "EUR",
      "capacity": 300,
      "taken": 24,
      "maxPerOrder": 10,
      "visibility": "public",
      "salesStartUtc": null,
      "salesEndUtc": "2026-11-13T11:00:00.000Z",
      "sortOrder": 0
    },
    {
      "ticketTypeId": "b3ac0006-0000-4000-8000-000000000001",
      "name": "Conference pass",
      "description": "Both days, lunch and drinks. A workshop seat is booked as an extra.",
      "price": 395,
      "vatRate": 21,
      "currency": "EUR",
      "capacity": 500,
      "taken": 38,
      "maxPerOrder": 10,
      "visibility": "public",
      "salesStartUtc": null,
      "salesEndUtc": "2026-11-13T11:00:00.000Z",
      "sortOrder": 1
    }
  ],
  "updatedUtc": "2026-10-14T21:40:48.036Z"
}

400 invalidBody, invalidRequest.

JSON

{
  "type": "https://attendbeacon.com/developers/errors#invalidBody",
  "title": "The body is not readable",
  "status": 400,
  "detail": "The body is not JSON, or a field has the wrong type.",
  "instance": "/api/v1/events/b3ac0000-0000-4000-8000-000000000001/status",
  "code": "invalidBody",
  "traceId": "00-4bf92f3577b34da6a3ce929d0e0e4736-00f067aa0ba902b7-01",
  "error": "The body is not JSON, or a field has the wrong type."
}

Get event statistics

GET/events/{eventId}/stats

Gets an event's numbers at a glance: registrations against capacity, pending and cancelled tickets, check-ins, the programme's size and, with orders:read, revenue.

Omfang: events:read

Parametere

sti

eventIdstring (uuid)påkrevd
The event's id.

Svar

200 The numbers. EventStats
Felt
- eventIdstring (uuid)
  The event's id.
- namestring
  Its name.
- statusstring
  Draft, published or closed.
- timeZonestring
  The venue's time zone.
- startDatestring (date)
  The first day.
- endDatestring (date)
  The last day.
- daysToGointeger (int32)
  Days until the first day; 0 once it has begun.
- phasestring
  Before, during or after the event, at the venue.
  Én av: before, during, after
- formatstring
  InPerson, online or hybrid.
- registrationsobject
  Who holds a ticket.
  Vis feltene
  - registeredinteger (int32)
    Valid tickets, crew left out.
  - pendinginteger (int32)
    Tickets in orders waiting for payment, a bank transfer or approval.
  - cancelledinteger (int32)
    Cancelled tickets.
  - crewinteger (int32)
    Crew tickets.
  - capacityinteger (int32) eller null
    Places in all ticket types, or null when one has no limit.
  - remaininginteger (int32) eller null
    Places left, or null without a limit.
  - fillnumber eller null
    Registered and pending as a percentage of capacity.
- checkInsobject
  Who came in.
  Vis feltene
  - checkedIninteger (int32)
    Valid tickets checked in at the main entrance.
  - ratenumber eller null
    As a percentage of registered.
- programmeobject
  The programme's size.
  Vis feltene
  - sessionsinteger (int32)
    Sessions.
  - speakersinteger (int32)
    Speakers.
  - sponsorsinteger (int32)
    Sponsors; 0 when the Sponsors module is off.
- moneyobject eller null
  With orders:read: what paid orders came to.
  Vis feltene
  - currencystring
    ISO 4217.
  - revenuenumber
    Paid and on-account orders, VAT included. With the currency's own decimals: 147.00 in EUR, 147 in JPY, 147.000 in KWD.
  - vatnumber
    The VAT in it. With the currency's own decimals: 147.00 in EUR, 147 in JPY, 147.000 in KWD.
  - paidOrdersinteger (int32)
    Orders paid.
- modulesstring[]
  The modules switched on.
401 invalidKey, keyExpired, keyRevoked.
403 missingScope.
404 eventNotFound.
429 rateLimited.

Avvisninger

invalidKey keyExpired keyRevoked rateLimited missingScope eventNotFound

Forespørsel

curl "https://attendbeacon.com/api/v1/events/b3ac0000-0000-4000-8000-000000000001/stats" \
  -H "Authorization: Bearer $ATTENDBEACON_KEY"

const response = await fetch("https://attendbeacon.com/api/v1/events/b3ac0000-0000-4000-8000-000000000001/stats", {
  headers: {
    Authorization: `Bearer ${process.env.ATTENDBEACON_KEY}`
  }
});
if (!response.ok) throw new Error((await response.json()).detail);
const data = await response.json();

using System.Net.Http.Headers;
using System.Text;

using var client = new HttpClient();
client.DefaultRequestHeaders.Authorization = new AuthenticationHeaderValue("Bearer", Environment.GetEnvironmentVariable("ATTENDBEACON_KEY"));

using var request = new HttpRequestMessage(HttpMethod.Get, "https://attendbeacon.com/api/v1/events/b3ac0000-0000-4000-8000-000000000001/stats");

using var response = await client.SendAsync(request);
response.EnsureSuccessStatusCode();
var json = await response.Content.ReadAsStringAsync();

import os
import requests

response = requests.get(
    "https://attendbeacon.com/api/v1/events/b3ac0000-0000-4000-8000-000000000001/stats",
    headers={
        "Authorization": f"Bearer {os.environ['ATTENDBEACON_KEY']}"
    }
)
response.raise_for_status()
data = response.json()

$headers = @{
    Authorization = "Bearer $env:ATTENDBEACON_KEY"
}

$data = Invoke-RestMethod -Method Get -Uri "https://attendbeacon.com/api/v1/events/b3ac0000-0000-4000-8000-000000000001/stats" -Headers $headers

200 Eksempelsvar

JSON

{
  "eventId": "b3ac0000-0000-4000-8000-000000000001",
  "name": "Beacon Summit",
  "status": "published",
  "timeZone": "Europe/Amsterdam",
  "startDate": "2026-11-12",
  "endDate": "2026-11-13",
  "daysToGo": 29,
  "phase": "before",
  "format": "inPerson",
  "registrations": {
    "registered": 74,
    "pending": 8,
    "cancelled": 0,
    "crew": 12,
    "capacity": null,
    "remaining": null,
    "fill": null
  },
  "checkIns": {
    "checkedIn": 0,
    "rate": 0
  },
  "programme": {
    "sessions": 30,
    "speakers": 11,
    "sponsors": 11
  },
  "money": {
    "currency": "EUR",
    "revenue": 15216.25,
    "vat": 2552.11,
    "paidOrders": 46
  },
  "modules": [
    "payments",
    "addons"
  ]
}

401 invalidKey, keyExpired, keyRevoked.

JSON

{
  "type": "https://attendbeacon.com/developers/errors#invalidKey",
  "title": "No working API key",
  "status": 401,
  "detail": "No key was sent, or it is not one this platform made. Send it as Authorization: Bearer abk_... or in X-Api-Key.",
  "instance": "/api/v1/events/b3ac0000-0000-4000-8000-000000000001/stats",
  "code": "invalidKey",
  "traceId": "00-4bf92f3577b34da6a3ce929d0e0e4736-00f067aa0ba902b7-01",
  "error": "No key was sent, or it is not one this platform made. Send it as Authorization: Bearer abk_... or in X-Api-Key."
}

List registration questions

GET/events/{eventId}/questions

Lists the questions an event asks beyond name and email, with their ids, which an attendee's answers are keyed by.

Omfang: events:read

Parametere

sti

eventIdstring (uuid)påkrevd
The event's id.

Svar

200 The questions. QuestionList
Felt
- dataQuestion[]
  The questions.
  Vis feltene
  - idstring
    The question's id, which answers are keyed by.
  - kindstring
    What kind of answer it takes.
    Én av: text, longText, choice, multiChoice, yesNo, consent, phone, rating, scale, file
  - labelstring
    What is asked, in the event's first language.
  - requiredboolean
    Whether attendees have to answer it.
  - optionsobject[]
    The options of a choice.
    Vis feltene
    valuestring
    What is stored.
    labelstring
    What is shown.
  - ticketTypesstring (uuid)[]
    The ticket types it is asked for; all when empty.
401 invalidKey, keyExpired, keyRevoked.
403 missingScope.
404 eventNotFound.
429 rateLimited.

Avvisninger

invalidKey keyExpired keyRevoked rateLimited missingScope eventNotFound

Forespørsel

curl "https://attendbeacon.com/api/v1/events/b3ac0000-0000-4000-8000-000000000001/questions" \
  -H "Authorization: Bearer $ATTENDBEACON_KEY"

const response = await fetch("https://attendbeacon.com/api/v1/events/b3ac0000-0000-4000-8000-000000000001/questions", {
  headers: {
    Authorization: `Bearer ${process.env.ATTENDBEACON_KEY}`
  }
});
if (!response.ok) throw new Error((await response.json()).detail);
const data = await response.json();

using System.Net.Http.Headers;
using System.Text;

using var client = new HttpClient();
client.DefaultRequestHeaders.Authorization = new AuthenticationHeaderValue("Bearer", Environment.GetEnvironmentVariable("ATTENDBEACON_KEY"));

using var request = new HttpRequestMessage(HttpMethod.Get, "https://attendbeacon.com/api/v1/events/b3ac0000-0000-4000-8000-000000000001/questions");

using var response = await client.SendAsync(request);
response.EnsureSuccessStatusCode();
var json = await response.Content.ReadAsStringAsync();

import os
import requests

response = requests.get(
    "https://attendbeacon.com/api/v1/events/b3ac0000-0000-4000-8000-000000000001/questions",
    headers={
        "Authorization": f"Bearer {os.environ['ATTENDBEACON_KEY']}"
    }
)
response.raise_for_status()
data = response.json()

$headers = @{
    Authorization = "Bearer $env:ATTENDBEACON_KEY"
}

$data = Invoke-RestMethod -Method Get -Uri "https://attendbeacon.com/api/v1/events/b3ac0000-0000-4000-8000-000000000001/questions" -Headers $headers

200 Eksempelsvar

JSON

{
  "data": [
    {
      "id": "dietary",
      "kind": "choice",
      "label": "Dietary requirements",
      "required": false,
      "options": [
        {
          "value": "none",
          "label": "None"
        },
        {
          "value": "vegetarian",
          "label": "Vegetarian"
        }
      ],
      "ticketTypes": []
    },
    {
      "id": "interests",
      "kind": "multiChoice",
      "label": "What are you here for?",
      "required": false,
      "options": [
        {
          "value": "cloud",
          "label": "Cloud and AI"
        },
        {
          "value": "product",
          "label": "Product"
        }
      ],
      "ticketTypes": []
    }
  ]
}

401 invalidKey, keyExpired, keyRevoked.

JSON

{
  "type": "https://attendbeacon.com/developers/errors#invalidKey",
  "title": "No working API key",
  "status": 401,
  "detail": "No key was sent, or it is not one this platform made. Send it as Authorization: Bearer abk_... or in X-Api-Key.",
  "instance": "/api/v1/events/b3ac0000-0000-4000-8000-000000000001/questions",
  "code": "invalidKey",
  "traceId": "00-4bf92f3577b34da6a3ce929d0e0e4736-00f067aa0ba902b7-01",
  "error": "No key was sent, or it is not one this platform made. Send it as Authorization: Bearer abk_... or in X-Api-Key."
}

Get the answers schema

GET/events/{eventId}/questions/schema

Returns a JSON schema with one property per registration question, so a flow can show the event's own fields.

Omfang: events:read

Parametere

sti

eventIdstring (uuid)påkrevd
The event's id.

spørring

purposestring
Use input for the questions an organiser may answer on somebody's behalf, or output for every question.
Én av: output, input
Standard: "output"

Svar

200 The schema, under schema. AnswersSchema
Felt
- schemaobject
  The schema: an object with a property per question.
401 invalidKey, keyExpired, keyRevoked.
403 missingScope.
404 eventNotFound.
429 rateLimited.

Avvisninger

invalidKey keyExpired keyRevoked rateLimited missingScope eventNotFound

Forespørsel

curl "https://attendbeacon.com/api/v1/events/b3ac0000-0000-4000-8000-000000000001/questions/schema" \
  -H "Authorization: Bearer $ATTENDBEACON_KEY"

const response = await fetch("https://attendbeacon.com/api/v1/events/b3ac0000-0000-4000-8000-000000000001/questions/schema", {
  headers: {
    Authorization: `Bearer ${process.env.ATTENDBEACON_KEY}`
  }
});
if (!response.ok) throw new Error((await response.json()).detail);
const data = await response.json();

using System.Net.Http.Headers;
using System.Text;

using var client = new HttpClient();
client.DefaultRequestHeaders.Authorization = new AuthenticationHeaderValue("Bearer", Environment.GetEnvironmentVariable("ATTENDBEACON_KEY"));

using var request = new HttpRequestMessage(HttpMethod.Get, "https://attendbeacon.com/api/v1/events/b3ac0000-0000-4000-8000-000000000001/questions/schema");

using var response = await client.SendAsync(request);
response.EnsureSuccessStatusCode();
var json = await response.Content.ReadAsStringAsync();

import os
import requests

response = requests.get(
    "https://attendbeacon.com/api/v1/events/b3ac0000-0000-4000-8000-000000000001/questions/schema",
    headers={
        "Authorization": f"Bearer {os.environ['ATTENDBEACON_KEY']}"
    }
)
response.raise_for_status()
data = response.json()

$headers = @{
    Authorization = "Bearer $env:ATTENDBEACON_KEY"
}

$data = Invoke-RestMethod -Method Get -Uri "https://attendbeacon.com/api/v1/events/b3ac0000-0000-4000-8000-000000000001/questions/schema" -Headers $headers

401 invalidKey, keyExpired, keyRevoked.

JSON

{
  "type": "https://attendbeacon.com/developers/errors#invalidKey",
  "title": "No working API key",
  "status": 401,
  "detail": "No key was sent, or it is not one this platform made. Send it as Authorization: Bearer abk_... or in X-Api-Key.",
  "instance": "/api/v1/events/b3ac0000-0000-4000-8000-000000000001/questions/schema",
  "code": "invalidKey",
  "traceId": "00-4bf92f3577b34da6a3ce929d0e0e4736-00f067aa0ba902b7-01",
  "error": "No key was sent, or it is not one this platform made. Send it as Authorization: Bearer abk_... or in X-Api-Key."
}

Veiledningene og dette nettstedet er på ditt språk. Beskrivelsene i selve API-referansen er på engelsk, slik API-et selv er.

#List events

Parametere

Svar

Avvisninger

#Create a draft event Endrer data

Parametere

Innhold NewEvent

Svar

Avvisninger

#Get an event

Parametere

Svar

Avvisninger

#Change an event Endrer data

Parametere

Innhold EventPatch

Svar

Avvisninger

#Publish or unpublish an event Endrer data

Parametere

Innhold EventStatusChange

Svar

Avvisninger

#Get event statistics

Parametere

Svar

Avvisninger

#List registration questions

Parametere

Svar

Avvisninger

#Get the answers schema

Parametere

Svar

Avvisninger

List events

Create a draft event Endrer data

Get an event

Change an event Endrer data

Publish or unpublish an event Endrer data

Get event statistics

List registration questions

Get the answers schema