API-reference

Sponsors

Sponsors, exhibitors, their levels and their leads.

List sponsors

GET/events/{eventId}/sponsors

Lists an event's sponsors and exhibitors by level, with their booth and website.

Scopes: sponsors:read
Modul: sponsors Afvises med moduleOff, så længe eventets arrangør har slået det fra.

Parametre

sti

eventIdstring (uuid)påkrævet
The event'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

Svar

200 A page of sponsors. SponsorDetailList
Felter
- dataSponsorDetail[]
  The items of this page.
  Vis felterne
  - sponsorIdstring (uuid)
    The sponsor's id.
  - eventIdstring (uuid)
    The event's id.
  - namestring
    Its name.
  - levelstring eller null
    Its level, in the organiser's words: Platinum, Gold.
  - levelIdstring (uuid) eller null
    Its level's id.
  - levelRankinteger (int32)
    The level's rank, highest first.
  - websitestring eller null
    Its site.
  - logoUrlstring eller null
    Its logo.
  - descriptionstring eller null
    About it.
  - boothstring eller null
    Where to find it.
  - sortOrderinteger (int32)
    Its place within its level.
- 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.
401 invalidKey, keyExpired, keyRevoked.
403 missingScope.
404 eventNotFound.
409 moduleOff.
429 rateLimited.

Afvisninger

invalidKey keyExpired keyRevoked rateLimited missingScope moduleOff eventNotFound invalidCursor

Forespørgsel

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

const response = await fetch("https://attendbeacon.com/api/v1/events/b3ac0000-0000-4000-8000-000000000001/sponsors?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/b3ac0000-0000-4000-8000-000000000001/sponsors?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/b3ac0000-0000-4000-8000-000000000001/sponsors", 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/b3ac0000-0000-4000-8000-000000000001/sponsors?limit=2" -Headers $headers

200 Eksempel på svar

JSON

{
  "data": [
    {
      "sponsorId": "b3ac0005-0000-4000-8000-000000000000",
      "eventId": "b3ac0000-0000-4000-8000-000000000001",
      "name": "Northwind Cloud",
      "level": "Platinum",
      "levelId": "b3ac0154-0000-4000-8000-000000000000",
      "levelRank": 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",
      "eventId": "b3ac0000-0000-4000-8000-000000000001",
      "name": "Contoso",
      "level": "Gold",
      "levelId": "b3ac0154-0000-4000-8000-000000000001",
      "levelRank": 1,
      "website": "https://contoso.example",
      "logoUrl": "/media/f0de0000000040008000000000000001/b3ac00fb000040008000000000000001.png",
      "description": "Software for the way people work now.",
      "booth": "B2",
      "sortOrder": 1
    }
  ],
  "nextCursor": "YzE6MDAwMDAwMTAwMDAwMDEwMDAwMXxiM2FjMDAwNTAwMDA0MDAwODAwMDAwMDAwMDAwMDAwMQ",
  "hasMore": true
}

400 invalidCursor.

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

List sponsor levels

GET/events/{eventId}/sponsor-levels

Lists an event's sponsor levels and what each includes.

Scopes: sponsors:read
Modul: sponsors Afvises med moduleOff, så længe eventets arrangør har slået det fra.

Parametre

sti

eventIdstring (uuid)påkrævet
The event'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

Svar

200 A page of levels. SponsorLevelList
Felter
- dataSponsorLevel[]
  The items of this page.
  Vis felterne
  - levelIdstring (uuid)
    The level's id.
  - eventIdstring (uuid)
    The event's id.
  - namestring
    Its name.
  - rankinteger (int32)
    Its rank, highest first.
  - colourstring
    Its colour.
  - staffAllowanceinteger (int32)
    Booth staff included.
  - freeTicketsinteger (int32)
    Free tickets included.
  - leadDownloadboolean
    Whether its sponsors may download their leads.
  - leadExportUntilstring (date) eller null
    Until when they may.
  - discountCodesinteger (int32)
    Discount codes included.
  - discountPercentinteger (int32)
    Their percentage.
  - logoOnPageboolean
    Logo on the event's page.
  - logoOnScreensboolean
    Logo on the room screens.
  - logoOnBadgesboolean
    Logo on the badges.
  - sponsoredSessionboolean
    A sponsored session included.
- 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.
401 invalidKey, keyExpired, keyRevoked.
403 missingScope.
404 eventNotFound.
409 moduleOff.
429 rateLimited.

Afvisninger

invalidKey keyExpired keyRevoked rateLimited missingScope moduleOff eventNotFound invalidCursor

Forespørgsel

curl "https://attendbeacon.com/api/v1/events/b3ac0000-0000-4000-8000-000000000001/sponsor-levels?limit=2" \
  -H "Authorization: Bearer $ATTENDBEACON_KEY"

const response = await fetch("https://attendbeacon.com/api/v1/events/b3ac0000-0000-4000-8000-000000000001/sponsor-levels?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/b3ac0000-0000-4000-8000-000000000001/sponsor-levels?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/b3ac0000-0000-4000-8000-000000000001/sponsor-levels", 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/b3ac0000-0000-4000-8000-000000000001/sponsor-levels?limit=2" -Headers $headers

200 Eksempel på svar

JSON

{
  "data": [
    {
      "levelId": "b3ac0154-0000-4000-8000-000000000000",
      "eventId": "b3ac0000-0000-4000-8000-000000000001",
      "name": "Platinum",
      "rank": 0,
      "colour": "#6d28d9",
      "staffAllowance": 6,
      "freeTickets": 4,
      "leadDownload": true,
      "leadExportUntil": "2026-12-13",
      "discountCodes": 10,
      "discountPercent": 25,
      "logoOnPage": true,
      "logoOnScreens": true,
      "logoOnBadges": true,
      "sponsoredSession": true
    },
    {
      "levelId": "b3ac0154-0000-4000-8000-000000000001",
      "eventId": "b3ac0000-0000-4000-8000-000000000001",
      "name": "Gold",
      "rank": 1,
      "colour": "#d97706",
      "staffAllowance": 4,
      "freeTickets": 2,
      "leadDownload": true,
      "leadExportUntil": "2026-11-27",
      "discountCodes": 5,
      "discountPercent": 15,
      "logoOnPage": true,
      "logoOnScreens": true,
      "logoOnBadges": false,
      "sponsoredSession": true
    }
  ],
  "nextCursor": "YzE6MDAwMDAwMTAwMDAwMDAwMDAwMXxiM2FjMDE1NDAwMDA0MDAwODAwMDAwMDAwMDAwMDAwMQ",
  "hasMore": true
}

400 invalidCursor.

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

List recent leads

GET/events/{eventId}/leads

Lists the newest leads that sponsors captured at the event, only those the visitor agreed to share, newest first.

Scopes: sponsors:read people:read
Modul: leads Afvises med moduleOff, så længe eventets arrangør har slået det fra.

Parametre

sti

eventIdstring (uuid)påkrævet
The event's id.

forespørgsel

limitinteger (int32)
How many leads to return, up to 100.
Standard: 25

Svar

200 The leads. LeadList
Felter
- dataLeadItem[]
  The leads, newest first.
  Vis felterne
  - sponsorSponsor
    A sponsor of the event.
    Vis felterne
    sponsorIdstring (uuid)
    The sponsor's id.
    namestring
    The sponsor's name.
  - leadLead
    A lead a sponsor captured, with the visitor's details only when they share them.
    Vis felterne
    leadIdstring (uuid)
    The lead's id.
    sharedboolean
    Whether the visitor's details are included.
    firstNamestring
    First name, when shared.
    lastNamestring
    Last name, when shared.
    companystring
    Company, when shared.
    jobTitlestring
    Job title, when shared.
    emailstring (email)
    Email address, when the visitor shares it too.
    originstring
    How the lead began: booth, request or session.
    ratinginteger
    The booth staff's rating: 1 cold, 2 warm, 3 hot.
    answersobject
    Answers to the sponsor's own questions, by question id.
    notestring
    The booth staff's note.
    capturedBystring
    Who scanned the badge first.
    capturedUtcstring (date-time)
    When, in UTC.
401 invalidKey, keyExpired, keyRevoked.
403 missingScope, peopleScope.
404 eventNotFound.
409 moduleOff.
429 rateLimited.

Afvisninger

invalidKey keyExpired keyRevoked rateLimited missingScope peopleScope moduleOff eventNotFound

Forespørgsel

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

const response = await fetch("https://attendbeacon.com/api/v1/events/b3ac0000-0000-4000-8000-000000000001/leads?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/b3ac0000-0000-4000-8000-000000000001/leads?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/b3ac0000-0000-4000-8000-000000000001/leads", 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/b3ac0000-0000-4000-8000-000000000001/leads?limit=2" -Headers $headers

200 Eksempel på svar

JSON

{
  "data": [
    {
      "sponsor": {
        "sponsorId": "b3ac0005-0000-4000-8000-000000000000",
        "name": "Northwind Cloud"
      },
      "lead": {
        "leadId": "b3ac0018-0000-4000-8000-000000000009",
        "shared": true,
        "firstName": "Julia",
        "lastName": "de Boer",
        "company": "Litware",
        "jobTitle": "Engineer",
        "email": null,
        "origin": "booth",
        "attendedSessionId": null,
        "rating": 2,
        "answers": {
          "interest": "platform",
          "followUp": true
        },
        "note": "Interested in the startup credits.",
        "capturedBy": "lotte.devries42@example.com",
        "capturedUtc": "2026-10-08T18:03:00.000Z",
        "updatedUtc": "2026-10-08T18:05:00.000Z"
      }
    },
    {
      "sponsor": {
        "sponsorId": "b3ac0005-0000-4000-8000-000000000000",
        "name": "Northwind Cloud"
      },
      "lead": {
        "leadId": "b3ac0018-0000-4000-8000-000000000008",
        "shared": true,
        "firstName": "Liam",
        "lastName": "Peters",
        "company": "Fabrikam",
        "jobTitle": "Product manager",
        "email": "liam.peters33@example.com",
        "origin": "booth",
        "attendedSessionId": null,
        "rating": 1,
        "answers": {
          "interest": "data",
          "followUp": false
        },
        "note": null,
        "capturedBy": "lotte.meijer26@example.com",
        "capturedUtc": "2026-10-08T17:56:00.000Z",
        "updatedUtc": "2026-10-08T17:58: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/events/b3ac0000-0000-4000-8000-000000000001/leads",
  "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."
}

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

#List sponsors

Parametre

Svar

Afvisninger

#List sponsor levels

Parametre

Svar

Afvisninger

#List recent leads

Parametre

Svar

Afvisninger

List sponsors

List sponsor levels

List recent leads