Billetweb MCP by usefulapi is an MCP server published by io.usefulapi, hosted at billetweb.usefulapi.io. When last checked on 2026-11-21 it was working: it answers and lists its tools. It declares 18 tools, including billetweb_list_events, billetweb_get_availability, billetweb_list_tickets, billetweb_list_sessions, billetweb_list_attendees.
Read events, seats, attendees, sales and payouts; check in tickets and create orders in Billetweb.
4,332 connections through 5 shared values. Tap any node.
Squares are this server's values; dots are other servers sharing them. A shared address or publisher is a lead, not proof of a common operator.
Inferred from the host name and headers: what a server runs on, not who runs it.
List the organiser's events with id, name, start/end, place, shop URL, online state, tax rate, tags and contact. Past events are left out unless include_past is set. GET /events.
| Parameter | Type | Description |
|---|---|---|
| limit | integer | Billetweb does not page its lists; at most this many rows are returned (default 100, max 500); the reply says when it was cut. |
| event_id | integer | Only this event. |
| online_only | boolean | Only published (online) events. |
| include_past | boolean | Also return past events (default: only current and upcoming). |
| include_description | boolean | Include each event's HTML description (long). |
{
"name": "billetweb_list_events",
"title": "List events",
"description": "List the organiser's events with id, name, start/end, place, shop URL, online state, tax rate, tags and contact. Past events are left out unless include_past is set. GET /events.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"limit": {
"type": "integer",
"maximum": 500,
"description": "Billetweb does not page its lists; at most this many rows are returned (default 100, max 500); the reply says when it was cut.",
"exclusiveMinimum": 0
},
"event_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Only this event.",
"exclusiveMinimum": 0
},
"online_only": {
"type": "boolean",
"description": "Only published (online) events."
},
"include_past": {
"type": "boolean",
"description": "Also return past events (default: only current and upcoming)."
},
"include_description": {
"type": "boolean",
"description": "Include each event's HTML description (long)."
}
}
},
"annotations": {
"title": "List events",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}Remaining places of an event: per session, per category and per ticket type, with avail (-1 = unlimited), quota and sales. Use it to answer 'how many seats are left'. GET /event/{id}/avail.
| Parameter | Type | Description |
|---|---|---|
| session | string | A session id or start time (YYYY-MM-DD HH:MM). Without it, all sessions of a multi-session event. |
| event_id * | integer | Billetweb event id (see billetweb_list_events). |
| include_past | boolean | Include past sessions. |
| include_carts | boolean | Count carts in progress as taken (temp=1). |
{
"name": "billetweb_get_availability",
"title": "Get availability",
"description": "Remaining places of an event: per session, per category and per ticket type, with avail (-1 = unlimited), quota and sales. Use it to answer 'how many seats are left'. GET /event/{id}/avail.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"event_id"
],
"properties": {
"session": {
"type": "string",
"maxLength": 40,
"minLength": 1,
"description": "A session id or start time (YYYY-MM-DD HH:MM). Without it, all sessions of a multi-session event."
},
"event_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Billetweb event id (see billetweb_list_events).",
"exclusiveMinimum": 0
},
"include_past": {
"type": "boolean",
"description": "Include past sessions."
},
"include_carts": {
"type": "boolean",
"description": "Count carts in progress as taken (temp=1)."
}
}
},
"annotations": {
"title": "Get availability",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}The ticket types (tarifs) of an event in display order: id, name, price, category, quota, visibility (0 visible, 1 web, 2 box office, 3 secret link, 4 hidden), sales window, tax and commission. GET /event/{id}/tickets.
| Parameter | Type | Description |
|---|---|---|
| limit | integer | Billetweb does not page its lists; at most this many rows are returned (default 200, max 1000); the reply says when it was cut. |
| event_id * | integer | Billetweb event id (see billetweb_list_events). |
| include_categories | boolean | Also return the categories (is_category = 1). |
{
"name": "billetweb_list_tickets",
"title": "List ticket types",
"description": "The ticket types (tarifs) of an event in display order: id, name, price, category, quota, visibility (0 visible, 1 web, 2 box office, 3 secret link, 4 hidden), sales window, tax and commission. GET /event/{id}/tickets.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"event_id"
],
"properties": {
"limit": {
"type": "integer",
"maximum": 1000,
"description": "Billetweb does not page its lists; at most this many rows are returned (default 200, max 1000); the reply says when it was cut.",
"exclusiveMinimum": 0
},
"event_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Billetweb event id (see billetweb_list_events).",
"exclusiveMinimum": 0
},
"include_categories": {
"type": "boolean",
"description": "Also return the categories (is_category = 1)."
}
}
},
"annotations": {
"title": "List ticket types",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}The sessions (séances, dates) of a multi-session event: id, start/end, name, place, quota, total_sales, state (0 open, 1 hidden, 2 box office only, 3 web only, 4 link only, 5 cancelled) and the ticket ids sold in it. GET /event/{id}/dates.
| Parameter | Type | Description |
|---|---|---|
| limit | integer | Billetweb does not page its lists; at most this many rows are returned (default 200, max 1000); the reply says when it was cut. |
| state | integer | Only sessions in this state (0 open, 1 hidden, 2 box office, 3 web, 4 link, 5 cancelled). |
| event_id * | integer | Billetweb event id (see billetweb_list_events). |
| start_to | string | Only sessions starting at or before this moment. |
| start_from | string | Only sessions starting at or after this moment (yyyy-mm-dd or ISO 8601 date-time with timezone). |
| include_past | boolean | Also return past sessions. |
| ended_within_days | integer | Sessions that ended in the last N days. |
{
"name": "billetweb_list_sessions",
"title": "List sessions",
"description": "The sessions (séances, dates) of a multi-session event: id, start/end, name, place, quota, total_sales, state (0 open, 1 hidden, 2 box office only, 3 web only, 4 link only, 5 cancelled) and the ticket ids sold in it. GET /event/{id}/dates.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"event_id"
],
"properties": {
"limit": {
"type": "integer",
"maximum": 1000,
"description": "Billetweb does not page its lists; at most this many rows are returned (default 200, max 1000); the reply says when it was cut.",
"exclusiveMinimum": 0
},
"state": {
"type": "integer",
"maximum": 5,
"minimum": 0,
"description": "Only sessions in this state (0 open, 1 hidden, 2 box office, 3 web, 4 link, 5 cancelled)."
},
"event_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Billetweb event id (see billetweb_list_events).",
"exclusiveMinimum": 0
},
"start_to": {
"type": "string",
"description": "Only sessions starting at or before this moment."
},
"start_from": {
"type": "string",
"description": "Only sessions starting at or after this moment (yyyy-mm-dd or ISO 8601 date-time with timezone)."
},
"include_past": {
"type": "boolean",
"description": "Also return past sessions."
},
"ended_within_days": {
"type": "integer",
"maximum": 3650,
"description": "Sessions that ended in the last N days.",
"exclusiveMinimum": 0
}
}
},
"annotations": {
"title": "List sessions",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}The attendees (one row per ticket) of one event: name, email, ticket type, price, check-in state (used), session, order id and payment, custom form answers. Filter by session, ticket, buyer, check-in state or when the order changed; use updated_since to fetch only what is new. Billetweb allows 10 attendees calls per minute (shared with billetweb_list_all_attendees), so prefer one filtered call. GET /event/{id}/attendees.
| Parameter | Type | Description |
|---|---|---|
| used | integer | Ticket state: 0 not checked in, 1 checked in, 2 checked out, 3 expired. |
| string | Only this buyer's email address. | |
| limit | integer | Billetweb does not page its lists; at most this many rows are returned (default 50, max 500); the reply says when it was cut. |
| barcode | string | Only the ticket with this barcode. |
| event_id * | integer | Billetweb event id (see billetweb_list_events). |
| order_id | integer | Only this Billetweb order id. |
| ticket_id | integer | Only this ticket type (tarif) id, from billetweb_list_tickets. |
| created_to | string | Only orders created on or before this date, whole day included (yyyy-mm-dd). |
| session_id |
The attendees of ALL events, newest changes included, with the same fields as billetweb_list_attendees. Filter by event tag, only unfinished events, buyer, ticket, check-in state or order change time. Billetweb allows 10 attendees calls per minute; use updated_since for incremental reads. GET /attendees.
| Parameter | Type | Description |
|---|---|---|
| tag | string | Only events carrying this keyword (alphanumeric). |
| used | integer | Ticket state: 0 not checked in, 1 checked in, 2 checked out, 3 expired. |
| string | Only this buyer's email address. | |
| limit | integer | Billetweb does not page its lists; at most this many rows are returned (default 50, max 500); the reply says when it was cut. |
| ticket_id | integer | Only this ticket type (tarif) id, from billetweb_list_tickets. |
| created_to | string | Only orders created on or before this date, whole day included (yyyy-mm-dd). |
| created_from | string | Only orders created on or after this date (yyyy-mm-dd). |
| include_links | boolean | Keep the per-ticket download / manage-order links (default: dropped, they open the buyer's ticket). |
| only_refunded |
People on the waiting list of an event: name, email, phone, ticket/session wanted, places asked for and whether they were notified. GET /event/{id}/waiting.
| Parameter | Type | Description |
|---|---|---|
| limit | integer | Billetweb does not page its lists; at most this many rows are returned (default 100, max 1000); the reply says when it was cut. |
| event_id * | integer | Billetweb event id (see billetweb_list_events). |
{
"name": "billetweb_list_waiting_list",
"title": "List waiting list",
"description": "People on the waiting list of an event: name, email, phone, ticket/session wanted, places asked for and whether they were notified. GET /event/{id}/waiting.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"event_id"
],
"properties": {
"limit": {
"type": "integer",
"maximum": 1000,
"description": "Billetweb does not page its lists; at most this many rows are returned (default 100, max 1000); the reply says when it was cut.",
"exclusiveMinimum": 0
},
"event_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Billetweb event id (see billetweb_list_events).",
"exclusiveMinimum": 0
}
}
},
"annotations": {
"title": "List waiting list",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}The accounting history: one row per ticket and per money movement, type product_pay (sale) or product_refund (negative price), with price incl. tax, Billetweb fees, tax, payment type, transaction id and payout id (0 = not paid out yet). Period at most 1 year, starting at most 1 year ago. GET /accounting.
| Parameter | Type | Description |
|---|---|---|
| end | string | End of the period (default: now). |
| limit | integer | Billetweb does not page its lists; at most this many rows are returned (default 200, max 2000); the reply says when it was cut. |
| start * | string | Start of the period (yyyy-mm-dd or ISO 8601 date-time with timezone). |
| channel | string | Only online (web) sales, or only the other channels (box office, offline orders). |
| event_id | integer | Only this event. |
{
"name": "billetweb_list_accounting",
"title": "List sales and refunds (accounting)",
"description": "The accounting history: one row per ticket and per money movement, type product_pay (sale) or product_refund (negative price), with price incl. tax, Billetweb fees, tax, payment type, transaction id and payout id (0 = not paid out yet). Period at most 1 year, starting at most 1 year ago. GET /accounting.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"start"
],
"properties": {
"end": {
"type": "string",
"description": "End of the period (default: now)."
},
"limit": {
"type": "integer",
"maximum": 2000,
"description": "Billetweb does not page its lists; at most this many rows are returned (default 200, max 2000); the reply says when it was cut.",
"exclusiveMinimum": 0
},
"start": {
"type": "string",
"description": "Start of the period (yyyy-mm-dd or ISO 8601 date-time with timezone)."
},
"channel": {
"enum": [
"web",
"other"
],
"type": "string",
"description": "Only online (web) sales, or only the other channels (box office, offline orders)."
},
"event_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Only this event.",
"exclusiveMinimum": 0
}
}
},
"annotations": {
"title": "List sales and refunds",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}The bank transfers Billetweb made to the organiser (type out) or took back (type in, negative amount): id, date, net amount, account holder. The IBAN is masked to its last 4 characters. GET /payouts.
| Parameter | Type | Description |
|---|---|---|
| date | string | Only the payouts of this day (yyyy-mm-dd). |
| limit | integer | Billetweb does not page its lists; at most this many rows are returned (default 100, max 1000); the reply says when it was cut. |
{
"name": "billetweb_list_payouts",
"title": "List payouts",
"description": "The bank transfers Billetweb made to the organiser (type out) or took back (type in, negative amount): id, date, net amount, account holder. The IBAN is masked to its last 4 characters. GET /payouts.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"date": {
"type": "string",
"pattern": "^(\\d{4})-(\\d{2})-(\\d{2})$",
"description": "Only the payouts of this day (yyyy-mm-dd)."
},
"limit": {
"type": "integer",
"maximum": 1000,
"description": "Billetweb does not page its lists; at most this many rows are returned (default 100, max 1000); the reply says when it was cut.",
"exclusiveMinimum": 0
}
}
},
"annotations": {
"title": "List payouts",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}The line-by-line detail of one payout: each sale, refund or transfer with ticket reference, order, event, price, fees and tax. Net transferred = sum of price minus sum of fees. Pass a payout id, or a date (yyyy-mm-dd) for all payouts of that day. GET /payout/{id}/data.
| Parameter | Type | Description |
|---|---|---|
| limit | integer | Billetweb does not page its lists; at most this many rows are returned (default 200, max 2000); the reply says when it was cut. |
| payout * | string | Payout id (from billetweb_list_payouts) or a date yyyy-mm-dd. |
{
"name": "billetweb_get_payout",
"title": "Get payout detail",
"description": "The line-by-line detail of one payout: each sale, refund or transfer with ticket reference, order, event, price, fees and tax. Net transferred = sum of price minus sum of fees. Pass a payout id, or a date (yyyy-mm-dd) for all payouts of that day. GET /payout/{id}/data.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"payout"
],
"properties": {
"limit": {
"type": "integer",
"maximum": 2000,
"description": "Billetweb does not page its lists; at most this many rows are returned (default 200, max 2000); the reply says when it was cut.",
"exclusiveMinimum": 0
},
"payout": {
"type": "string",
"pattern": "^(\\d{1,15}|\\d{4}-\\d{2}-\\d{2})$",
"description": "Payout id (from billetweb_list_payouts) or a date yyyy-mm-dd."
}
}
},
"annotations": {
"title": "Get payout detail",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}The organiser's buyer contacts: name, email, first/last purchase, number of orders and tickets, total spent and average ticket price. Filter by email, CRM segment or last change. GET /crm/contacts.
| Parameter | Type | Description |
|---|---|---|
| string | Only this email address. | |
| limit | integer | Billetweb does not page its lists; at most this many rows are returned (default 100, max 1000); the reply says when it was cut. |
| segment_id | integer | Only the contacts of this CRM segment (billetweb_list_crm_segments). |
| updated_since | string | Only contacts changed after this moment. |
| updated_before | string | Only contacts changed before this moment. |
{
"name": "billetweb_list_crm_contacts",
"title": "List CRM contacts",
"description": "The organiser's buyer contacts: name, email, first/last purchase, number of orders and tickets, total spent and average ticket price. Filter by email, CRM segment or last change. GET /crm/contacts.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"email": {
"type": "string",
"maxLength": 200,
"minLength": 3,
"description": "Only this email address."
},
"limit": {
"type": "integer",
"maximum": 1000,
"description": "Billetweb does not page its lists; at most this many rows are returned (default 100, max 1000); the reply says when it was cut.",
"exclusiveMinimum": 0
},
"segment_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Only the contacts of this CRM segment (billetweb_list_crm_segments).",
"exclusiveMinimum": 0
},
"updated_since": {
"type": "string",
"description": "Only contacts changed after this moment."
},
"updated_before": {
"type": "string",
"description": "Only contacts changed before this moment."
}
}
},
"annotations": {
"title": "List CRM contacts",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}The saved CRM segments (id, name, created, last sync). Use an id as the segment filter of billetweb_list_crm_contacts. GET /crm/segments.
| Parameter | Type | Description |
|---|---|---|
| limit | integer | Billetweb does not page its lists; at most this many rows are returned (default 100, max 500); the reply says when it was cut. |
{
"name": "billetweb_list_crm_segments",
"title": "List CRM segments",
"description": "The saved CRM segments (id, name, created, last sync). Use an id as the segment filter of billetweb_list_crm_contacts. GET /crm/segments.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"limit": {
"type": "integer",
"maximum": 500,
"description": "Billetweb does not page its lists; at most this many rows are returned (default 100, max 500); the reply says when it was cut.",
"exclusiveMinimum": 0
}
}
},
"annotations": {
"title": "List CRM segments",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}The organiser's custom lists (id, name, key type), such as member or invitation lists used for access control and discounts. GET /lists.
| Parameter | Type | Description |
|---|---|---|
| limit | integer | Billetweb does not page its lists; at most this many rows are returned (default 100, max 500); the reply says when it was cut. |
{
"name": "billetweb_list_lists",
"title": "List custom lists",
"description": "The organiser's custom lists (id, name, key type), such as member or invitation lists used for access control and discounts. GET /lists.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"limit": {
"type": "integer",
"maximum": 500,
"description": "Billetweb does not page its lists; at most this many rows are returned (default 100, max 500); the reply says when it was cut.",
"exclusiveMinimum": 0
}
}
},
"annotations": {
"title": "List custom lists",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}The rows of one custom list (each row is an array of values, the first being the key). GET /list/{id}/data.
| Parameter | Type | Description |
|---|---|---|
| limit | integer | Billetweb does not page its lists; at most this many rows are returned (default 200, max 5000); the reply says when it was cut. |
| list_id * | integer | List id, from billetweb_list_lists. |
{
"name": "billetweb_get_list_data",
"title": "Get custom list content",
"description": "The rows of one custom list (each row is an array of values, the first being the key). GET /list/{id}/data.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"list_id"
],
"properties": {
"limit": {
"type": "integer",
"maximum": 5000,
"description": "Billetweb does not page its lists; at most this many rows are returned (default 200, max 5000); the reply says when it was cut.",
"exclusiveMinimum": 0
},
"list_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "List id, from billetweb_list_lists.",
"exclusiveMinimum": 0
}
}
},
"annotations": {
"title": "Get custom list content",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}WRITE: set the check-in state of tickets (composter): 1 = checked in, 2 = checked out, 0 = back to not checked in. Tickets are identified by the ticket id from billetweb_list_attendees (the `id` field, not the order id). Setting the same state again is harmless. Needs a read+write key. POST /event/{id}/check.
| Parameter | Type | Description |
|---|---|---|
| tickets * | array | 1-100 tickets and their new state. |
| event_id * | integer | Billetweb event id (see billetweb_list_events). |
{
"name": "billetweb_check_tickets",
"title": "Check tickets in or out",
"description": "WRITE: set the check-in state of tickets (composter): 1 = checked in, 2 = checked out, 0 = back to not checked in. Tickets are identified by the ticket id from billetweb_list_attendees (the `id` field, not the order id). Setting the same state again is harmless. Needs a read+write key. POST /event/{id}/check.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"event_id",
"tickets"
],
"properties": {
"tickets": {
"type": "array",
"items": {
"type": "object",
"required": [
"id",
"used"
],
"properties": {
"id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Ticket (attendee) id.",
"exclusiveMinimum": 0
},
"lane": {
"type": "string",
"maxLength": 100,
"minLength": 1,
"description": "Name of the check-in point (optional)."
},
"used": {
"type": "integer",
"maximum": 2,
"minimum": 0,
"description": "0 not checked in, 1 checked in, 2 checked out."
}
}
},
"maxItems": 100,
"minItems": 1,
"description": "1-100 tickets and their new state."
},
"event_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Billetweb event id (see billetweb_list_events).",
"exclusiveMinimum": 0
}
}
},
"annotations": {
"title": "Check tickets in or out",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": true
}
}WRITE: confirm the payment of reservation orders (unpaid orders taken as a reservation) with the payment type you were given (card, cash, check, reservation, other). With send_confirmation the BUYER GETS AN EMAIL with the tickets; default is no email. The order id is `order_id` in billetweb_list_attendees. Needs a read+write key. POST /event/{id}/pay_order.
| Parameter | Type | Description |
|---|---|---|
| orders * | array | 1-50 reservations to confirm. |
| event_id * | integer | Billetweb event id (see billetweb_list_events). |
{
"name": "billetweb_mark_orders_paid",
"title": "Mark reservations as paid",
"description": "WRITE: confirm the payment of reservation orders (unpaid orders taken as a reservation) with the payment type you were given (card, cash, check, reservation, other). With send_confirmation the BUYER GETS AN EMAIL with the tickets; default is no email. The order id is `order_id` in billetweb_list_attendees. Needs a read+write key. POST /event/{id}/pay_order.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"event_id",
"orders"
],
"properties": {
"orders": {
"type": "array",
"items": {
"type": "object",
"required": [
"order_id",
"payment_type"
],
"properties": {
"order_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Billetweb order id.",
"exclusiveMinimum": 0
},
"payment_type": {
"enum": [
"reservation",
"other",
"card",
"cash",
"check"
],
"type": "string",
"description": "How it was paid."
},
"send_confirmation": {
"type": "boolean",
"description": "Email the confirmation with the tickets to the buyer (default false)."
}
}
},
"maxItems": 50,
"minItems": 1,
"description": "1-50 reservations to confirm."
},
"event_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Billetweb event id (see billetweb_list_events).",
"exclusiveMinimum": 0
}
}
},
"annotations": {
"title": "Mark reservations as paid",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": true
}
}WRITE: SENDS AN EMAIL to each buyer asking them to pay their unpaid reservation. Customers receive it immediately; it cannot be recalled. The order id is `order_id` in billetweb_list_attendees. Needs a read+write key. POST /event/{id}/pay_request.
| Parameter | Type | Description |
|---|---|---|
| event_id * | integer | Billetweb event id (see billetweb_list_events). |
| order_ids * | array | 1-50 unpaid reservation order ids. |
{
"name": "billetweb_send_payment_requests",
"title": "Send payment request emails",
"description": "WRITE: SENDS AN EMAIL to each buyer asking them to pay their unpaid reservation. Customers receive it immediately; it cannot be recalled. The order id is `order_id` in billetweb_list_attendees. Needs a read+write key. POST /event/{id}/pay_request.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"event_id",
"order_ids"
],
"properties": {
"event_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Billetweb event id (see billetweb_list_events).",
"exclusiveMinimum": 0
},
"order_ids": {
"type": "array",
"items": {
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
},
"maxItems": 50,
"minItems": 1,
"description": "1-50 unpaid reservation order ids."
}
}
},
"annotations": {
"title": "Send payment request emails",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": true
}
}WRITE: CREATE new orders (tickets) in an event as if sold off-line: each order takes places from the quota and is recorded as paid with the given payment type (card, cash, check, invitation, reservation, other). Only basic tickets (no choice passes, packs or seat placement). With send_tickets the BUYER GETS THE TICKETS BY EMAIL (default: no email). NOT idempotent: calling twice creates two orders, so pass request_id and check billetweb_list_attendees before retrying. Needs a read+write key. POST /event/{id}/add_order.
| Parameter | Type | Description |
|---|---|---|
| orders * | array | 1-20 orders to create. |
| event_id * | integer | Billetweb event id (see billetweb_list_events). |
{
"name": "billetweb_create_offline_orders",
"title": "Create offline orders",
"description": "WRITE: CREATE new orders (tickets) in an event as if sold off-line: each order takes places from the quota and is recorded as paid with the given payment type (card, cash, check, invitation, reservation, other). Only basic tickets (no choice passes, packs or seat placement). With send_tickets the BUYER GETS THE TICKETS BY EMAIL (default: no email). NOT idempotent: calling twice creates two orders, so pass request_id and check billetweb_list_attendees before retrying. Needs a read+write key. POST /event/{id}/add_order.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"event_id",
"orders"
],
"properties": {
"orders": {
"type": "array",
"items": {
"type": "object",
"required": [
"payment_type",
"products"
],
"properties": {
"name": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "Buyer last name."
},
"email": {
"type": "string",
"maxLength": 200,
"minLength": 3,
"description": "Buyer email (needed for send_tickets)."
},
"session": {
"type": "string",
"maxLength": 40,
"minLength": 1,
"description": "Session id or start time (YYYY-MM-DD HH:MM) for a multi-session event."
},
"language": {
"type": "string",
"pattern": "^[a-z]{2}(-[A-Za-z]{2})?$",
"description": "Language of the order, e.g. fr, en."
},
"products": {
"type": "array",
"items": {
"type": "object",
"required": [
"ticket"
],
"properties": {
"name": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "Attendee last name."
},
"email": {
"type": "string",
"maxLength": 200,
"minLength": 3,
"description": "Attendee email."
},
"price": {
"type": "number",
"maximum": 1000000,
"minimum": 0,
"description": "Custom price (default: the ticket type's price)."
},
"ticket": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "Ticket type id or exact name (billetweb_list_tickets)."
},
"firstname": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "Attendee first name."
},
"request_id": {
"type": "string",
"maxLength": 100,
"minLength": 1,
"description": "Your own id for this ticket, echoed back."
}
}
},
"maxItems": 100,
"minItems": 1,
"description": "1-100 tickets in the order."
},
"firstname": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "Buyer first name."
},
"request_id": {
"type": "string",
"maxLength": 100,
"minLength": 1,
"description": "Your own id for the order, echoed back."
},
"payment_type": {
"enum": [
"card",
"cash",
"check",
"invitation",
"reservation",
"other"
],
"type": "string",
"description": "How the order was paid."
},
"send_tickets": {
"type": "boolean",
"description": "Email the tickets to the buyer (default false)."
}
}
},
"maxItems": 20,
"minItems": 1,
"description": "1-20 orders to create."
},
"event_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Billetweb event id (see billetweb_list_events).",
"exclusiveMinimum": 0
}
}
},
"annotations": {
"title": "Create offline orders",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": false
}
}Tools for Billetweb, hosted by usefulapi.io. If the user is new or asks what this server can do, suggest requests such as: "How many tickets are left for my next event?"; "Who has not checked in yet for Saturday's session?"; "How much did I sell last month and when is my next payout?". Read-only tools never change data; ask the user before a tool that creates, changes or deletes Billetweb data. Free plan: 50 tool calls per month. Run billetweb_usage_status to see the calls used this month. If the user asks for something none of these tools can do, tell the user and, with their OK, run billetweb_request_feature to record the request. Paid plans: Pro (10,000 tool calls a month, $9/month or $90/year, for normal use) and Pro+ (100,000 tool calls a month, $39/month or $390/year, for automations and heavy use). A plan can be cancelled at any time and then runs to the end of the paid period, so it also suits a one-time job. When the user wants more calls or reaches the limit, run billetweb_upgrade without a plan: it returns both plans, each with a payment link for the user to open. billetweb_cancel_subscription cancels Pro at the end of the paid period.
Names, descriptions and schemas were written by the server and are shown as data.
Pattern matches on what the server declares. They show what it says it can do, not what it does.
None yet. Changes appear after a server's second daily check.
| integer |
| Session (séance) id, from billetweb_list_sessions. |
| created_from | string | Only orders created on or after this date (yyyy-mm-dd). |
| include_links | boolean | Keep the per-ticket download / manage-order links (default: dropped, they open the buyer's ticket). |
| only_refunded | boolean | Return only refunded or cancelled tickets. |
| updated_since | string | Only orders created or modified after this moment (yyyy-mm-dd or ISO 8601 date-time with timezone). |
| updated_before | string | Only orders created or modified before this moment. |
| include_refunded | boolean | Also return refunded or cancelled tickets. |
| only_future_sessions | boolean | Only sessions that have not passed. |
| updated_within_minutes | integer | Only orders created or modified in the last N minutes. |
{
"name": "billetweb_list_attendees",
"title": "List attendees of an event",
"description": "The attendees (one row per ticket) of one event: name, email, ticket type, price, check-in state (used), session, order id and payment, custom form answers. Filter by session, ticket, buyer, check-in state or when the order changed; use updated_since to fetch only what is new. Billetweb allows 10 attendees calls per minute (shared with billetweb_list_all_attendees), so prefer one filtered call. GET /event/{id}/attendees.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"event_id"
],
"properties": {
"used": {
"type": "integer",
"maximum": 3,
"minimum": 0,
"description": "Ticket state: 0 not checked in, 1 checked in, 2 checked out, 3 expired."
},
"email": {
"type": "string",
"maxLength": 200,
"minLength": 3,
"description": "Only this buyer's email address."
},
"limit": {
"type": "integer",
"maximum": 500,
"description": "Billetweb does not page its lists; at most this many rows are returned (default 50, max 500); the reply says when it was cut.",
"exclusiveMinimum": 0
},
"barcode": {
"type": "string",
"maxLength": 100,
"minLength": 1,
"description": "Only the ticket with this barcode."
},
"event_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Billetweb event id (see billetweb_list_events).",
"exclusiveMinimum": 0
},
"order_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Only this Billetweb order id.",
"exclusiveMinimum": 0
},
"ticket_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Only this ticket type (tarif) id, from billetweb_list_tickets.",
"exclusiveMinimum": 0
},
"created_to": {
"type": "string",
"pattern": "^(\\d{4})-(\\d{2})-(\\d{2})$",
"description": "Only orders created on or before this date, whole day included (yyyy-mm-dd)."
},
"session_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Session (séance) id, from billetweb_list_sessions.",
"exclusiveMinimum": 0
},
"created_from": {
"type": "string",
"pattern": "^(\\d{4})-(\\d{2})-(\\d{2})$",
"description": "Only orders created on or after this date (yyyy-mm-dd)."
},
"include_links": {
"type": "boolean",
"description": "Keep the per-ticket download / manage-order links (default: dropped, they open the buyer's ticket)."
},
"only_refunded": {
"type": "boolean",
"description": "Return only refunded or cancelled tickets."
},
"updated_since": {
"type": "string",
"description": "Only orders created or modified after this moment (yyyy-mm-dd or ISO 8601 date-time with timezone)."
},
"updated_before": {
"type": "string",
"description": "Only orders created or modified before this moment."
},
"include_refunded": {
"type": "boolean",
"description": "Also return refunded or cancelled tickets."
},
"only_future_sessions": {
"type": "boolean",
"description": "Only sessions that have not passed."
},
"updated_within_minutes": {
"type": "integer",
"maximum": 5256000,
"description": "Only orders created or modified in the last N minutes.",
"exclusiveMinimum": 0
}
}
},
"annotations": {
"title": "List attendees of an event",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}| boolean |
| Return only refunded or cancelled tickets. |
| updated_since | string | Only orders created or modified after this moment (yyyy-mm-dd or ISO 8601 date-time with timezone). |
| updated_before | string | Only orders created or modified before this moment. |
| include_refunded | boolean | Also return refunded or cancelled tickets. |
| only_unfinished_events | boolean | Only events that are not over. |
| updated_within_minutes | integer | Only orders created or modified in the last N minutes. |
{
"name": "billetweb_list_all_attendees",
"title": "List attendees across all events",
"description": "The attendees of ALL events, newest changes included, with the same fields as billetweb_list_attendees. Filter by event tag, only unfinished events, buyer, ticket, check-in state or order change time. Billetweb allows 10 attendees calls per minute; use updated_since for incremental reads. GET /attendees.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"tag": {
"type": "string",
"pattern": "^[A-Za-z0-9]{1,50}$",
"description": "Only events carrying this keyword (alphanumeric)."
},
"used": {
"type": "integer",
"maximum": 3,
"minimum": 0,
"description": "Ticket state: 0 not checked in, 1 checked in, 2 checked out, 3 expired."
},
"email": {
"type": "string",
"maxLength": 200,
"minLength": 3,
"description": "Only this buyer's email address."
},
"limit": {
"type": "integer",
"maximum": 500,
"description": "Billetweb does not page its lists; at most this many rows are returned (default 50, max 500); the reply says when it was cut.",
"exclusiveMinimum": 0
},
"ticket_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Only this ticket type (tarif) id, from billetweb_list_tickets.",
"exclusiveMinimum": 0
},
"created_to": {
"type": "string",
"pattern": "^(\\d{4})-(\\d{2})-(\\d{2})$",
"description": "Only orders created on or before this date, whole day included (yyyy-mm-dd)."
},
"created_from": {
"type": "string",
"pattern": "^(\\d{4})-(\\d{2})-(\\d{2})$",
"description": "Only orders created on or after this date (yyyy-mm-dd)."
},
"include_links": {
"type": "boolean",
"description": "Keep the per-ticket download / manage-order links (default: dropped, they open the buyer's ticket)."
},
"only_refunded": {
"type": "boolean",
"description": "Return only refunded or cancelled tickets."
},
"updated_since": {
"type": "string",
"description": "Only orders created or modified after this moment (yyyy-mm-dd or ISO 8601 date-time with timezone)."
},
"updated_before": {
"type": "string",
"description": "Only orders created or modified before this moment."
},
"include_refunded": {
"type": "boolean",
"description": "Also return refunded or cancelled tickets."
},
"only_unfinished_events": {
"type": "boolean",
"description": "Only events that are not over."
},
"updated_within_minutes": {
"type": "integer",
"maximum": 5256000,
"description": "Only orders created or modified in the last N minutes.",
"exclusiveMinimum": 0
}
}
},
"annotations": {
"title": "List attendees across all events",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}