API-Referenz

Finance

Invoices, credit notes and the budget summary.

List invoices

GET/events/{eventId}/invoices

Lists an event's invoices and credit notes in their series' order. The buyer as printed needs people:read.

Scopes: finance:read
Modul: payments Wird mit moduleOff abgelehnt, solange der Veranstalter das Modul für die Veranstaltung ausgeschaltet hat.

Parameter

Pfad

eventIdstring (uuid)erforderlich
The event's id.

Query

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.
kindstring
Only invoices or only credit notes.
Einer von: invoice, creditNote

Antworten

200 A page of invoices. InvoiceList
Felder
- dataInvoice[]
  The items of this page.
  Felder anzeigen
  - invoiceIdstring (uuid)
    The document's id.
  - eventIdstring (uuid)
    The event's id.
  - orderIdstring (uuid)
    The order it is for.
  - kindstring
    Invoice or creditNote.
    Einer von: invoice, creditNote
  - numberstring
    Its number in the event's series.
  - correctsIdstring (uuid) oder null
    A credit note: the invoice it corrects.
  - issuedUtcstring (date-time)
    When it was issued, in UTC.
  - totalnumber
    The total, 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.
  - currencystring
    ISO 4217.
  - vatCurrencystring oder null
    The currency the VAT is also stated in, when the law asks for it.
  - vatConvertednumber oder null
    The VAT in that currency.
  - buyerobject oder null
    The buyer as printed on it. Null without people:read.
    Felder anzeigen
    namestring
    Name.
    emailstring
    Address.
    companystring oder null
    Company.
    addressstring oder null
    Postal address.
    vatNumberstring oder null
    VAT number.
    referencestring oder null
    Their reference.
  - sellerobject oder null
    The seller as printed on it: the organiser.
  - linesobject[] oder null
    Its lines: on one document only.
    Felder anzeigen
    ticketTypeIdstring (uuid)
    The ticket type.
    addOnIdstring (uuid) oder null
    The add-on, for an add-on line.
    namestring
    What it is.
    quantityinteger (int32)
    How many.
    unitPricenumber
    Each, VAT included. With the currency's own decimals: 147.00 in EUR, 147 in JPY, 147.000 in KWD.
    vatRatenumber
    The VAT rate.
    totalnumber
    The line. With the currency's own decimals: 147.00 in EUR, 147 in JPY, 147.000 in KWD.
    vatnumber
    Its VAT. With the currency's own decimals: 147.00 in EUR, 147 in JPY, 147.000 in KWD.
  - personalDatastring
    Whether the personal fields are here: included, withheld (the key lacks people:read) or erased (the person deleted their data).
    Einer von: included, withheld, erased
- nextCursorstring oder 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.
404 eventNotFound.
409 moduleOff.
429 rateLimited.

Ablehnungen

invalidKey keyExpired keyRevoked rateLimited missingScope moduleOff eventNotFound invalidCursor invalidUpdatedSince invalidRequest

Anfrage

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

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

200 Beispielantwort

JSON

{
  "data": [
    {
      "invoiceId": "b3ac0019-0000-4000-8000-000000000001",
      "eventId": "b3ac0000-0000-4000-8000-000000000001",
      "orderId": "b3ac0007-0000-4000-8000-00000000002d",
      "kind": "invoice",
      "number": "BS26-0001",
      "correctsId": null,
      "issuedUtc": "2026-08-29T21:45:47.963Z",
      "total": 395,
      "vat": 68.55,
      "currency": "EUR",
      "vatCurrency": null,
      "vatConverted": null,
      "buyer": {
        "name": "Jesse Meijer",
        "email": "jesse.meijer45@example.com",
        "company": "Proseware",
        "address": null,
        "vatNumber": null,
        "reference": null
      },
      "seller": {
        "enabled": true,
        "sellerName": "Beacon Events B.V.",
        "sellerAddress": "Voorbeeldstraat 12\n1011 AB Amsterdam\nThe Netherlands",
        "sellerVatNumber": "NL000000000B01",
        "sellerRegistration": "KvK 00000000",
        "prefix": "BS26-",
        "footer": "Questions about this invoice? billing@beaconsummit.example"
      },
      "lines": null,
      "personalData": "included"
    },
    {
      "invoiceId": "b3ac0019-0000-4000-8000-000000000002",
      "eventId": "b3ac0000-0000-4000-8000-000000000001",
      "orderId": "b3ac0007-0000-4000-8000-00000000002a",
      "kind": "invoice",
      "number": "BS26-0002",
      "correctsId": null,
      "issuedUtc": "2026-09-01T21:45:47.963Z",
      "total": 316,
      "vat": 54.84,
      "currency": "EUR",
      "vatCurrency": null,
      "vatConverted": null,
      "buyer": {
        "name": "Lotte de Vries",
        "email": "lotte.devries42@example.com",
        "company": "Northwind Cloud",
        "address": null,
        "vatNumber": null,
        "reference": null
      },
      "seller": {
        "enabled": true,
        "sellerName": "Beacon Events B.V.",
        "sellerAddress": "Voorbeeldstraat 12\n1011 AB Amsterdam\nThe Netherlands",
        "sellerVatNumber": "NL000000000B01",
        "sellerRegistration": "KvK 00000000",
        "prefix": "BS26-",
        "footer": "Questions about this invoice? billing@beaconsummit.example"
      },
      "lines": null,
      "personalData": "included"
    }
  ],
  "nextCursor": "YzE6MDAwMDAwMTAwMDAwMDAwMDAwMnxiM2FjMDAxOTAwMDA0MDAwODAwMDAwMDAwMDAwMDAwMg",
  "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/b3ac0000-0000-4000-8000-000000000001/invoices",
  "code": "invalidCursor",
  "traceId": "00-4bf92f3577b34da6a3ce929d0e0e4736-00f067aa0ba902b7-01",
  "error": "Pass nextCursor exactly as a list returned it, with the same filters."
}

Get an invoice

GET/events/{eventId}/invoices/{invoiceId}

Gets one invoice or credit note with its lines.

Scopes: finance:read
Modul: payments Wird mit moduleOff abgelehnt, solange der Veranstalter das Modul für die Veranstaltung ausgeschaltet hat.

Antwortet mit einem ETag; senden Sie If-None-Match, um sich einen Download zu sparen.

Parameter

Pfad

eventIdstring (uuid)erforderlich
The event's id.
invoiceIdstring (uuid)erforderlich
The invoice's or credit note's id.

Header

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

Antworten

200 The document. Invoice
Felder
- invoiceIdstring (uuid)
  The document's id.
- eventIdstring (uuid)
  The event's id.
- orderIdstring (uuid)
  The order it is for.
- kindstring
  Invoice or creditNote.
  Einer von: invoice, creditNote
- numberstring
  Its number in the event's series.
- correctsIdstring (uuid) oder null
  A credit note: the invoice it corrects.
- issuedUtcstring (date-time)
  When it was issued, in UTC.
- totalnumber
  The total, 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.
- currencystring
  ISO 4217.
- vatCurrencystring oder null
  The currency the VAT is also stated in, when the law asks for it.
- vatConvertednumber oder null
  The VAT in that currency.
- buyerobject oder null
  The buyer as printed on it. Null without people:read.
  Felder anzeigen
  - namestring
    Name.
  - emailstring
    Address.
  - companystring oder null
    Company.
  - addressstring oder null
    Postal address.
  - vatNumberstring oder null
    VAT number.
  - referencestring oder null
    Their reference.
- sellerobject oder null
  The seller as printed on it: the organiser.
- linesobject[] oder null
  Its lines: on one document only.
  Felder anzeigen
  - ticketTypeIdstring (uuid)
    The ticket type.
  - addOnIdstring (uuid) oder null
    The add-on, for an add-on line.
  - namestring
    What it is.
  - quantityinteger (int32)
    How many.
  - unitPricenumber
    Each, VAT included. With the currency's own decimals: 147.00 in EUR, 147 in JPY, 147.000 in KWD.
  - vatRatenumber
    The VAT rate.
  - totalnumber
    The line. With the currency's own decimals: 147.00 in EUR, 147 in JPY, 147.000 in KWD.
  - vatnumber
    Its VAT. With the currency's own decimals: 147.00 in EUR, 147 in JPY, 147.000 in KWD.
- personalDatastring
  Whether the personal fields are here: included, withheld (the key lacks people:read) or erased (the person deleted their data).
  Einer von: included, withheld, erased
304 Not modified: If-None-Match named the representation as it is.
401 invalidKey, keyExpired, keyRevoked.
403 missingScope.
404 eventNotFound, notFound.
409 moduleOff.
429 rateLimited.

Ablehnungen

invalidKey keyExpired keyRevoked rateLimited missingScope moduleOff eventNotFound notFound

Anfrage

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

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

200 Beispielantwort

JSON

{
  "invoiceId": "b3ac0019-0000-4000-8000-000000000001",
  "eventId": "b3ac0000-0000-4000-8000-000000000001",
  "orderId": "b3ac0007-0000-4000-8000-00000000002d",
  "kind": "invoice",
  "number": "BS26-0001",
  "correctsId": null,
  "issuedUtc": "2026-08-29T21:45:47.963Z",
  "total": 395,
  "vat": 68.55,
  "currency": "EUR",
  "vatCurrency": null,
  "vatConverted": null,
  "buyer": {
    "name": "Jesse Meijer",
    "email": "jesse.meijer45@example.com",
    "company": "Proseware",
    "address": null,
    "vatNumber": null,
    "reference": null
  },
  "seller": {
    "enabled": true,
    "sellerName": "Beacon Events B.V.",
    "sellerAddress": "Voorbeeldstraat 12\n1011 AB Amsterdam\nThe Netherlands",
    "sellerVatNumber": "NL000000000B01",
    "sellerRegistration": "KvK 00000000",
    "prefix": "BS26-",
    "footer": "Questions about this invoice? billing@beaconsummit.example"
  },
  "lines": [
    {
      "ticketTypeId": "b3ac0006-0000-4000-8000-000000000001",
      "addOnId": null,
      "name": "Conference pass",
      "quantity": 1,
      "unitPrice": 395,
      "vatRate": 21,
      "total": 395,
      "vat": 68.55
    }
  ],
  "personalData": "included"
}

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/invoices/{invoiceId}",
  "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 budget summary

GET/events/{eventId}/budget

Gets the event budget's summary, net of VAT: income, costs and result as budgeted, committed, actual and forecast, per category, with the break-even point.

Scopes: finance:read
Modul: budget Wird mit moduleOff abgelehnt, solange der Veranstalter das Modul für die Veranstaltung ausgeschaltet hat.

Parameter

Pfad

eventIdstring (uuid)erforderlich
The event's id.

Antworten

200 The summary. BudgetSummary
Felder
- eventIdstring (uuid)
  The event's id.
- currencystring
  ISO 4217.
- basisstring
  Always net: excluding VAT.
- attendeesinteger (int32)
  The attendees the forecast is for.
- incomeBudgetAmounts
  Amounts net of VAT.
  Felder anzeigen
  - budgetnumber
    Budgeted. With the currency's own decimals: 147.00 in EUR, 147 in JPY, 147.000 in KWD.
  - committednumber
    Committed: quotes accepted and invoices received. With the currency's own decimals: 147.00 in EUR, 147 in JPY, 147.000 in KWD.
  - actualnumber
    Invoiced, paid, and what AttendBeacon's own data says. With the currency's own decimals: 147.00 in EUR, 147 in JPY, 147.000 in KWD.
  - forecastnumber
    What it will come to. With the currency's own decimals: 147.00 in EUR, 147 in JPY, 147.000 in KWD.
  - paidnumber
    What moved through the bank. With the currency's own decimals: 147.00 in EUR, 147 in JPY, 147.000 in KWD.
- costsBudgetAmounts
  Amounts net of VAT.
  Felder anzeigen
  - budgetnumber
    Budgeted. With the currency's own decimals: 147.00 in EUR, 147 in JPY, 147.000 in KWD.
  - committednumber
    Committed: quotes accepted and invoices received. With the currency's own decimals: 147.00 in EUR, 147 in JPY, 147.000 in KWD.
  - actualnumber
    Invoiced, paid, and what AttendBeacon's own data says. With the currency's own decimals: 147.00 in EUR, 147 in JPY, 147.000 in KWD.
  - forecastnumber
    What it will come to. With the currency's own decimals: 147.00 in EUR, 147 in JPY, 147.000 in KWD.
  - paidnumber
    What moved through the bank. With the currency's own decimals: 147.00 in EUR, 147 in JPY, 147.000 in KWD.
- resultBudgetAmounts
  Amounts net of VAT.
  Felder anzeigen
  - budgetnumber
    Budgeted. With the currency's own decimals: 147.00 in EUR, 147 in JPY, 147.000 in KWD.
  - committednumber
    Committed: quotes accepted and invoices received. With the currency's own decimals: 147.00 in EUR, 147 in JPY, 147.000 in KWD.
  - actualnumber
    Invoiced, paid, and what AttendBeacon's own data says. With the currency's own decimals: 147.00 in EUR, 147 in JPY, 147.000 in KWD.
  - forecastnumber
    What it will come to. With the currency's own decimals: 147.00 in EUR, 147 in JPY, 147.000 in KWD.
  - paidnumber
    What moved through the bank. With the currency's own decimals: 147.00 in EUR, 147 in JPY, 147.000 in KWD.
- costPerAttendeenumber oder null
  Forecast costs per forecast attendee. With the currency's own decimals: 147.00 in EUR, 147 in JPY, 147.000 in KWD.
- breakEvenobject
  The break-even point.
  Felder anzeigen
  - ticketsinteger (int32) oder null
    Paid tickets needed at the average price.
  - paidTicketsinteger (int32)
    Paid tickets sold.
  - averagePaidTicketnumber
    The average paid ticket, net of VAT. With the currency's own decimals: 147.00 in EUR, 147 in JPY, 147.000 in KWD.
- categoriesobject[]
  Each category.
  Felder anzeigen
  - categoryIdstring (uuid)
    The category's id.
  - kindstring
    Income or cost.
  - keystring oder null
    A default category's key: tickets, venue, catering and others.
  - namestring oder null
    Its name.
  - budgetnumber
    Budgeted. With the currency's own decimals: 147.00 in EUR, 147 in JPY, 147.000 in KWD.
  - committednumber
    Committed. With the currency's own decimals: 147.00 in EUR, 147 in JPY, 147.000 in KWD.
  - actualnumber
    Actual. With the currency's own decimals: 147.00 in EUR, 147 in JPY, 147.000 in KWD.
  - forecastnumber
    Forecast. With the currency's own decimals: 147.00 in EUR, 147 in JPY, 147.000 in KWD.
  - paidnumber
    Paid. With the currency's own decimals: 147.00 in EUR, 147 in JPY, 147.000 in KWD.
- warningsstring[]
  What the planner noticed, as codes.
401 invalidKey, keyExpired, keyRevoked.
403 missingScope.
404 eventNotFound.
409 moduleOff.
429 rateLimited.

Ablehnungen

invalidKey keyExpired keyRevoked rateLimited missingScope moduleOff eventNotFound

Anfrage

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

const response = await fetch("https://attendbeacon.com/api/v1/events/b3ac0000-0000-4000-8000-000000000001/budget", {
  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/budget");

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/budget",
    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/budget" -Headers $headers

200 Beispielantwort

JSON

{
  "eventId": "b3ac0000-0000-4000-8000-000000000001",
  "currency": "EUR",
  "basis": "net",
  "attendees": 450,
  "income": {
    "budget": 125900,
    "committed": 69346.37,
    "actual": 62546.37,
    "forecast": 140835.02,
    "paid": 12664.14
  },
  "costs": {
    "budget": 130850,
    "committed": 84797.5,
    "actual": 20347.5,
    "forecast": 134741.15,
    "paid": 17277.79
  },
  "result": {
    "budget": -4950,
    "committed": -15451.13,
    "actual": 42198.87,
    "forecast": 6093.87,
    "paid": -4613.65
  },
  "costPerAttendee": 299.42,
  "breakEven": {
    "tickets": 241,
    "paidTickets": 46,
    "averagePaidTicket": 284.07
  },
  "categories": [
    {
      "categoryId": "b3ac6801-0000-4000-8000-000000000000",
      "kind": "income",
      "key": "tickets",
      "name": "Tickets",
      "budget": 62000,
      "committed": 13067.2,
      "actual": 13067.2,
      "forecast": 74433.42,
      "paid": 11434.97
    },
    {
      "categoryId": "b3ac6801-0000-4000-8000-000000000001",
      "kind": "income",
      "key": "addons",
      "name": "Add-ons",
      "budget": 4500,
      "committed": 1229.17,
      "actual": 1229.17,
      "forecast": 7001.6,
      "paid": 1229.17
    }
  ],
  "warnings": []
}

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/budget",
  "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."
}

Die Anleitungen und diese Website sind in Ihrer Sprache. Die Beschreibungen in der API-Referenz selbst sind auf Englisch, so wie die API selbst spricht.

#List invoices

Parameter

Antworten

Ablehnungen

#Get an invoice

Parameter

Antworten

Ablehnungen

#Get the budget summary

Parameter

Antworten

Ablehnungen

List invoices

Get an invoice

Get the budget summary