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

> 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.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.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.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.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.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.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.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.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.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>"}'
```