# Ticketing Colosseo — Wrapped API

> **You are on:** `https://api.beta.paywithlocus.com/api` | [llms.txt](https://beta.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 for Locus Pro. Each call burns credits from your workspace balance.

## Access

**Base URL:** `https://api.beta.paywithlocus.com/api/wrapped/credits/ticketing-colosseo/`
**Auth:** `Authorization: Bearer <LOCUS_CREDITS_SECRET_KEY>` (an `lcr_` secret key or a scoped `lcac_` agent credential)
**Required header:** `Idempotency-Key: <fresh UUID per call>`. A retry with the same key replays the stored result without a new charge.
**Response:** the provider response after any endpoint-specific normalization. `X-Locus-Credits-Charged` carries the charge and `X-Locus-Credits-Balance` the remaining balance. Insufficient credits return `402` before the provider is called.
**Pricing:** estimated costs below are USD. Locus debits the credit equivalent at your workspace rate.

Full call contract: https://docs.paywithlocus.com/api-reference/introduction

> Using a Pay With Locus wallet key (`claw_` prefix)? Wallet routes are documented separately: https://docs.paywithlocus.com/wrapped-apis/for-agents

## 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.beta.paywithlocus.com/api/wrapped/credits/ticketing-colosseo/get-homepage \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/ticketing-colosseo/get-ticket-availability-calendar \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/ticketing-colosseo/get-ticket-detail \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/ticketing-colosseo/get-ticket-price-tiers \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/ticketing-colosseo/list-tickets-by-category \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"category_slug":"<string>"}'
```

## Next steps

- [All wrapped API providers](https://beta.paywithlocus.com/wapi/index.md): pick another provider.
- [Find and call tools](https://beta.paywithlocus.com/agent/tools.md): price ceilings, async results, and errors.
- [Credits and billing](https://beta.paywithlocus.com/agent/billing.md): what a call costs and how to add credits.
- [Agent docs index](https://beta.paywithlocus.com/agent/index.md): every Locus agent page.