# Similar events

"You might also like" for your catalog: given one of your events, list the
events **from your own catalog** most similar to it — for cross-sell modules,
post-purchase recommendations, or "more like this" rails.

**Results only ever come from your own catalog.** Similarity is computed
within your account, and another account's events can never appear in your
results, in any direction. Only **published, upcoming** events are returned.

---

## GET /v1/events/{id}/similar

List the events most similar to this one, best match first. Each item is the
standard [event object](#api-events) plus a `similarity` score in `(0, 1]` —
higher is more similar.

**Scope:** `events:read`

### Path params

| Param | Type | Required | Description |
| --- | --- | --- | --- |
| `id` | string | Yes | The reference event id. |

### Query params

| Param | Type | Required | Description |
| --- | --- | --- | --- |
| `limit` | integer | No | Max results, `1`–`20` (default `5`). |

### Example request

```bash
curl "https://api.ticketconnect.example/v1/events/evt_a1b2c3d4e5f6a7b8c9d0e1f2/similar?limit=3" \
  -H "Authorization: Bearer sk_test_your_key_here"
```

### Example response

```json
{
  "object": "list",
  "data": [
    {
      "id": "evt_b2c3d4e5f6a7b8c9d0e1f2a3",
      "name": "Riverside Sessions: Indie Night",
      "status": "published",
      "date": "2026-08-22T19:00:00.000Z",
      "venue": "Riverside Park",
      "currency": "USD",
      "similarity": 0.912
    },
    {
      "id": "evt_c3d4e5f6a7b8c9d0e1f2a3b4",
      "name": "Late Summer Open Air",
      "status": "published",
      "date": "2026-09-05T17:30:00.000Z",
      "venue": "East Meadow",
      "currency": "USD",
      "similarity": 0.847
    }
  ],
  "has_more": false
}
```

The list is not paginated (`has_more` is always `false`) — raise `limit` up to
`20` if you want more candidates. A reference event with no similar upcoming
events returns an empty list, not an error.

> Errors: `404 resource_missing` if the reference event does not exist or is
> not yours.