# AXS — 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 for events, performers, and venues across AXS.com to find tickets, pricing, and availability information in your area or by category. Browse featured events, explore venues by city, and access detailed event information all in one place.

**Category:** Entertainment | **Website:** [axs.com/](https://axs.com/) | **Docs:** [parse.bot/marketplace/b83d3df1-87b9-4c51-b6fb-154a6976a71c/axs-com-api](https://parse.bot/marketplace/b83d3df1-87b9-4c51-b6fb-154a6976a71c/axs-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-axs-com-api-b83d3df1/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_event_detail

Retrieve full details for a specific event by its ID using the Discovery API direct lookup. Supports events from all AXS platforms including AXS US (axs.com) and AXS UK (tickets-uk.axs.com). Returns comprehensive event data including venue, performers, ticketing status, media, and pricing. When the direct event lookup returns empty, falls back to a UK-geo-scoped search on the AXS UK platform (tickets-uk.axs.com), and then to a text search when slug is provided. For UK events (venue countryCode GB), the returned url points to tickets-uk.axs.com.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `event_id` | string | Yes | The unique AXS event ID (numeric string, e.g. '1547109' for US events or '1121435' for UK events) |
| `slug` | string | No | The event URL slug (e.g. 'ariana-grande-tickets'). Used as fallback search terms when the direct event lookup returns empty results. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-axs-com-api-b83d3df1/get_event_detail \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"event_id":"<string>","slug":"<string>"}'
```

### get_events_by_category

Browse events by category (Music, Sports, ArtsOrFamily) and location. Defaults to New York area if no coordinates are provided. Returns upcoming events in the specified category with venue and pricing details.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `category` | string | Yes | Major category name: Music, Sports, or ArtsOrFamily |
| `lat` | number | No | Latitude for location-based filtering |
| `lng` | number | No | Longitude for location-based filtering |
| `subcategory` | string | No | Optional minor category or genre filter |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-axs-com-api-b83d3df1/get_events_by_category \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"category":"<string>","lat":"<number>","lng":"<number>","subcategory":"<string>"}'
```

### get_featured_events

Retrieve homepage featured and promoted events. Defaults to New York area if no coordinates are provided. Returns events with pricing information, venue details, and media.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `lat` | number | No | Latitude for location-based featured events |
| `lng` | number | No | Longitude for location-based featured events |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-axs-com-api-b83d3df1/get_featured_events \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"lat":"<number>","lng":"<number>"}'
```

### get_marketplace_events

Retrieve marketplace (resale) events available on AXS near a given location. These are events where tickets are available through the AXS secondary marketplace. Results are sorted by proximity when coordinates are provided. Defaults to New York area if no coordinates are given.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `category` | string | No | Major category filter: Music, Sports, or ArtsOrFamily |
| `lat` | number | No | Latitude for location-based filtering |
| `lng` | number | No | Longitude for location-based filtering |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-axs-com-api-b83d3df1/get_marketplace_events \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"category":"<string>","lat":"<number>","lng":"<number>"}'
```

### get_uk_events_by_category

Fetch upcoming AXS-ticketed events from the AXS UK platform (tickets-uk.axs.com) for a given location and category. Queries the AXS unified discovery API scoped to UK geography and filters to only AXS-ticketed events. Returns events with pricing (minPrice/maxPrice from veritix data, null when unavailable) and canonical UK URLs pointing to tickets-uk.axs.com. Client-side axsTicketed filtering may return fewer results than the upstream page size.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `category` | string | Yes | Major category: Music, Sports, or ArtsOrFamily |
| `lat` | number | No | Latitude for location-based search. Defaults to London. |
| `lng` | number | No | Longitude for location-based search. Defaults to London. |
| `subcategory` | string | No | Optional minor category or genre filter (e.g. 'Rock', 'Comedy') |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-axs-com-api-b83d3df1/get_uk_events_by_category \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"category":"<string>","lat":"<number>","lng":"<number>","subcategory":"<string>"}'
```

### list_cities

List available cities and locations on AXS. Returns cities with geographic coordinates and country/state codes. When lat/lng are provided, results are sorted by distance from those coordinates. Results are paginated with 20 cities per page.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `lat` | number | No | Latitude for distance-based sorting |
| `lng` | number | No | Longitude for distance-based sorting |
| `page` | integer | No | Page number for results |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-axs-com-api-b83d3df1/list_cities \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"lat":"<number>","lng":"<number>","page":"<integer>"}'
```

### search_axs_ticketed_events_by_category

Search for events by category, returning only events where axsTicketed is true, with minPrice and maxPrice explicitly extracted from veritix pricing data. Identical to search_events_by_category_with_pricing but filters results to include only AXS-ticketed events. When pricing is unavailable, both price fields are null. Client-side filtering may return fewer results than the requested page size.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `category` | string | Yes | Major category: Music, Sports, or ArtsOrFamily |
| `lat` | number | No | Latitude for location-based search |
| `lng` | number | No | Longitude for location-based search |
| `page` | integer | No | Page number for results |
| `results` | integer | No | Number of results per page to fetch from upstream before filtering (max 50) |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-axs-com-api-b83d3df1/search_axs_ticketed_events_by_category \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"category":"<string>","lat":"<number>","lng":"<number>","page":"<integer>","results":"<integer>"}'
```

### search_events

Search for events, performers, or venues by keyword, category, and location. Returns matching events, venues, and performers in a flattened structure with total counts. Paginates via the page parameter.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `category` | string | No | Major category: Music, Sports, or ArtsOrFamily |
| `lat` | number | No | Latitude for location-based search |
| `lng` | number | No | Longitude for location-based search |
| `page` | integer | No | Page number for results |
| `query` | string | No | Search keyword (event title, artist name, or venue name) |
| `results` | integer | No | Number of results per page (max 50) |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-axs-com-api-b83d3df1/search_events \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"category":"<string>","lat":"<number>","lng":"<number>","page":"<integer>","query":"<string>","results":"<integer>"}'
```

### search_events_by_category_with_pricing

Search for events by category with minPrice and maxPrice explicitly extracted from veritix pricing data and added to each event object. Identical to search_events_with_pricing but filters by category rather than free-text query. When pricing is unavailable, both price fields are null. Supports filtering by marketplace availability via axs_marketplace_event.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `axs_marketplace_event` | string | No | Filter events by AXS marketplace availability. Accepts 'true' (only marketplace events), 'false' (only non-marketplace events), or 'all' (no filtering). When omitted, no filtering is applied (equivalent to 'all'). |
| `category` | string | Yes | Major category: Music, Sports, or ArtsOrFamily |
| `lat` | number | No | Latitude for location-based search |
| `lng` | number | No | Longitude for location-based search |
| `page` | integer | No | Page number for results |
| `results` | integer | No | Number of results per page (max 50) |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-axs-com-api-b83d3df1/search_events_by_category_with_pricing \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"axs_marketplace_event":"<string>","category":"<string>","lat":"<number>","lng":"<number>","page":"<integer>","results":"<integer>"}'
```

### search_events_by_category_with_pricing_daterange

Search for events by category with minPrice and maxPrice extracted from veritix pricing data, filtered by an optional date range. Identical to search_events_by_category_with_pricing but additionally filters results to only include events whose eventDatetimeUtc falls within the specified start_date and end_date range. Client-side filtering may return fewer results than the requested page size. When pricing is unavailable, both price fields are null.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `category` | string | Yes | Major category: Music, Sports, or ArtsOrFamily |
| `end_date` | string | No | End date for filtering events (inclusive), ISO format YYYY-MM-DD. Only events on or before this date are returned. |
| `lat` | number | No | Latitude for location-based search |
| `lng` | number | No | Longitude for location-based search |
| `page` | integer | No | Page number for results |
| `results` | integer | No | Number of results per page to fetch from upstream before filtering (max 50) |
| `start_date` | string | No | Start date for filtering events (inclusive), ISO format YYYY-MM-DD. Only events on or after this date are returned. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-axs-com-api-b83d3df1/search_events_by_category_with_pricing_daterange \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"category":"<string>","end_date":"<string>","lat":"<number>","lng":"<number>","page":"<integer>","results":"<integer>","start_date":"<string>"}'
```