# Ticketing Colosseo — Wrapped API

> **You are on:** `https://api.paywithlocus.com/api` | [llms.txt](https://paywithlocus.com/llms.txt) | [docs](https://docs.paywithlocus.com)
>
> Locus runs on multiple environments -- make sure every URL you call matches your expected environment.
> | Environment | Landing | API | Docs |
> |---|---|---|---|
> | Production | paywithlocus.com | api.paywithlocus.com | docs.paywithlocus.com |
> | Beta | beta.paywithlocus.com | api.beta.paywithlocus.com | docs.paywithlocus.com |
> | Stage | stage.paywithlocus.com | api.stage.paywithlocus.com | docs.paywithlocus.com |
>
> If the API URL above doesn't match your expected environment, re-fetch this file from the correct domain.

> Browse and book tickets for the Colosseum with real-time availability calendars, detailed ticket information, and transparent pricing across different ticket categories. Check what's available on specific dates and compare pricing tiers to plan your visit to Rome's iconic archaeological site.

**Category:** Travel | **Website:** [ticketing.colosseo.it/](https://ticketing.colosseo.it/) | **Docs:** [parse.bot/marketplace/53933767-4496-421f-8de7-cdf6e276b163/ticketing-colosseo-it-api](https://parse.bot/marketplace/53933767-4496-421f-8de7-cdf6e276b163/ticketing-colosseo-it-api)

Pay-per-use API proxy. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-ticketing-colosseo-it-api-53933767/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_homepage

Retrieves the homepage of the Colosseum ticketing system, returning current notices (closures, warnings) and the list of ticket categories available for purchase. Categories include individual tickets, group tickets, school tickets, and educational tours.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-ticketing-colosseo-it-api-53933767/get_homepage \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_ticket_availability_calendar

Retrieves available time slots for a ticket in a given month. Returns an array of slots with start/end times, capacity, and period_id (required for pricing lookups). Use page_id from get_ticket_detail.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `month` | string | Yes | Month number without leading zero (e.g. '7' for July). |
| `page_id` | string | Yes | Numeric page ID from get_ticket_detail (e.g. '35'). |
| `year` | string | Yes | Year as 4-digit string (e.g. '2026'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-ticketing-colosseo-it-api-53933767/get_ticket_availability_calendar \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"month":"<string>","page_id":"<string>","year":"<string>"}'
```

### get_ticket_detail

Retrieves detailed information for a specific ticket, including its page_id which is required for calendar availability lookups. Use ticket slugs from list_tickets_by_category.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `ticket_slug` | string | Yes | Ticket slug from list_tickets_by_category (e.g. '24h-colosseo-foro-romano-palatino', 'full-experience', 'pass-super'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-ticketing-colosseo-it-api-53933767/get_ticket_detail \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"ticket_slug":"<string>"}'
```

### get_ticket_price_tiers

Retrieves pricing tiers (tariffs) for a specific time slot. Returns available ticket types with prices, labels, and quantity constraints. Use period_id and startDateTime from get_ticket_availability_calendar.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `period_id` | string | Yes | Encrypted period ID from a calendar time slot's period_id field. |
| `start_time` | string | Yes | ISO 8601 start time from a calendar time slot's startDateTime field (e.g. '2026-07-01T06:30:00Z'). |
| `ticket_slug` | string | No | Ticket slug for referer context. Optional but recommended. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-ticketing-colosseo-it-api-53933767/get_ticket_price_tiers \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"period_id":"<string>","start_time":"<string>","ticket_slug":"<string>"}'
```

### list_tickets_by_category

Lists all available tickets within a specific category. Returns ticket name, slug, URL, description, and price for each ticket in the category. Use category slugs from get_homepage.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `category_slug` | string | Yes | Category slug from get_homepage categories. Accepted values: 'singoli-1-8-persone', 'gruppi-9-25', 'scuole-9-25', 'percorsi-didattici'. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-ticketing-colosseo-it-api-53933767/list_tickets_by_category \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"category_slug":"<string>"}'
```