Referencia de la API

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.

Ámbitos: finance:read
Módulo: payments Se rechaza con moduleOff mientras el organizador del evento lo tenga desactivado.

Parámetros

ruta

eventIdstring (uuid)obligatorio
The event's id.

consulta

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.
Por defecto: 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.
Uno de: invoice, creditNote

Respuestas

200 A page of invoices. InvoiceList
Campos
- dataInvoice[]
  The items of this page.
  Mostrar los campos
  - invoiceIdstring (uuid)
    The document's id.
  - eventIdstring (uuid)
    The event's id.
  - orderIdstring (uuid)
    The order it is for.
  - kindstring
    Invoice or creditNote.
    Uno de: invoice, creditNote
  - numberstring
    Its number in the event's series.
  - correctsIdstring (uuid) o 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 o null
    The currency the VAT is also stated in, when the law asks for it.
  - vatConvertednumber o null
    The VAT in that currency.
  - buyerobject o null
    The buyer as printed on it. Null without people:read.
    Mostrar los campos
    namestring
    Name.
    emailstring
    Address.
    companystring o null
    Company.
    addressstring o null
    Postal address.
    vatNumberstring o null
    VAT number.
    referencestring o null
    Their reference.
  - sellerobject o null
    The seller as printed on it: the organiser.
  - linesobject[] o null
    Its lines: on one document only.
    Mostrar los campos
    ticketTypeIdstring (uuid)
    The ticket type.
    addOnIdstring (uuid) o 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).
    Uno de: included, withheld, erased
- nextCursorstring o 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.

Rechazos

invalidKey keyExpired keyRevoked rateLimited missingScope moduleOff eventNotFound invalidCursor invalidUpdatedSince invalidRequest

Solicitud

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 Respuesta de ejemplo

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.

Ámbitos: finance:read
Módulo: payments Se rechaza con moduleOff mientras el organizador del evento lo tenga desactivado.

Responde con un ETag; envía If-None-Match para ahorrarte una descarga.

Parámetros

ruta

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

cabecera

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

Respuestas

200 The document. Invoice
Campos
- invoiceIdstring (uuid)
  The document's id.
- eventIdstring (uuid)
  The event's id.
- orderIdstring (uuid)
  The order it is for.
- kindstring
  Invoice or creditNote.
  Uno de: invoice, creditNote
- numberstring
  Its number in the event's series.
- correctsIdstring (uuid) o 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 o null
  The currency the VAT is also stated in, when the law asks for it.
- vatConvertednumber o null
  The VAT in that currency.
- buyerobject o null
  The buyer as printed on it. Null without people:read.
  Mostrar los campos
  - namestring
    Name.
  - emailstring
    Address.
  - companystring o null
    Company.
  - addressstring o null
    Postal address.
  - vatNumberstring o null
    VAT number.
  - referencestring o null
    Their reference.
- sellerobject o null
  The seller as printed on it: the organiser.
- linesobject[] o null
  Its lines: on one document only.
  Mostrar los campos
  - ticketTypeIdstring (uuid)
    The ticket type.
  - addOnIdstring (uuid) o 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).
  Uno de: 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.

Rechazos

invalidKey keyExpired keyRevoked rateLimited missingScope moduleOff eventNotFound notFound

Solicitud

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 Respuesta de ejemplo

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.

Ámbitos: finance:read
Módulo: budget Se rechaza con moduleOff mientras el organizador del evento lo tenga desactivado.

Parámetros

ruta

eventIdstring (uuid)obligatorio
The event's id.

Respuestas

200 The summary. BudgetSummary
Campos
- 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.
  Mostrar los campos
  - 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.
  Mostrar los campos
  - 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.
  Mostrar los campos
  - 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 o 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.
  Mostrar los campos
  - ticketsinteger (int32) o 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.
  Mostrar los campos
  - categoryIdstring (uuid)
    The category's id.
  - kindstring
    Income or cost.
  - keystring o null
    A default category's key: tickets, venue, catering and others.
  - namestring o 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.

Rechazos

invalidKey keyExpired keyRevoked rateLimited missingScope moduleOff eventNotFound

Solicitud

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 Respuesta de ejemplo

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."
}

Las guías y este sitio están en tu idioma. Las descripciones de la referencia de la API están en inglés, el idioma de la propia API.

#List invoices

Parámetros

Respuestas

Rechazos

#Get an invoice

Parámetros

Respuestas

Rechazos

#Get the budget summary

Parámetros

Respuestas

Rechazos

List invoices

Get an invoice

Get the budget summary