cURL
curl --request POST \
--url https://api-alpha.fourvenues.com/integrations/tickets/ \
--header 'Content-Type: application/json' \
--header 'integration_id: <api-key>' \
--header 'secret: <api-key>' \
--header 'x-api-key: <api-key>' \
--data '
{
"quantity": 2,
"ticket_rate_id": "tkrt_12345",
"sale_type": "online",
"tickets": [
{
"price_id": "price_001",
"total_price": 50,
"qr_code": "QRCODE123ABC",
"fee": 5,
"full_name": "John Doe",
"email": "john@example.com",
"phone": "+15555555555",
"gender": "male",
"birthday": "1990-01-01",
"address": "123 Main St",
"country_code": "US",
"postal_code": "12345",
"personal_document_type": "passport",
"personal_document_number": "A1234567",
"supplements": [
{
"supplement_id": "sup_001",
"price": 10
}
]
}
],
"channel_id": "chnl_abc123",
"referral_id": "rfrl_xyz789"
}
'import requests
url = "https://api-alpha.fourvenues.com/integrations/tickets/"
payload = {
"quantity": 2,
"ticket_rate_id": "tkrt_12345",
"sale_type": "online",
"tickets": [
{
"price_id": "price_001",
"total_price": 50,
"qr_code": "QRCODE123ABC",
"fee": 5,
"full_name": "John Doe",
"email": "john@example.com",
"phone": "+15555555555",
"gender": "male",
"birthday": "1990-01-01",
"address": "123 Main St",
"country_code": "US",
"postal_code": "12345",
"personal_document_type": "passport",
"personal_document_number": "A1234567",
"supplements": [
{
"supplement_id": "sup_001",
"price": 10
}
]
}
],
"channel_id": "chnl_abc123",
"referral_id": "rfrl_xyz789"
}
headers = {
"integration_id": "<api-key>",
"secret": "<api-key>",
"x-api-key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {
integration_id: '<api-key>',
secret: '<api-key>',
'x-api-key': '<api-key>',
'Content-Type': 'application/json'
},
body: JSON.stringify({
quantity: 2,
ticket_rate_id: 'tkrt_12345',
sale_type: 'online',
tickets: [
{
price_id: 'price_001',
total_price: 50,
qr_code: 'QRCODE123ABC',
fee: 5,
full_name: 'John Doe',
email: 'john@example.com',
phone: '+15555555555',
gender: 'male',
birthday: '1990-01-01',
address: '123 Main St',
country_code: 'US',
postal_code: '12345',
personal_document_type: 'passport',
personal_document_number: 'A1234567',
supplements: [{supplement_id: 'sup_001', price: 10}]
}
],
channel_id: 'chnl_abc123',
referral_id: 'rfrl_xyz789'
})
};
fetch('https://api-alpha.fourvenues.com/integrations/tickets/', 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-alpha.fourvenues.com/integrations/tickets/",
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([
'quantity' => 2,
'ticket_rate_id' => 'tkrt_12345',
'sale_type' => 'online',
'tickets' => [
[
'price_id' => 'price_001',
'total_price' => 50,
'qr_code' => 'QRCODE123ABC',
'fee' => 5,
'full_name' => 'John Doe',
'email' => 'john@example.com',
'phone' => '+15555555555',
'gender' => 'male',
'birthday' => '1990-01-01',
'address' => '123 Main St',
'country_code' => 'US',
'postal_code' => '12345',
'personal_document_type' => 'passport',
'personal_document_number' => 'A1234567',
'supplements' => [
[
'supplement_id' => 'sup_001',
'price' => 10
]
]
]
],
'channel_id' => 'chnl_abc123',
'referral_id' => 'rfrl_xyz789'
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"integration_id: <api-key>",
"secret: <api-key>",
"x-api-key: <api-key>"
],
]);
$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-alpha.fourvenues.com/integrations/tickets/"
payload := strings.NewReader("{\n \"quantity\": 2,\n \"ticket_rate_id\": \"tkrt_12345\",\n \"sale_type\": \"online\",\n \"tickets\": [\n {\n \"price_id\": \"price_001\",\n \"total_price\": 50,\n \"qr_code\": \"QRCODE123ABC\",\n \"fee\": 5,\n \"full_name\": \"John Doe\",\n \"email\": \"john@example.com\",\n \"phone\": \"+15555555555\",\n \"gender\": \"male\",\n \"birthday\": \"1990-01-01\",\n \"address\": \"123 Main St\",\n \"country_code\": \"US\",\n \"postal_code\": \"12345\",\n \"personal_document_type\": \"passport\",\n \"personal_document_number\": \"A1234567\",\n \"supplements\": [\n {\n \"supplement_id\": \"sup_001\",\n \"price\": 10\n }\n ]\n }\n ],\n \"channel_id\": \"chnl_abc123\",\n \"referral_id\": \"rfrl_xyz789\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("integration_id", "<api-key>")
req.Header.Add("secret", "<api-key>")
req.Header.Add("x-api-key", "<api-key>")
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-alpha.fourvenues.com/integrations/tickets/")
.header("integration_id", "<api-key>")
.header("secret", "<api-key>")
.header("x-api-key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"quantity\": 2,\n \"ticket_rate_id\": \"tkrt_12345\",\n \"sale_type\": \"online\",\n \"tickets\": [\n {\n \"price_id\": \"price_001\",\n \"total_price\": 50,\n \"qr_code\": \"QRCODE123ABC\",\n \"fee\": 5,\n \"full_name\": \"John Doe\",\n \"email\": \"john@example.com\",\n \"phone\": \"+15555555555\",\n \"gender\": \"male\",\n \"birthday\": \"1990-01-01\",\n \"address\": \"123 Main St\",\n \"country_code\": \"US\",\n \"postal_code\": \"12345\",\n \"personal_document_type\": \"passport\",\n \"personal_document_number\": \"A1234567\",\n \"supplements\": [\n {\n \"supplement_id\": \"sup_001\",\n \"price\": 10\n }\n ]\n }\n ],\n \"channel_id\": \"chnl_abc123\",\n \"referral_id\": \"rfrl_xyz789\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api-alpha.fourvenues.com/integrations/tickets/")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["integration_id"] = '<api-key>'
request["secret"] = '<api-key>'
request["x-api-key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"quantity\": 2,\n \"ticket_rate_id\": \"tkrt_12345\",\n \"sale_type\": \"online\",\n \"tickets\": [\n {\n \"price_id\": \"price_001\",\n \"total_price\": 50,\n \"qr_code\": \"QRCODE123ABC\",\n \"fee\": 5,\n \"full_name\": \"John Doe\",\n \"email\": \"john@example.com\",\n \"phone\": \"+15555555555\",\n \"gender\": \"male\",\n \"birthday\": \"1990-01-01\",\n \"address\": \"123 Main St\",\n \"country_code\": \"US\",\n \"postal_code\": \"12345\",\n \"personal_document_type\": \"passport\",\n \"personal_document_number\": \"A1234567\",\n \"supplements\": [\n {\n \"supplement_id\": \"sup_001\",\n \"price\": 10\n }\n ]\n }\n ],\n \"channel_id\": \"chnl_abc123\",\n \"referral_id\": \"rfrl_xyz789\"\n}"
response = http.request(request)
puts response.read_body{
"success": true,
"data": {
"_id": "el7yuiyep0006msyw2pri1tem1LpJwSc",
"activation_date": "2022-09-15T23:00:00.000Z",
"channel_id": "ajifs2hke000dwemmurwd3kuqN3Kopcx",
"code": "P6J21FF2S",
"discount_quantity_subtract": 0,
"email": "my-client-email@fourvenues.com",
"gender": "female",
"address": "Calle de la Rosa 1",
"language": "es",
"country": "ES",
"postal_code": "28001",
"enter": 0,
"entry_date": 0,
"event_id": "Mjo4f9o9h01fdjvmmrgn9aoh4s5IBHzX",
"for": 1,
"name": "Miguel Román",
"payment_id": "Cl7yuiyhy0007msyw4vfl5ai6YF4WZRn",
"phone": "+34666666666",
"price": 10,
"raised": 0,
"rate_id": "Tl4gr63fr0xkr01i1gk354qbrSCMLTwl",
"rate_name": "General Access",
"rate_slug": "general-access",
"referral_id": "ñeifupjvx000rwe2m2zuba1z9FqyR2dSL",
"refunded": 0,
"sale_type": "online",
"price_info": {
"_id": "1712861139741",
"price": 10,
"age": 18,
"content": "",
"additional_info": ""
},
"supplements": [
{
"_id": "1712861146044",
"price": 2,
"label": "Bus",
"normalized_label": "bus",
"description": "Bus from the city center to the venue.",
"has_fake_price": false,
"fake_price": 0,
"product_quantity": 1,
"product_quantity_used": 1,
"service_charge_amount": 2,
"service_charge_type": "fixed"
}
],
"status": "activated",
"total_extras": 2,
"total_fees": 1.2,
"total_paid": 13.2,
"invoice_reference": "EV24T-TOX2-0000215",
"corrective_invoice_references": [
"EV24T-COR-H58Z-0000002",
"EV24T-COR-H58Z-0000003"
],
"date": "2025-03-15",
"surcharge_total": 10,
"surcharge": {
"amount": 10,
"payment_method": "card",
"payment_id": "ojvfnwbvebru23ung34",
"state": "completed",
"created_at": "2025-05-09T23:03:21.000Z",
"user_id": "ivnrewiujbgw2983b9ubgbo2"
},
"supplements_service_charge_total": 2,
"total_warranty": 10
}
}{
"success": false,
"message": "Validation error details."
}{
"success": false,
"message": "internal_server_error"
}Tickets
Post tickets
Create one or more tickets. Email and FullName are required for each ticket. All tickets must have the same rate and priceId. ReferralId or ChannelId can be passed but not both. This endpoint does not check for rate, channel or any sort of limits
POST
/
tickets
/
cURL
curl --request POST \
--url https://api-alpha.fourvenues.com/integrations/tickets/ \
--header 'Content-Type: application/json' \
--header 'integration_id: <api-key>' \
--header 'secret: <api-key>' \
--header 'x-api-key: <api-key>' \
--data '
{
"quantity": 2,
"ticket_rate_id": "tkrt_12345",
"sale_type": "online",
"tickets": [
{
"price_id": "price_001",
"total_price": 50,
"qr_code": "QRCODE123ABC",
"fee": 5,
"full_name": "John Doe",
"email": "john@example.com",
"phone": "+15555555555",
"gender": "male",
"birthday": "1990-01-01",
"address": "123 Main St",
"country_code": "US",
"postal_code": "12345",
"personal_document_type": "passport",
"personal_document_number": "A1234567",
"supplements": [
{
"supplement_id": "sup_001",
"price": 10
}
]
}
],
"channel_id": "chnl_abc123",
"referral_id": "rfrl_xyz789"
}
'import requests
url = "https://api-alpha.fourvenues.com/integrations/tickets/"
payload = {
"quantity": 2,
"ticket_rate_id": "tkrt_12345",
"sale_type": "online",
"tickets": [
{
"price_id": "price_001",
"total_price": 50,
"qr_code": "QRCODE123ABC",
"fee": 5,
"full_name": "John Doe",
"email": "john@example.com",
"phone": "+15555555555",
"gender": "male",
"birthday": "1990-01-01",
"address": "123 Main St",
"country_code": "US",
"postal_code": "12345",
"personal_document_type": "passport",
"personal_document_number": "A1234567",
"supplements": [
{
"supplement_id": "sup_001",
"price": 10
}
]
}
],
"channel_id": "chnl_abc123",
"referral_id": "rfrl_xyz789"
}
headers = {
"integration_id": "<api-key>",
"secret": "<api-key>",
"x-api-key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {
integration_id: '<api-key>',
secret: '<api-key>',
'x-api-key': '<api-key>',
'Content-Type': 'application/json'
},
body: JSON.stringify({
quantity: 2,
ticket_rate_id: 'tkrt_12345',
sale_type: 'online',
tickets: [
{
price_id: 'price_001',
total_price: 50,
qr_code: 'QRCODE123ABC',
fee: 5,
full_name: 'John Doe',
email: 'john@example.com',
phone: '+15555555555',
gender: 'male',
birthday: '1990-01-01',
address: '123 Main St',
country_code: 'US',
postal_code: '12345',
personal_document_type: 'passport',
personal_document_number: 'A1234567',
supplements: [{supplement_id: 'sup_001', price: 10}]
}
],
channel_id: 'chnl_abc123',
referral_id: 'rfrl_xyz789'
})
};
fetch('https://api-alpha.fourvenues.com/integrations/tickets/', 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-alpha.fourvenues.com/integrations/tickets/",
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([
'quantity' => 2,
'ticket_rate_id' => 'tkrt_12345',
'sale_type' => 'online',
'tickets' => [
[
'price_id' => 'price_001',
'total_price' => 50,
'qr_code' => 'QRCODE123ABC',
'fee' => 5,
'full_name' => 'John Doe',
'email' => 'john@example.com',
'phone' => '+15555555555',
'gender' => 'male',
'birthday' => '1990-01-01',
'address' => '123 Main St',
'country_code' => 'US',
'postal_code' => '12345',
'personal_document_type' => 'passport',
'personal_document_number' => 'A1234567',
'supplements' => [
[
'supplement_id' => 'sup_001',
'price' => 10
]
]
]
],
'channel_id' => 'chnl_abc123',
'referral_id' => 'rfrl_xyz789'
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"integration_id: <api-key>",
"secret: <api-key>",
"x-api-key: <api-key>"
],
]);
$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-alpha.fourvenues.com/integrations/tickets/"
payload := strings.NewReader("{\n \"quantity\": 2,\n \"ticket_rate_id\": \"tkrt_12345\",\n \"sale_type\": \"online\",\n \"tickets\": [\n {\n \"price_id\": \"price_001\",\n \"total_price\": 50,\n \"qr_code\": \"QRCODE123ABC\",\n \"fee\": 5,\n \"full_name\": \"John Doe\",\n \"email\": \"john@example.com\",\n \"phone\": \"+15555555555\",\n \"gender\": \"male\",\n \"birthday\": \"1990-01-01\",\n \"address\": \"123 Main St\",\n \"country_code\": \"US\",\n \"postal_code\": \"12345\",\n \"personal_document_type\": \"passport\",\n \"personal_document_number\": \"A1234567\",\n \"supplements\": [\n {\n \"supplement_id\": \"sup_001\",\n \"price\": 10\n }\n ]\n }\n ],\n \"channel_id\": \"chnl_abc123\",\n \"referral_id\": \"rfrl_xyz789\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("integration_id", "<api-key>")
req.Header.Add("secret", "<api-key>")
req.Header.Add("x-api-key", "<api-key>")
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-alpha.fourvenues.com/integrations/tickets/")
.header("integration_id", "<api-key>")
.header("secret", "<api-key>")
.header("x-api-key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"quantity\": 2,\n \"ticket_rate_id\": \"tkrt_12345\",\n \"sale_type\": \"online\",\n \"tickets\": [\n {\n \"price_id\": \"price_001\",\n \"total_price\": 50,\n \"qr_code\": \"QRCODE123ABC\",\n \"fee\": 5,\n \"full_name\": \"John Doe\",\n \"email\": \"john@example.com\",\n \"phone\": \"+15555555555\",\n \"gender\": \"male\",\n \"birthday\": \"1990-01-01\",\n \"address\": \"123 Main St\",\n \"country_code\": \"US\",\n \"postal_code\": \"12345\",\n \"personal_document_type\": \"passport\",\n \"personal_document_number\": \"A1234567\",\n \"supplements\": [\n {\n \"supplement_id\": \"sup_001\",\n \"price\": 10\n }\n ]\n }\n ],\n \"channel_id\": \"chnl_abc123\",\n \"referral_id\": \"rfrl_xyz789\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api-alpha.fourvenues.com/integrations/tickets/")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["integration_id"] = '<api-key>'
request["secret"] = '<api-key>'
request["x-api-key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"quantity\": 2,\n \"ticket_rate_id\": \"tkrt_12345\",\n \"sale_type\": \"online\",\n \"tickets\": [\n {\n \"price_id\": \"price_001\",\n \"total_price\": 50,\n \"qr_code\": \"QRCODE123ABC\",\n \"fee\": 5,\n \"full_name\": \"John Doe\",\n \"email\": \"john@example.com\",\n \"phone\": \"+15555555555\",\n \"gender\": \"male\",\n \"birthday\": \"1990-01-01\",\n \"address\": \"123 Main St\",\n \"country_code\": \"US\",\n \"postal_code\": \"12345\",\n \"personal_document_type\": \"passport\",\n \"personal_document_number\": \"A1234567\",\n \"supplements\": [\n {\n \"supplement_id\": \"sup_001\",\n \"price\": 10\n }\n ]\n }\n ],\n \"channel_id\": \"chnl_abc123\",\n \"referral_id\": \"rfrl_xyz789\"\n}"
response = http.request(request)
puts response.read_body{
"success": true,
"data": {
"_id": "el7yuiyep0006msyw2pri1tem1LpJwSc",
"activation_date": "2022-09-15T23:00:00.000Z",
"channel_id": "ajifs2hke000dwemmurwd3kuqN3Kopcx",
"code": "P6J21FF2S",
"discount_quantity_subtract": 0,
"email": "my-client-email@fourvenues.com",
"gender": "female",
"address": "Calle de la Rosa 1",
"language": "es",
"country": "ES",
"postal_code": "28001",
"enter": 0,
"entry_date": 0,
"event_id": "Mjo4f9o9h01fdjvmmrgn9aoh4s5IBHzX",
"for": 1,
"name": "Miguel Román",
"payment_id": "Cl7yuiyhy0007msyw4vfl5ai6YF4WZRn",
"phone": "+34666666666",
"price": 10,
"raised": 0,
"rate_id": "Tl4gr63fr0xkr01i1gk354qbrSCMLTwl",
"rate_name": "General Access",
"rate_slug": "general-access",
"referral_id": "ñeifupjvx000rwe2m2zuba1z9FqyR2dSL",
"refunded": 0,
"sale_type": "online",
"price_info": {
"_id": "1712861139741",
"price": 10,
"age": 18,
"content": "",
"additional_info": ""
},
"supplements": [
{
"_id": "1712861146044",
"price": 2,
"label": "Bus",
"normalized_label": "bus",
"description": "Bus from the city center to the venue.",
"has_fake_price": false,
"fake_price": 0,
"product_quantity": 1,
"product_quantity_used": 1,
"service_charge_amount": 2,
"service_charge_type": "fixed"
}
],
"status": "activated",
"total_extras": 2,
"total_fees": 1.2,
"total_paid": 13.2,
"invoice_reference": "EV24T-TOX2-0000215",
"corrective_invoice_references": [
"EV24T-COR-H58Z-0000002",
"EV24T-COR-H58Z-0000003"
],
"date": "2025-03-15",
"surcharge_total": 10,
"surcharge": {
"amount": 10,
"payment_method": "card",
"payment_id": "ojvfnwbvebru23ung34",
"state": "completed",
"created_at": "2025-05-09T23:03:21.000Z",
"user_id": "ivnrewiujbgw2983b9ubgbo2"
},
"supplements_service_charge_total": 2,
"total_warranty": 10
}
}{
"success": false,
"message": "Validation error details."
}{
"success": false,
"message": "internal_server_error"
}Authorizations
Identifier of the integration (Auth v1)
Secret of the organization (Auth v1)
API key (Auth v2)
Body
application/json
Number of tickets to create.
Example:
2
Ticket rate identifier.
Example:
"tkrt_12345"
Type of sale.
Available options:
online Example:
"online"
List of tickets to create.
Minimum array length:
1Show child attributes
Show child attributes
Channel identifier (mutually exclusive with referral_id).
Example:
"chnl_abc123"
Referral identifier (mutually exclusive with channel_id).
Example:
"rfrl_xyz789"
⌘I