REST API reference

Tiqets API

9 endpoints for Tiqets. Each one is a POST with a JSON body, called with your API key.

Base URL
https://cotlet.dev/api/v1/tiqets
Connects with
Your own Tiqets account (the account you booked with)
Integration page
Tiqets
Tiqets Endpoints
Endpoint Access Description
search_experiences read Attractions, museums and tours on Tiqets by text and city, with price from.
get_experience read Product page: what is included, meeting point, instructions and cancellation terms.
check_availability read Ticket types, timeslots and prices for a product on a date.
list_bookings read Your bookings with product, visit date, tickets and status.
get_booking read One booking: tickets, price paid and whether it can be cancelled or rescheduled.
download_tickets read Download links for the e-tickets of one booking.
start_checkout write Fill the order and return the Tiqets checkout link. Nothing is charged until you pay there yourself.
reschedule_booking write Move a booking to another date or timeslot, where Tiqets offers rescheduling.
cancel_booking write Cancel a whole booking, where Tiqets allows it.

Search experiences

read

POST https://cotlet.dev/api/v1/tiqets/search_experiences

Returns matching products, best match first, with the product ID, city and the lowest price shown. Use product_id in get_experience and check_availability. Pages hold up to 50 results.

Parameters

Parameters: search_experiences
NameTypeDescription
query required string What to look for, e.g. "Vatican" or "boat tour".
city string City name to narrow the results.
limit integer 1 to 50. Default: 20.

Request

cURL
curl -X POST https://cotlet.dev/api/v1/tiqets/search_experiences \
  -H "Authorization: Bearer $COTLET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"Vatican"}'
Python
result = client.call("tiqets", "search_experiences", {"query":"Vatican"})
Node.js
const result = await cotlet.call('tiqets', 'search_experiences', {"query":"Vatican"});
CLI
cotlet call tiqets search_experiences --data '{"query":"Vatican"}'

Example response

{
  "results": [
    {
      "product_id": "1089412",
      "title": "Vatican Museums and Sistine Chapel: Skip-the-Line Ticket",
      "city": "Rome",
      "price_from": {
        "amount": 32,
        "currency": "EUR"
      },
      "url": "https://www.tiqets.com/en/rome-attractions-c71/vatican-museums-p1089412/"
    }
  ]
}

Get experience

read

POST https://cotlet.dev/api/v1/tiqets/get_experience

Returns the details Tiqets shows on the product page. Cancellation terms tell your agent whether free cancellation is on offer before you book.

Parameters

Parameters: get_experience
NameTypeDescription
product_id required string Product ID from search_experiences.

Request

cURL
curl -X POST https://cotlet.dev/api/v1/tiqets/get_experience \
  -H "Authorization: Bearer $COTLET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"product_id":"product_8c41d2"}'
Python
result = client.call("tiqets", "get_experience", {"product_id":"product_8c41d2"})
Node.js
const result = await cotlet.call('tiqets', 'get_experience', {"product_id":"product_8c41d2"});
CLI
cotlet call tiqets get_experience --data '{"product_id":"product_8c41d2"}'

Example response

{
  "product_id": "1089412",
  "title": "Vatican Museums and Sistine Chapel: Skip-the-Line Ticket",
  "city": "Rome",
  "includes": [
    "Entry to the Vatican Museums",
    "Entry to the Sistine Chapel"
  ],
  "free_cancellation": "Until 23:59 the day before the visit"
}

Check availability

read

POST https://cotlet.dev/api/v1/tiqets/check_availability

Returns what Tiqets shows for that product on that day: ticket types with prices and, for timed products, the free timeslots in order. An empty list means nothing is available that day. Pass a ticket type ID to start_checkout.

Parameters

Parameters: check_availability
NameTypeDescription
product_id required string Product ID from search_experiences.
date required date Visit date.

Request

cURL
curl -X POST https://cotlet.dev/api/v1/tiqets/check_availability \
  -H "Authorization: Bearer $COTLET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"product_id":"1089412","date":"2026-10-18"}'
Python
result = client.call("tiqets", "check_availability", {"product_id":"1089412","date":"2026-10-18"})
Node.js
const result = await cotlet.call('tiqets', 'check_availability', {"product_id":"1089412","date":"2026-10-18"});
CLI
cotlet call tiqets check_availability --data '{"product_id":"1089412","date":"2026-10-18"}'

Example response

{
  "product_id": "1089412",
  "date": "2026-10-18",
  "timeslots": [
    {
      "time": "09:00",
      "available": true
    },
    {
      "time": "11:30",
      "available": true
    }
  ],
  "ticket_types": [
    {
      "id": "adult",
      "label": "Adult",
      "price": {
        "amount": 32,
        "currency": "EUR"
      }
    }
  ]
}

List bookings

read

POST https://cotlet.dev/api/v1/tiqets/list_bookings

Lists the bookings of the signed-in account, soonest visit first. Use order_id in get_booking, download_tickets and cancel_booking.

Parameters

Parameters: list_bookings
NameTypeDescription
when enum upcoming, past or all. Default: upcoming.

Request

cURL
curl -X POST https://cotlet.dev/api/v1/tiqets/list_bookings \
  -H "Authorization: Bearer $COTLET_API_KEY"
Python
result = client.call("tiqets", "list_bookings")
Node.js
const result = await cotlet.call('tiqets', 'list_bookings');
CLI
cotlet call tiqets list_bookings

Example response

{
  "bookings": [
    {
      "order_id": "71204583",
      "product": "Sagrada Familia: Fast Track Ticket",
      "visit_date": "2026-10-24",
      "tickets": 2,
      "status": "confirmed"
    }
  ]
}

Get booking

read

POST https://cotlet.dev/api/v1/tiqets/get_booking

Returns the order as the account shows it: product, visit date, tickets, price paid and whether cancelling or rescheduling is on offer. Check it before cancel_booking or reschedule_booking.

Parameters

Parameters: get_booking
NameTypeDescription
order_id required string Order ID from list_bookings.

Request

cURL
curl -X POST https://cotlet.dev/api/v1/tiqets/get_booking \
  -H "Authorization: Bearer $COTLET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"order_id":"order_8c41d2"}'
Python
result = client.call("tiqets", "get_booking", {"order_id":"order_8c41d2"})
Node.js
const result = await cotlet.call('tiqets', 'get_booking', {"order_id":"order_8c41d2"});
CLI
cotlet call tiqets get_booking --data '{"order_id":"order_8c41d2"}'

Example response

{
  "order_id": "71204583",
  "product": "Sagrada Familia: Fast Track Ticket",
  "visit_date": "2026-10-24",
  "tickets": [
    {
      "type": "Adult",
      "quantity": 2
    }
  ],
  "total_paid": {
    "amount": 66,
    "currency": "EUR"
  },
  "can_cancel": true,
  "can_reschedule": true
}

Download tickets

read

POST https://cotlet.dev/api/v1/tiqets/download_tickets

Returns links to the ticket files of the order, in the format Tiqets provides for that product. Links are for you only; do not share them.

Parameters

Parameters: download_tickets
NameTypeDescription
order_id required string Order ID from list_bookings.

Request

cURL
curl -X POST https://cotlet.dev/api/v1/tiqets/download_tickets \
  -H "Authorization: Bearer $COTLET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"order_id":"order_8c41d2"}'
Python
result = client.call("tiqets", "download_tickets", {"order_id":"order_8c41d2"})
Node.js
const result = await cotlet.call('tiqets', 'download_tickets', {"order_id":"order_8c41d2"});
CLI
cotlet call tiqets download_tickets --data '{"order_id":"order_8c41d2"}'

Example response

{
  "order_id": "71204583",
  "files": [
    {
      "name": "sagrada-familia-ticket-1.pdf",
      "url": "https://example-download.invalid/t/71204583-1"
    }
  ]
}

Start checkout

write

POST https://cotlet.dev/api/v1/tiqets/start_checkout

Prepares an order for the product, date and tickets and returns the Tiqets checkout link. It does not pay and charges nothing. It reaches no one, so it runs without asking; you finish the payment on Tiqets.

Parameters

Parameters: start_checkout
NameTypeDescription
product_id required string Product ID from search_experiences.
date required date Visit date.
timeslot string Start time from check_availability, for timed products.
tickets required object Ticket type ID to quantity, e.g. {"adult": 2}.

Request

cURL
curl -X POST https://cotlet.dev/api/v1/tiqets/start_checkout \
  -H "Authorization: Bearer $COTLET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"product_id":"product_8c41d2","date":"2026-10-01","tickets":"tickets"}'
Python
result = client.call("tiqets", "start_checkout", {"product_id":"product_8c41d2","date":"2026-10-01","tickets":"tickets"})
Node.js
const result = await cotlet.call('tiqets', 'start_checkout', {"product_id":"product_8c41d2","date":"2026-10-01","tickets":"tickets"});
CLI
cotlet call tiqets start_checkout --data '{"product_id":"product_8c41d2","date":"2026-10-01","tickets":"tickets"}'

Example response

{
  "product_id": "1089412",
  "date": "2026-10-18",
  "timeslot": "09:00",
  "tickets": {
    "adult": 2
  },
  "total": {
    "amount": 64,
    "currency": "EUR"
  },
  "checkout_url": "https://example-checkout.invalid/c/9f3a"
}

Reschedule booking

write Confirm

POST https://cotlet.dev/api/v1/tiqets/reschedule_booking

Changes the visit date or timeslot of one order, only for products where Tiqets offers it; get_booking says so. It changes your booking with the vendor. By default you confirm each call; you can switch that off for this tool.

Parameters

Parameters: reschedule_booking
NameTypeDescription
order_id required string Order ID from list_bookings.
date required date New visit date.
timeslot string New start time, for timed products.

Request

cURL
curl -X POST https://cotlet.dev/api/v1/tiqets/reschedule_booking \
  -H "Authorization: Bearer $COTLET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"order_id":"71311902","date":"2026-10-25","timeslot":"13:30"}'
Python
result = client.call("tiqets", "reschedule_booking", {"order_id":"71311902","date":"2026-10-25","timeslot":"13:30"})
Node.js
const result = await cotlet.call('tiqets', 'reschedule_booking', {"order_id":"71311902","date":"2026-10-25","timeslot":"13:30"});
CLI
cotlet call tiqets reschedule_booking --data '{"order_id":"71311902","date":"2026-10-25","timeslot":"13:30"}'

Example response

{
  "order_id": "71204583",
  "status": "rescheduled",
  "visit_date": "2026-10-24",
  "timeslot": "14:00"
}

Cancel booking

write Confirm

POST https://cotlet.dev/api/v1/tiqets/cancel_booking

Cancels one whole order; partial cancellation is not offered. Free cancellation applies only if you chose it at booking, and runs until 23:59 on the day before the visit. Check get_booking first. By default you confirm each call; you can switch that off for this tool.

Parameters

Parameters: cancel_booking
NameTypeDescription
order_id required string Order ID from list_bookings.

Request

cURL
curl -X POST https://cotlet.dev/api/v1/tiqets/cancel_booking \
  -H "Authorization: Bearer $COTLET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"order_id":"71204583"}'
Python
result = client.call("tiqets", "cancel_booking", {"order_id":"71204583"})
Node.js
const result = await cotlet.call('tiqets', 'cancel_booking', {"order_id":"71204583"});
CLI
cotlet call tiqets cancel_booking --data '{"order_id":"71204583"}'

Example response

{
  "order_id": "71204583",
  "status": "cancelled",
  "product": "Sagrada Familia: Fast Track Ticket",
  "visit_date": "2026-10-24",
  "refund": {
    "amount": 66,
    "currency": "EUR"
  }
}