# Marketplace

The marketplace holds secondary-market resale listings. Prices are in
fiat, and each event's resale royalty and anti-scalping bounds are applied
automatically per its `marketplace_settings` (see [Events](#api-events)). See
the [Marketplace and resale](#marketplace-and-resale) guide.

A serialized listing object:

```json
{
  "id": "list_9f8e7d6c5b4a43210fedcba9876543aa",
  "ticket_id": "tkt_4d5e6f7a8b9c0d1e2f3a4b5c",
  "price": 160.00,
  "currency": "USD",
  "status": "active",
  "created_at": "2026-06-05T13:00:00.000Z"
}
```

---

## GET /v1/marketplace/listings

List your resale listings, newest first. Each listing carries its `status`
(for example `active`); the list is not filtered to active listings.

**Scope:** `marketplace:read`

### Query params

| Param | Type | Required | Description |
| --- | --- | --- | --- |
| `limit` | integer | No | Page size, `1`–`100` (default `20`). |
| `starting_after` | string | No | Cursor — a listing id to page after. |

### Example request

```bash
curl "https://api.ticketconnect.example/v1/marketplace/listings?limit=2" \
  -H "Authorization: Bearer sk_test_your_key_here"
```

### Example response

```json
{
  "object": "list",
  "has_more": false,
  "data": [
    {
      "id": "list_9f8e7d6c5b4a43210fedcba9876543aa",
      "ticket_id": "tkt_4d5e6f7a8b9c0d1e2f3a4b5c",
      "price": 160.00,
      "currency": "USD",
      "status": "active",
      "created_at": "2026-06-05T13:00:00.000Z"
    }
  ]
}
```

---

## GET /v1/marketplace/listings/{id}

Retrieve a single resale listing with its fiat price.

**Scope:** `marketplace:read`

### Path params

| Param | Type | Required | Description |
| --- | --- | --- | --- |
| `id` | string | Yes | Listing id. |

### Example request

```bash
curl https://api.ticketconnect.example/v1/marketplace/listings/list_9f8e7d6c5b4a43210fedcba9876543aa \
  -H "Authorization: Bearer sk_test_your_key_here"
```

### Example response

```json
{
  "id": "list_9f8e7d6c5b4a43210fedcba9876543aa",
  "ticket_id": "tkt_4d5e6f7a8b9c0d1e2f3a4b5c",
  "price": 160.00,
  "currency": "USD",
  "status": "active",
  "created_at": "2026-06-05T13:00:00.000Z"
}
```