Create order
curl --request POST \
--url https://api.tickable.io/orders \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"event_id": "550e8400-e29b-41d4-a716-446655440000",
"lines": [
{
"ticket_type_id": "b2c4e6a8-1234-4f5a-9c8d-0e1f2a3b4c5d",
"amount": 2
}
],
"timeslot_id": "d4e5f6a7-8901-4b2c-3d4e-5f6a7b8c9d0e",
"buyer": {},
"payment": "link",
"expires_at": "2026-06-10T18:00:00Z",
"send_mail": true
}
'import requests
url = "https://api.tickable.io/orders"
payload = {
"event_id": "550e8400-e29b-41d4-a716-446655440000",
"lines": [
{
"ticket_type_id": "b2c4e6a8-1234-4f5a-9c8d-0e1f2a3b4c5d",
"amount": 2
}
],
"timeslot_id": "d4e5f6a7-8901-4b2c-3d4e-5f6a7b8c9d0e",
"buyer": {},
"payment": "link",
"expires_at": "2026-06-10T18:00:00Z",
"send_mail": True
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
event_id: '550e8400-e29b-41d4-a716-446655440000',
lines: [{ticket_type_id: 'b2c4e6a8-1234-4f5a-9c8d-0e1f2a3b4c5d', amount: 2}],
timeslot_id: 'd4e5f6a7-8901-4b2c-3d4e-5f6a7b8c9d0e',
buyer: {},
payment: 'link',
expires_at: '2026-06-10T18:00:00Z',
send_mail: true
})
};
fetch('https://api.tickable.io/orders', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.tickable.io/orders",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'event_id' => '550e8400-e29b-41d4-a716-446655440000',
'lines' => [
[
'ticket_type_id' => 'b2c4e6a8-1234-4f5a-9c8d-0e1f2a3b4c5d',
'amount' => 2
]
],
'timeslot_id' => 'd4e5f6a7-8901-4b2c-3d4e-5f6a7b8c9d0e',
'buyer' => [
],
'payment' => 'link',
'expires_at' => '2026-06-10T18:00:00Z',
'send_mail' => true
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.tickable.io/orders"
payload := strings.NewReader("{\n \"event_id\": \"550e8400-e29b-41d4-a716-446655440000\",\n \"lines\": [\n {\n \"ticket_type_id\": \"b2c4e6a8-1234-4f5a-9c8d-0e1f2a3b4c5d\",\n \"amount\": 2\n }\n ],\n \"timeslot_id\": \"d4e5f6a7-8901-4b2c-3d4e-5f6a7b8c9d0e\",\n \"buyer\": {},\n \"payment\": \"link\",\n \"expires_at\": \"2026-06-10T18:00:00Z\",\n \"send_mail\": true\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.tickable.io/orders")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"event_id\": \"550e8400-e29b-41d4-a716-446655440000\",\n \"lines\": [\n {\n \"ticket_type_id\": \"b2c4e6a8-1234-4f5a-9c8d-0e1f2a3b4c5d\",\n \"amount\": 2\n }\n ],\n \"timeslot_id\": \"d4e5f6a7-8901-4b2c-3d4e-5f6a7b8c9d0e\",\n \"buyer\": {},\n \"payment\": \"link\",\n \"expires_at\": \"2026-06-10T18:00:00Z\",\n \"send_mail\": true\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.tickable.io/orders")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"event_id\": \"550e8400-e29b-41d4-a716-446655440000\",\n \"lines\": [\n {\n \"ticket_type_id\": \"b2c4e6a8-1234-4f5a-9c8d-0e1f2a3b4c5d\",\n \"amount\": 2\n }\n ],\n \"timeslot_id\": \"d4e5f6a7-8901-4b2c-3d4e-5f6a7b8c9d0e\",\n \"buyer\": {},\n \"payment\": \"link\",\n \"expires_at\": \"2026-06-10T18:00:00Z\",\n \"send_mail\": true\n}"
response = http.request(request)
puts response.read_body{
"id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
"event_id": "550e8400-e29b-41d4-a716-446655440000",
"event_timeslot_id": "d4e5f6a7-8901-4b2c-3d4e-5f6a7b8c9d0e",
"buyer_name": "Jane Doe",
"buyer_email": "jane@example.com",
"channel": "shop",
"payment_method": "ideal",
"total_price": 5000,
"refunded": 0,
"payed_at": "2026-06-15T14:30:00Z",
"created_at": "2026-06-15T14:25:00Z",
"metadata": {
"naam_deelnemer": "Jane Doe",
"email_deelnemer": "jane@example.com"
},
"metadata_fields": [
{
"id": "9f8e7d6c-5b4a-4392-8171-6f5e4d3c2b1a",
"key": "naam_deelnemer",
"name": "Naam deelnemer",
"value": "Jane Doe"
}
],
"order_lines": [
{
"id": "a1b2c3d4-5678-4e9f-0a1b-2c3d4e5f6a7b",
"ticket_type_id": "b2c4e6a8-1234-4f5a-9c8d-0e1f2a3b4c5d",
"description": "Early Bird",
"amount": 2,
"cancelled_amount": 0,
"item_price": 2500,
"discount": 0,
"total_price": 5000
}
],
"order_url": "https://myorg.tickable.nl/order/f47ac10b-58cc-4372-a567-0e02b2c3d479",
"payment_url": "https://myorg.tickable.nl/pay/f47ac10b-58cc-4372-a567-0e02b2c3d479"
}{
"error": {
"type": "not_found_error",
"code": "resource_missing",
"message": "No such event.",
"request_id": "req_3f2a9c1b7d4e4f0a8b6c5d2e1f0a9b8c",
"param": "event_id"
}
}{
"error": {
"type": "not_found_error",
"code": "resource_missing",
"message": "No such event.",
"request_id": "req_3f2a9c1b7d4e4f0a8b6c5d2e1f0a9b8c",
"param": "event_id"
}
}{
"error": {
"type": "not_found_error",
"code": "resource_missing",
"message": "No such event.",
"request_id": "req_3f2a9c1b7d4e4f0a8b6c5d2e1f0a9b8c",
"param": "event_id"
}
}{
"error": {
"type": "not_found_error",
"code": "resource_missing",
"message": "No such event.",
"request_id": "req_3f2a9c1b7d4e4f0a8b6c5d2e1f0a9b8c",
"param": "event_id"
}
}Orders
Create Order
Issue tickets, like the dashboard does for guests and reservations: free at once, or with a payment link the buyer pays on Tickable’s hosted page (service fee included, as in the shop). Capacity, the timeslot and the ticket types’ timeslots are checked in one transaction; sale windows do not apply, as for tickets issued from the dashboard. Send an Idempotency-Key so a retry cannot issue twice. Requires the orders.write scope.
POST
/
orders
Create order
curl --request POST \
--url https://api.tickable.io/orders \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"event_id": "550e8400-e29b-41d4-a716-446655440000",
"lines": [
{
"ticket_type_id": "b2c4e6a8-1234-4f5a-9c8d-0e1f2a3b4c5d",
"amount": 2
}
],
"timeslot_id": "d4e5f6a7-8901-4b2c-3d4e-5f6a7b8c9d0e",
"buyer": {},
"payment": "link",
"expires_at": "2026-06-10T18:00:00Z",
"send_mail": true
}
'import requests
url = "https://api.tickable.io/orders"
payload = {
"event_id": "550e8400-e29b-41d4-a716-446655440000",
"lines": [
{
"ticket_type_id": "b2c4e6a8-1234-4f5a-9c8d-0e1f2a3b4c5d",
"amount": 2
}
],
"timeslot_id": "d4e5f6a7-8901-4b2c-3d4e-5f6a7b8c9d0e",
"buyer": {},
"payment": "link",
"expires_at": "2026-06-10T18:00:00Z",
"send_mail": True
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
event_id: '550e8400-e29b-41d4-a716-446655440000',
lines: [{ticket_type_id: 'b2c4e6a8-1234-4f5a-9c8d-0e1f2a3b4c5d', amount: 2}],
timeslot_id: 'd4e5f6a7-8901-4b2c-3d4e-5f6a7b8c9d0e',
buyer: {},
payment: 'link',
expires_at: '2026-06-10T18:00:00Z',
send_mail: true
})
};
fetch('https://api.tickable.io/orders', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.tickable.io/orders",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'event_id' => '550e8400-e29b-41d4-a716-446655440000',
'lines' => [
[
'ticket_type_id' => 'b2c4e6a8-1234-4f5a-9c8d-0e1f2a3b4c5d',
'amount' => 2
]
],
'timeslot_id' => 'd4e5f6a7-8901-4b2c-3d4e-5f6a7b8c9d0e',
'buyer' => [
],
'payment' => 'link',
'expires_at' => '2026-06-10T18:00:00Z',
'send_mail' => true
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.tickable.io/orders"
payload := strings.NewReader("{\n \"event_id\": \"550e8400-e29b-41d4-a716-446655440000\",\n \"lines\": [\n {\n \"ticket_type_id\": \"b2c4e6a8-1234-4f5a-9c8d-0e1f2a3b4c5d\",\n \"amount\": 2\n }\n ],\n \"timeslot_id\": \"d4e5f6a7-8901-4b2c-3d4e-5f6a7b8c9d0e\",\n \"buyer\": {},\n \"payment\": \"link\",\n \"expires_at\": \"2026-06-10T18:00:00Z\",\n \"send_mail\": true\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.tickable.io/orders")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"event_id\": \"550e8400-e29b-41d4-a716-446655440000\",\n \"lines\": [\n {\n \"ticket_type_id\": \"b2c4e6a8-1234-4f5a-9c8d-0e1f2a3b4c5d\",\n \"amount\": 2\n }\n ],\n \"timeslot_id\": \"d4e5f6a7-8901-4b2c-3d4e-5f6a7b8c9d0e\",\n \"buyer\": {},\n \"payment\": \"link\",\n \"expires_at\": \"2026-06-10T18:00:00Z\",\n \"send_mail\": true\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.tickable.io/orders")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"event_id\": \"550e8400-e29b-41d4-a716-446655440000\",\n \"lines\": [\n {\n \"ticket_type_id\": \"b2c4e6a8-1234-4f5a-9c8d-0e1f2a3b4c5d\",\n \"amount\": 2\n }\n ],\n \"timeslot_id\": \"d4e5f6a7-8901-4b2c-3d4e-5f6a7b8c9d0e\",\n \"buyer\": {},\n \"payment\": \"link\",\n \"expires_at\": \"2026-06-10T18:00:00Z\",\n \"send_mail\": true\n}"
response = http.request(request)
puts response.read_body{
"id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
"event_id": "550e8400-e29b-41d4-a716-446655440000",
"event_timeslot_id": "d4e5f6a7-8901-4b2c-3d4e-5f6a7b8c9d0e",
"buyer_name": "Jane Doe",
"buyer_email": "jane@example.com",
"channel": "shop",
"payment_method": "ideal",
"total_price": 5000,
"refunded": 0,
"payed_at": "2026-06-15T14:30:00Z",
"created_at": "2026-06-15T14:25:00Z",
"metadata": {
"naam_deelnemer": "Jane Doe",
"email_deelnemer": "jane@example.com"
},
"metadata_fields": [
{
"id": "9f8e7d6c-5b4a-4392-8171-6f5e4d3c2b1a",
"key": "naam_deelnemer",
"name": "Naam deelnemer",
"value": "Jane Doe"
}
],
"order_lines": [
{
"id": "a1b2c3d4-5678-4e9f-0a1b-2c3d4e5f6a7b",
"ticket_type_id": "b2c4e6a8-1234-4f5a-9c8d-0e1f2a3b4c5d",
"description": "Early Bird",
"amount": 2,
"cancelled_amount": 0,
"item_price": 2500,
"discount": 0,
"total_price": 5000
}
],
"order_url": "https://myorg.tickable.nl/order/f47ac10b-58cc-4372-a567-0e02b2c3d479",
"payment_url": "https://myorg.tickable.nl/pay/f47ac10b-58cc-4372-a567-0e02b2c3d479"
}{
"error": {
"type": "not_found_error",
"code": "resource_missing",
"message": "No such event.",
"request_id": "req_3f2a9c1b7d4e4f0a8b6c5d2e1f0a9b8c",
"param": "event_id"
}
}{
"error": {
"type": "not_found_error",
"code": "resource_missing",
"message": "No such event.",
"request_id": "req_3f2a9c1b7d4e4f0a8b6c5d2e1f0a9b8c",
"param": "event_id"
}
}{
"error": {
"type": "not_found_error",
"code": "resource_missing",
"message": "No such event.",
"request_id": "req_3f2a9c1b7d4e4f0a8b6c5d2e1f0a9b8c",
"param": "event_id"
}
}{
"error": {
"type": "not_found_error",
"code": "resource_missing",
"message": "No such event.",
"request_id": "req_3f2a9c1b7d4e4f0a8b6c5d2e1f0a9b8c",
"param": "event_id"
}
}Authorizations
Pass as Authorization: Bearer {token}. Accepts either an OAuth2 JWT access token or an API key (tk_live_...) created from the Tickable dashboard.
Body
application/json
Example:
"550e8400-e29b-41d4-a716-446655440000"
Required array length:
1 - 50 elementsShow child attributes
Show child attributes
Required when the event has more than one timeslot
Example:
"d4e5f6a7-8901-4b2c-3d4e-5f6a7b8c9d0e"
Show child attributes
Show child attributes
free: the tickets are issued at once at no charge (a guest list). link: the order waits for payment until expires_at; the buyer gets a mail with the payment link, which is also returned as payment_url.
Available options:
free, link Example:
"link"
Only for link: until when the order can be paid and keeps its places. Default 24 hours, at most 30 days.
Example:
"2026-06-10T18:00:00Z"
For free: mail the tickets to the buyer. A link order always mails the payment link.
Example:
true
Response
Order created
Example:
"f47ac10b-58cc-4372-a567-0e02b2c3d479"
Example:
"550e8400-e29b-41d4-a716-446655440000"
Example:
"d4e5f6a7-8901-4b2c-3d4e-5f6a7b8c9d0e"
Example:
"Jane Doe"
Example:
"jane@example.com"
Where the order came from: shop, guest (issued for free), reservation (a payment link), pos, waitlist, ...
Available options:
shop, import, api, swapped, reservation, guest, pos, hold, moved, test, waitlist Example:
"shop"
Example:
"ideal"
Order total in cents (EUR), including VAT
Example:
5000
Amount refunded in cents (EUR)
Example:
0
Example:
"2026-06-15T14:30:00Z"
Example:
"2026-06-15T14:25:00Z"
Visitor Information values, keyed by the field's key. Empty when the event has no custom fields.
Show child attributes
Show child attributes
Example:
{
"naam_deelnemer": "Jane Doe",
"email_deelnemer": "jane@example.com"
}
The same Visitor Information values, with the dashboard label for each field.
Show child attributes
Show child attributes
Show child attributes
Show child attributes
The buyer's order page, with the tickets
Example:
"https://myorg.tickable.nl/order/f47ac10b-58cc-4372-a567-0e02b2c3d479"
Where the buyer pays an unpaid reservation; null otherwise
Example:
"https://myorg.tickable.nl/pay/f47ac10b-58cc-4372-a567-0e02b2c3d479"