# Lacma — 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 LACMA's art collection, discover current and upcoming exhibitions, browse events and programs, and view detailed artwork information all from one place. Plan your museum visit with access to exhibition details, visitor information, and the complete catalog of artworks on display.

**Category:** Entertainment | **Website:** [lacma.org/](https://lacma.org/) | **Docs:** [parse.bot/marketplace/5054b670-2bc4-480e-b715-bc1780a5eb6e/lacma-org-api](https://parse.bot/marketplace/5054b670-2bc4-480e-b715-bc1780a5eb6e/lacma-org-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-lacma-org-api-5054b670/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_artwork_detail

Get details of a specific artwork by its numeric ID. Returns title, image URL, metadata (artist, date, medium), and the artwork page URL. IDs are obtainable from search_collection results.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `id` | string | Yes | The numeric ID of the artwork (e.g. 12776, 195616). Obtainable from search_collection results[*].id. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-lacma-org-api-5054b670/get_artwork_detail \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"id":"<string>"}'
```

### get_current_exhibitions

Get current exhibitions at LACMA. Returns exhibitions currently on view with titles, dates, locations, images, and descriptions. Results are a single page of all current exhibitions.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-lacma-org-api-5054b670/get_current_exhibitions \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_events_and_programs

Get the events and programs calendar from LACMA. Returns upcoming events with title, date, time, category, status, description, location, and image.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-lacma-org-api-5054b670/get_events_and_programs \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_exhibition_detail

Get details of a specific exhibition by its URL slug. Returns title, description, image, dates, location, and URL. The slug is the last path segment of exhibition URLs returned by the listing endpoints.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `slug` | string | Yes | The URL slug of the exhibition, as found in exhibition listing URLs (e.g. futbol-life-animated-sportraits-lyndon-j-barrois-sr) |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-lacma-org-api-5054b670/get_exhibition_detail \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"slug":"<string>"}'
```

### get_museum_info

Get general museum information including address, hours, and social media links from the LACMA homepage.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-lacma-org-api-5054b670/get_museum_info \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_past_exhibitions

Get past exhibitions at LACMA. Returns recently closed exhibitions with titles, dates, locations, images, and descriptions. Results are a single page of recent past exhibitions.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-lacma-org-api-5054b670/get_past_exhibitions \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_upcoming_exhibitions

Get upcoming exhibitions at LACMA. Returns future exhibitions with titles, dates, locations, images, and descriptions. Results are a single page of all upcoming exhibitions.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-lacma-org-api-5054b670/get_upcoming_exhibitions \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_visit_info

Get visitor information for planning a visit to LACMA. Returns a text description with hours, ticketing, dining, and other visitor details.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-lacma-org-api-5054b670/get_visit_info \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### search_collection

Search LACMA art collection by keyword. Returns paginated results from the collections API with artwork titles, artists, dates, and images. Each page returns up to 48 results.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page` | integer | No | Page number (0-based). Each page returns up to 48 results. |
| `query` | string | Yes | Search keyword (e.g. picasso, monet, sculpture) |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-lacma-org-api-5054b670/search_collection \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"page":"<integer>","query":"<string>"}'
```