curl --request GET \
--url https://api-alpha.fourvenues.com/integrations/bookings/code/{bookingCode} \
--header 'integration_id: <api-key>' \
--header 'secret: <api-key>' \
--header 'x-api-key: <api-key>'{
"success": true,
"data": {
"_id": "jl830v6km000pcwrxge2757vyrfpqEsq",
"channel_id": "ajifs2hke000dwemmurwd3kuqN3Kopcx",
"code": "XLLF3W73D",
"commentary_client": "I want the biggest VIP table.",
"commentary_reserve": "Preferred table for that client is 10.",
"date": "2022-09-15T23:00:00.000Z",
"deposit": 0,
"deposit_method": "online",
"deposit_paid": 0,
"duration": 7200,
"enter": 0,
"event_id": "nl830t4mw0001cwrxbbg0226j4MgmEUG",
"event_name": "Saturday Night",
"for": 5,
"gender_group": "boys",
"hour": "2:00",
"name": "Sergio Centeno Pérez",
"phone": "+34666666666",
"price": 0,
"rate_slug": "",
"referral_id": "ñeifupjvx000rwe2m2zuba1z9FqyR2dSL",
"refunded": 0,
"space_id": "",
"space_name": "S1",
"status": "accepted",
"walkin": true,
"zone_name": "Terraza",
"zone_slug": "1658138633506",
"normalized_zone_name": "terraza",
"email": "example@example.com",
"invoice_reference": "EV24T-TOX2-0000215",
"corrective_invoice_references": [
"EV24T-COR-H58Z-0000002",
"EV24T-COR-H58Z-0000003"
],
"created_at": "2024-11-19T09:59:53.763Z",
"currency": "EUR",
"state": "accepted",
"updated_at": "2024-11-19T09:59:53.763Z",
"local_date": "2025-05-19 10:59:53",
"client_id": "kfnwkjbjkwb1jbr4bkhb5334",
"billing_info": {
"customer_type": "individual",
"customer_name": "John Doe",
"document_type": "dni",
"document_number": "1234567890",
"address": "123 Main St, City, Country",
"city": "City",
"postal_code": "12345",
"country": "Spain"
},
"external_payments": [
{
"_id": "im4r8ntp6000c4ko6d3yt8ui0To87UQp",
"amount": 50,
"currency": "EUR",
"description": "123456abc",
"method": "card",
"payment_method_slug": "visa",
"created_at": "2024-12-16T16:17:54.714Z",
"created_by": "plnlp1s0t005301am9ehq3y8iSllAXqD"
}
],
"refunds": [
{
"_id": "el7yuiyep0006msyw2pri1tem1LpJwSc",
"amount": 10,
"currency": "EUR",
"payment_id": "Cl7yuiyhy0007msyw4vfl5ai6YF4WZRn",
"payment_method": "amex",
"created_at": "2022-09-15T23:00:00.000Z",
"created_by": "gwrgkwinbgwnbwip23iongw"
}
],
"payments": [
{
"_id": "el7yuiyep0006msyw2pri1tem1LpJwSc",
"amount": 10,
"currency": "EUR",
"payment_method": "amex",
"issuer_country": "GB",
"shopper_country": "ES",
"created_at": "2022-09-15T23:00:00.000Z",
"created_by": "gwrgkwinbgwnbwip23iongw"
}
],
"pos_payments": [
{
"amount": 100,
"type": "cash"
}
],
"source": "web",
"pos_total_service_charge": 200,
"pos_total_tips": 50,
"pos_ticket_total": 400,
"pos_products": [
{
"_id": "1675456037",
"name": "Water bottle",
"amount": 2,
"unit_price": 50,
"total_price": 100
}
]
}
}Get a booking by code
curl --request GET \
--url https://api-alpha.fourvenues.com/integrations/bookings/code/{bookingCode} \
--header 'integration_id: <api-key>' \
--header 'secret: <api-key>' \
--header 'x-api-key: <api-key>'{
"success": true,
"data": {
"_id": "jl830v6km000pcwrxge2757vyrfpqEsq",
"channel_id": "ajifs2hke000dwemmurwd3kuqN3Kopcx",
"code": "XLLF3W73D",
"commentary_client": "I want the biggest VIP table.",
"commentary_reserve": "Preferred table for that client is 10.",
"date": "2022-09-15T23:00:00.000Z",
"deposit": 0,
"deposit_method": "online",
"deposit_paid": 0,
"duration": 7200,
"enter": 0,
"event_id": "nl830t4mw0001cwrxbbg0226j4MgmEUG",
"event_name": "Saturday Night",
"for": 5,
"gender_group": "boys",
"hour": "2:00",
"name": "Sergio Centeno Pérez",
"phone": "+34666666666",
"price": 0,
"rate_slug": "",
"referral_id": "ñeifupjvx000rwe2m2zuba1z9FqyR2dSL",
"refunded": 0,
"space_id": "",
"space_name": "S1",
"status": "accepted",
"walkin": true,
"zone_name": "Terraza",
"zone_slug": "1658138633506",
"normalized_zone_name": "terraza",
"email": "example@example.com",
"invoice_reference": "EV24T-TOX2-0000215",
"corrective_invoice_references": [
"EV24T-COR-H58Z-0000002",
"EV24T-COR-H58Z-0000003"
],
"created_at": "2024-11-19T09:59:53.763Z",
"currency": "EUR",
"state": "accepted",
"updated_at": "2024-11-19T09:59:53.763Z",
"local_date": "2025-05-19 10:59:53",
"client_id": "kfnwkjbjkwb1jbr4bkhb5334",
"billing_info": {
"customer_type": "individual",
"customer_name": "John Doe",
"document_type": "dni",
"document_number": "1234567890",
"address": "123 Main St, City, Country",
"city": "City",
"postal_code": "12345",
"country": "Spain"
},
"external_payments": [
{
"_id": "im4r8ntp6000c4ko6d3yt8ui0To87UQp",
"amount": 50,
"currency": "EUR",
"description": "123456abc",
"method": "card",
"payment_method_slug": "visa",
"created_at": "2024-12-16T16:17:54.714Z",
"created_by": "plnlp1s0t005301am9ehq3y8iSllAXqD"
}
],
"refunds": [
{
"_id": "el7yuiyep0006msyw2pri1tem1LpJwSc",
"amount": 10,
"currency": "EUR",
"payment_id": "Cl7yuiyhy0007msyw4vfl5ai6YF4WZRn",
"payment_method": "amex",
"created_at": "2022-09-15T23:00:00.000Z",
"created_by": "gwrgkwinbgwnbwip23iongw"
}
],
"payments": [
{
"_id": "el7yuiyep0006msyw2pri1tem1LpJwSc",
"amount": 10,
"currency": "EUR",
"payment_method": "amex",
"issuer_country": "GB",
"shopper_country": "ES",
"created_at": "2022-09-15T23:00:00.000Z",
"created_by": "gwrgkwinbgwnbwip23iongw"
}
],
"pos_payments": [
{
"amount": 100,
"type": "cash"
}
],
"source": "web",
"pos_total_service_charge": 200,
"pos_total_tips": 50,
"pos_ticket_total": 400,
"pos_products": [
{
"_id": "1675456037",
"name": "Water bottle",
"amount": 2,
"unit_price": 50,
"total_price": 100
}
]
}
}Identifier of the integration (Auth v1)
Secret of the organization (Auth v1)
API key (Auth v2)
Code of the booking