# Comedy Mothership — 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 upcoming Comedy Mothership shows across different rooms, check real-time ticket availability, and get detailed information about Kill Tony events and seating options. Find venue details, FAQs, and track specific performances to plan your comedy night.

**Category:** Entertainment | **Website:** [comedymothership.com/](https://comedymothership.com/) | **Docs:** [parse.bot/marketplace/3ce1809e-b5ca-4a6b-8b45-6f09c4efd33f/comedymothership-com-api](https://parse.bot/marketplace/3ce1809e-b5ca-4a6b-8b45-6f09c4efd33f/comedymothership-com-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/comedy-mothership/`
**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 faq

Get Frequently Asked Questions content from Comedy Mothership. Returns text segments containing questions and answers covering location, age restrictions, ticket purchasing, seating, dress code, parking, and more.

**Estimated cost:** Metered

_No parameters required._

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

### Get kill tony events

Get upcoming Kill Tony events with detailed ticket availability including booth/table seating pricing and remaining quantities. Filters the main show listing for Kill Tony events and fetches per-event ticket tier details from SquadUp.

**Estimated cost:** Metered

_No parameters required._

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

### Get show ticket details

Get detailed ticket tiers and availability for a specific show by its event ID from SquadUp. Returns venue details, ticket URL, and price tier information including booth seating. The show_id is the numeric event ID from get_upcoming_shows, get_shows_by_room, or get_kill_tony_events.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `show_id` | string | Yes | Numeric event ID from the show listings (e.g. '139153'). Available in the id field of shows returned by get_upcoming_shows, get_shows_by_room, or get_kill_tony_events. |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/comedy-mothership/get-show-ticket-details \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"show_id":"<string>"}'
```

### Get shows by room

Get upcoming shows for a specific room at Comedy Mothership. Returns all scheduled shows for the given room. The venue has two rooms: Fat Man (larger headliner room) and Little Boy (smaller intimate room).

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `room` | string | No | Room identifier. Accepted values: 'fat-man', 'little-boy'. |

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

### Get upcoming shows

List upcoming comedy shows at Comedy Mothership. Returns show name, room, date/time, sold out status, and ticket URL. Each page returns all scheduled shows for that window.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `limit` | integer | No | Maximum number of shows to return from the current page. |
| `page` | integer | No | Page number for pagination. |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/comedy-mothership/get-upcoming-shows \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"limit":"<integer>","page":"<integer>"}'
```

### Get venue info

Get venue policy, address, and box office information for Comedy Mothership. Returns structured text segments from the box office info page covering hours, policies, showtimes, age restrictions, and ticket fraud prevention.

**Estimated cost:** Metered

_No parameters required._

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

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