API-reference

Passes

Season passes and bundles across events: what they include and who holds them.

List passes

GET/passes

Lists the workspace's season passes and bundles, with the events each admits to, how many were sold and the seats each event holds for their holders, the latest change first.

Scopes: tickets:read

Parametre

forespørgsel

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.
communityIdstring (uuid)
Only this community's season passes.
eventIdstring (uuid)
Only the passes this event sells or admits to.

Svar

200 A page of passes. PassList
Felter
- dataPass[]
  The items of this page.
  Vis felterne
  - passIdstring (uuid)
    The pass's id.
  - kindstring
    A community's season pass, or a bundle sold on an event's page.
    En af: season, bundle
  - communityIdstring (uuid) eller null
    A season pass's community.
  - salesEventIdstring (uuid)
    The event whose orders, payments and invoices carry the pass's money.
  - namestring
    Its name, as the invoice line shows it.
  - descriptionstring eller null
    What it includes.
  - pricenumber
    Its price, VAT included, with the currency's own decimals.
  - vatRatenumber
    The VAT rate in the price, in percent.
  - currencystring
    The ISO 4217 code: the sales event's, and every included event's.
  - capacityinteger (int32)
    How many are sold, and the seats each event holds for holders.
  - soldinteger (int32)
    Holders whose order is paid or free.
  - waitinginteger (int32)
    Holders whose payment is under way.
  - leftinteger (int32)
    How many are left to sell.
  - scopestring
    The community's meetups between two days (range), or the events named (list).
    En af: range, list
  - seriesIdstring (uuid) eller null
    A range pass's one series, when it names one.
  - fromDatestring (date) eller null
    A range's first day at the venue.
  - toDatestring (date) eller null
    A range's last day at the venue.
  - salesStartUtcstring (date-time) eller null
    On sale from, in UTC.
  - salesEndUtcstring (date-time) eller null
    On sale until, in UTC.
  - refundRulestring
    What the page promises about refunds; the organiser decides every refund, never pro rata.
    En af: beforeFirst, organiser, none
  - statusstring
    Being set up, on sale, or no longer sold.
    En af: draft, onSale, closed
  - eventsPassEvent[]
    The events it admits to, the first first.
    Vis felterne
    eventIdstring (uuid)
    The event's id.
    namestring
    The event's name.
    startsUtcstring (date-time)
    When it begins, in UTC.
    holdersinteger (int32)
    Holders whose ticket there lets them in.
    optedOutinteger (int32)
    Holders who said they cannot come; their seats went back to the event.
    heldSeatsinteger (int32)
    The seats every pass holds at the event for its holders, which its other limited ticket types do not sell.
    sourcestring
    Whether the organiser named it (list) or it is a meetup in a season pass's range (range).
    En af: list, range
  - createdUtcstring (date-time)
    When it was made, in UTC.
  - updatedUtcstring (date-time)
    When it last changed, in UTC.
- nextCursorstring eller null
  The cursor for the next page; null on the last page. Pass it as cursor, with the same filters.
- hasMoreboolean
  Whether there is another page.
400 invalidCursor, invalidUpdatedSince, invalidRequest.
401 invalidKey, keyExpired, keyRevoked.
403 missingScope.
429 rateLimited.

Afvisninger

invalidKey keyExpired keyRevoked rateLimited missingScope invalidCursor invalidUpdatedSince invalidRequest

Forespørgsel

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

const response = await fetch("https://attendbeacon.com/api/v1/passes?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/passes?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/passes", 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/passes?limit=2" -Headers $headers

200 Eksempel på svar

JSON

{
  "data": [
    {
      "passId": "b3ac8000-0000-4000-8000-000000000001",
      "kind": "season",
      "communityId": "b3ac6200-0000-4000-8000-000000000001",
      "salesEventId": "b3ac6201-0000-4000-8000-000000000000",
      "name": "Season pass 2026–27",
      "description": "Every Beacon Community meetup from November to June, with a seat kept for you.",
      "price": 120,
      "vatRate": 21,
      "currency": "EUR",
      "capacity": 20,
      "sold": 5,
      "waiting": 0,
      "left": 15,
      "scope": "range",
      "seriesId": "b3ac6202-0000-4000-8000-000000000001",
      "fromDate": "2026-11-01",
      "toDate": "2027-06-30",
      "salesStartUtc": null,
      "salesEndUtc": null,
      "refundRule": "beforeFirst",
      "status": "onSale",
      "events": [
        {
          "eventId": "b3ac6210-0000-4000-8000-000000000005",
          "name": "Beacon Community #25: November 2026",
          "startsUtc": "2026-11-05T17:30:00.000Z",
          "holders": 5,
          "optedOut": 0,
          "heldSeats": 20,
          "source": "range"
        },
        {
          "eventId": "b3ac6210-0000-4000-8000-000000000006",
          "name": "Beacon Community #26: December 2026",
          "startsUtc": "2026-12-03T17:30:00.000Z",
          "holders": 4,
          "optedOut": 1,
          "heldSeats": 19,
          "source": "range"
        }
      ],
      "createdUtc": "2026-10-01T09:00:00.000Z",
      "updatedUtc": "2026-10-01T09:00:00.000Z"
    }
  ],
  "nextCursor": null,
  "hasMore": false
}

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/passes",
  "code": "invalidCursor",
  "traceId": "00-4bf92f3577b34da6a3ce929d0e0e4736-00f067aa0ba902b7-01",
  "error": "Pass nextCursor exactly as a list returned it, with the same filters."
}

Get a pass

GET/passes/{passId}

Gets one season pass or bundle with its events.

Scopes: tickets:read

Svarer med en ETag; send If-None-Match for at spare en download.

Parametre

sti

passIdstring (uuid)påkrævet
The pass'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 pass. Pass
Felter
- passIdstring (uuid)
  The pass's id.
- kindstring
  A community's season pass, or a bundle sold on an event's page.
  En af: season, bundle
- communityIdstring (uuid) eller null
  A season pass's community.
- salesEventIdstring (uuid)
  The event whose orders, payments and invoices carry the pass's money.
- namestring
  Its name, as the invoice line shows it.
- descriptionstring eller null
  What it includes.
- pricenumber
  Its price, VAT included, with the currency's own decimals.
- vatRatenumber
  The VAT rate in the price, in percent.
- currencystring
  The ISO 4217 code: the sales event's, and every included event's.
- capacityinteger (int32)
  How many are sold, and the seats each event holds for holders.
- soldinteger (int32)
  Holders whose order is paid or free.
- waitinginteger (int32)
  Holders whose payment is under way.
- leftinteger (int32)
  How many are left to sell.
- scopestring
  The community's meetups between two days (range), or the events named (list).
  En af: range, list
- seriesIdstring (uuid) eller null
  A range pass's one series, when it names one.
- fromDatestring (date) eller null
  A range's first day at the venue.
- toDatestring (date) eller null
  A range's last day at the venue.
- salesStartUtcstring (date-time) eller null
  On sale from, in UTC.
- salesEndUtcstring (date-time) eller null
  On sale until, in UTC.
- refundRulestring
  What the page promises about refunds; the organiser decides every refund, never pro rata.
  En af: beforeFirst, organiser, none
- statusstring
  Being set up, on sale, or no longer sold.
  En af: draft, onSale, closed
- eventsPassEvent[]
  The events it admits to, the first first.
  Vis felterne
  - eventIdstring (uuid)
    The event's id.
  - namestring
    The event's name.
  - startsUtcstring (date-time)
    When it begins, in UTC.
  - holdersinteger (int32)
    Holders whose ticket there lets them in.
  - optedOutinteger (int32)
    Holders who said they cannot come; their seats went back to the event.
  - heldSeatsinteger (int32)
    The seats every pass holds at the event for its holders, which its other limited ticket types do not sell.
  - sourcestring
    Whether the organiser named it (list) or it is a meetup in a season pass's range (range).
    En af: list, range
- createdUtcstring (date-time)
  When it was made, in UTC.
- updatedUtcstring (date-time)
  When it last changed, in UTC.
304 Not modified: If-None-Match named the representation as it is.
401 invalidKey, keyExpired, keyRevoked.
403 missingScope.
404 notFound.
429 rateLimited.

Afvisninger

invalidKey keyExpired keyRevoked rateLimited missingScope notFound

Forespørgsel

curl "https://attendbeacon.com/api/v1/passes/{passId}" \
  -H "Authorization: Bearer $ATTENDBEACON_KEY"

const response = await fetch("https://attendbeacon.com/api/v1/passes/{passId}", {
  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/passes/{passId}");

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/passes/{passId}",
    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/passes/{passId}" -Headers $headers

200 Eksempel på svar

JSON

{
  "passId": "b3ac8000-0000-4000-8000-000000000001",
  "kind": "season",
  "communityId": "b3ac6200-0000-4000-8000-000000000001",
  "salesEventId": "b3ac6201-0000-4000-8000-000000000000",
  "name": "Season pass 2026–27",
  "description": "Every Beacon Community meetup from November to June, with a seat kept for you.",
  "price": 120,
  "vatRate": 21,
  "currency": "EUR",
  "capacity": 20,
  "sold": 5,
  "waiting": 0,
  "left": 15,
  "scope": "range",
  "seriesId": "b3ac6202-0000-4000-8000-000000000001",
  "fromDate": "2026-11-01",
  "toDate": "2027-06-30",
  "salesStartUtc": null,
  "salesEndUtc": null,
  "refundRule": "beforeFirst",
  "status": "onSale",
  "events": [
    {
      "eventId": "b3ac6210-0000-4000-8000-000000000005",
      "name": "Beacon Community #25: November 2026",
      "startsUtc": "2026-11-05T17:30:00.000Z",
      "holders": 5,
      "optedOut": 0,
      "heldSeats": 20,
      "source": "range"
    },
    {
      "eventId": "b3ac6210-0000-4000-8000-000000000006",
      "name": "Beacon Community #26: December 2026",
      "startsUtc": "2026-12-03T17:30:00.000Z",
      "holders": 4,
      "optedOut": 1,
      "heldSeats": 19,
      "source": "range"
    }
  ],
  "createdUtc": "2026-10-01T09:00:00.000Z",
  "updatedUtc": "2026-10-01T09:00:00.000Z"
}

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/passes/{passId}",
  "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 pass holders

GET/passes/{passId}/holders

Lists who holds a pass, the newest first, with their ticket at each event it admits to. Names and addresses need people:read.

Scopes: attendees:read

Parametre

sti

passIdstring (uuid)påkrævet
The pass's id.

forespørgsel

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
statusstring
Only holders with this status.
En af: active, ended

Svar

200 A page of holders. PassHolderList
Felter
- dataPassHolder[]
  The items of this page.
  Vis felterne
  - holderIdstring (uuid)
    The holder's id.
  - passIdstring (uuid)
    The pass's id.
  - statusstring
    Active, or ended by a refund or because its order was let go.
    En af: active, ended
  - endedReasonstring eller null
    Why it ended: refunded, cancelled or orderGone.
  - endedUtcstring (date-time) eller null
    When it ended, in UTC.
  - orderIdstring (uuid)
    The order on the sales event that pays for it.
  - orderStatusstring
    The order's status: paid, free, pending, refunded and the others.
  - firstNamestring eller null
    Their first name. Null without people:read.
  - lastNamestring eller null
    Their last name. Null without people:read.
  - emailstring eller null
    Their address. Null without people:read.
  - handedOverboolean
    Whether the pass was handed to its holder by somebody who had it before.
  - createdUtcstring (date-time)
    When it was bought, in UTC.
  - eventsPassHolderEvent[]
    Their ticket at each event of the pass.
    Vis felterne
    eventIdstring (uuid)
    The event's id.
    attendeeIdstring (uuid) eller null
    The holder's attendee at the event, as the attendees list names them; null while it is being written.
    statestring
    A ticket that lets them in, given back, the event begun, being written, or cancelled.
    En af: ticket, optedOut, held, waiting, cancelled
    checkedInboolean
    Whether it came through the door.
- nextCursorstring eller null
  The cursor for the next page; null on the last page. Pass it as cursor, with the same filters.
- hasMoreboolean
  Whether there is another page.
400 invalidCursor, invalidRequest.
401 invalidKey, keyExpired, keyRevoked.
403 missingScope.
404 notFound.
429 rateLimited.

Afvisninger

invalidKey keyExpired keyRevoked rateLimited missingScope notFound invalidCursor invalidRequest

Forespørgsel

curl "https://attendbeacon.com/api/v1/passes/{passId}/holders?limit=2" \
  -H "Authorization: Bearer $ATTENDBEACON_KEY"

const response = await fetch("https://attendbeacon.com/api/v1/passes/{passId}/holders?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/passes/{passId}/holders?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/passes/{passId}/holders", 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/passes/{passId}/holders?limit=2" -Headers $headers

200 Eksempel på svar

JSON

{
  "data": [
    {
      "holderId": "b3ac8001-0000-4000-8000-000000000001",
      "passId": "b3ac8000-0000-4000-8000-000000000001",
      "status": "active",
      "endedReason": null,
      "endedUtc": null,
      "orderId": "b3ac8002-0000-4000-8000-000000000001",
      "orderStatus": "paid",
      "firstName": "Mila",
      "lastName": "Jansen",
      "email": "mila.jansen@example.com",
      "handedOver": false,
      "createdUtc": "2026-10-02T19:12:00.000Z",
      "events": [
        {
          "eventId": "b3ac6210-0000-4000-8000-000000000005",
          "attendeeId": "b3ac8003-0000-4000-8000-000000000001",
          "state": "ticket",
          "checkedIn": false
        },
        {
          "eventId": "b3ac6210-0000-4000-8000-000000000006",
          "attendeeId": "b3ac8003-0000-4000-8000-000000000002",
          "state": "optedOut",
          "checkedIn": false
        }
      ]
    }
  ],
  "nextCursor": null,
  "hasMore": false
}

400 invalidCursor, 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/passes/{passId}/holders",
  "code": "invalidCursor",
  "traceId": "00-4bf92f3577b34da6a3ce929d0e0e4736-00f067aa0ba902b7-01",
  "error": "Pass nextCursor exactly as a list returned it, with the same filters."
}

Guiderne og dette site er på dit sprog. API-referencens egne beskrivelser er på engelsk, ligesom API'et selv.

#List passes

Parametre

Svar

Afvisninger

#Get a pass

Parametre

Svar

Afvisninger

#List pass holders

Parametre

Svar

Afvisninger

List passes

Get a pass

List pass holders