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

> Discover upcoming concerts, theater shows, and events at Amsterdam's Melkweg venue by browsing the full agenda, filtering by category or genre, searching the archive, or checking newly announced performances. Find detailed information about specific events and see which shows offer free admission for members.

**Category:** Entertainment | **Website:** [melkweg.nl/](https://melkweg.nl/) | **Docs:** [parse.bot/marketplace/81e45e20-a067-4849-8fc9-ba042405cc95/melkweg-nl-api](https://parse.bot/marketplace/81e45e20-a067-4849-8fc9-ba042405cc95/melkweg-nl-api)

Pay-per-use API proxy for Locus Pro. Each call burns credits from your workspace balance.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/credits/melkweg/`
**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 agenda

Get the full agenda of upcoming events at Melkweg. Returns all scheduled events with summary details including title, date, category, genres, and ticket status. No filtering applied.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/melkweg/get-agenda \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### Get agenda by category

Get agenda events filtered by category. Filtering is case-insensitive. Returns events matching the specified category from the full agenda.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `category` | string | Yes | Category name (case-insensitive). Accepted values: Concert, Clubnacht, Film, Expositie, Festival. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/melkweg/get-agenda-by-category \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"category":"<string>"}'
```

### Get agenda by date

Get agenda events for a specific date. Matches events whose start date begins with the provided date string. Returns total:0 with an empty events array if no events are scheduled for that date.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `date` | string | Yes | Date in YYYY-MM-DD format (e.g. '2026-07-13') |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/melkweg/get-agenda-by-date \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"date":"<string>"}'
```

### Get agenda by genre

Get agenda events filtered by genre tag. Filtering is case-insensitive. Returns events that have the specified genre in their tags list.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `genre` | string | Yes | Genre name (case-insensitive). Verified values: Pop, Electronic, Punk, Indie, Jazz, Funk, Soul, R&B. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/melkweg/get-agenda-by-genre \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"genre":"<string>"}'
```

### Get event detail

Get detailed information for a specific event by its slug. Returns full event details including HTML description, timetable, ticket prices, venue rooms, and links. The slug is available from the agenda listing.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `slug` | string | Yes | Event slug from the agenda listing (e.g. 'the-story-so-far-10-06-2026') |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/melkweg/get-event-detail \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"slug":"<string>"}'
```

### Get free for members

Get events that are free for Melkweg members. Returns only events from the agenda where is_free_for_members is true.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/melkweg/get-free-for-members \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### Get just announced

Get newly announced events (announced within the last 14 days from current date). Returns events from the agenda that were recently announced, sorted by announcement date.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/melkweg/get-just-announced \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### Search events

Search for events using keywords via Algolia. Searches upcoming events by artist name, event name, or genre. Returns paginated results. Pages are 0-indexed; requesting a page beyond the last page (page >= nbPages) returns an empty results array.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page` | integer | No | Page number, 0-indexed. Must be less than nbPages to receive results. |
| `query` | string | Yes | Search keyword (artist name, event name, genre) |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/melkweg/search-events \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"page":"<integer>","query":"<string>"}'
```

## Next steps

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