# Clorian — 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.

> Search and book tickets across Clorian ticketing portals like Museo Reina Sofia, checking real-time availability and viewing detailed event information. Complete your ticket purchase directly through the service to reserve admission for museums, galleries, and cultural attractions.

**Category:** Entertainment | **Website:** [clorian.com/](https://clorian.com/) | **Docs:** [parse.bot/marketplace/ecdad9f2-81ba-446d-8ecb-c7871499b4c1/clorian-com-api](https://parse.bot/marketplace/ecdad9f2-81ba-446d-8ecb-c7871499b4c1/clorian-com-api)

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

## Access

**Base URL:** `https://api.beta.paywithlocus.com/api/wrapped/parse-clorian-com-api-ecdad9f2/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### Get clorian clients

List all museum and event venues using the Clorian ticketing platform. Scraped from the Clorian website clients page. Returns venue names, ticketing portal URLs, and geographic/category tags.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/parse-clorian-com-api-ecdad9f2/get_clorian_clients \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### Get clorian services

List all ticketing and hardware services offered by Clorian. Scraped from the Clorian website services page. Returns service titles and descriptions.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/parse-clorian-com-api-ecdad9f2/get_clorian_services \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### Get events and activities

Retrieve additional venue events, courses, workshops, and screenings from the Museo Reina Sofia ticketing portal. Returns non-general-admission products such as film screenings and educational programs.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/parse-clorian-com-api-ecdad9f2/get_events_and_activities \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### Get groups ticket listing

List group and educational ticket options for Museo Reina Sofia. Returns ticket types available under group (sales group 151) and educational (sales group 171) categories with pricing and descriptions.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/parse-clorian-com-api-ecdad9f2/get_groups_ticket_listing \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### Get ticket availability

Retrieve available visit dates and time slots for a given ticket. Returns a calendar of date-to-availability-status mappings for the specified month and detailed time slots for the first available date or a specified date. Each slot includes eventId, start/end times, capacity, and remaining availability.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `date` | string | No | Specific date in YYYY-MM-DD format to fetch slots for. If omitted, the first available date in the calendar is used. |
| `month` | string | No | Month (1-12) to check availability for. Defaults to current month. |
| `product_id` | string | Yes | The numeric ID of the ticket product (from get_ticket_listing results). |
| `sales_group_id` | string | No | The sales group ID for the ticket category. |
| `venue_id` | string | No | The venue ID for the target Clorian ticketing portal. |
| `year` | string | No | Year to check availability for. Defaults to current year. |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/parse-clorian-com-api-ecdad9f2/get_ticket_availability \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"date":"<string>","month":"<string>","product_id":"<string>","sales_group_id":"<string>","venue_id":"<string>","year":"<string>"}'
```

### Get ticket detail

Fetch full details for a specific ticket product, including product metadata, opening hours, visitor rules, and configuration data. The product_id comes from get_ticket_listing or get_groups_ticket_listing results. Returns the product object with infos and configurations merged at the top level.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `product_id` | string | Yes | The numeric ID of the ticket product (from get_ticket_listing results). |
| `sales_group_id` | string | No | The sales group ID for the ticket category. 143 for individual tickets, 151 for group visitors, 171 for education. |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/parse-clorian-com-api-ecdad9f2/get_ticket_detail \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"product_id":"<string>","sales_group_id":"<string>"}'
```

### Get ticket listing

List available individual ticket types for Museo Reina Sofia. Returns all general admission tickets with pricing, descriptions, and images. Single-page response containing all available individual tickets.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/parse-clorian-com-api-ecdad9f2/get_ticket_listing \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### Initiate ticket purchase

Retrieve the product configuration for a given ticket. Returns configuration entries such as email subjects and PDF names. Configuration data is typically only available for group or education products; individual tickets return an empty configuration array.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `product_id` | string | Yes | The numeric ID of the ticket product. Use a group or education product ID (from get_groups_ticket_listing) for non-empty configuration data. |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/parse-clorian-com-api-ecdad9f2/initiate_ticket_purchase \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"product_id":"<string>"}'
```