> For the complete documentation index, see [llms.txt](https://docs.entrytickets.eu/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.entrytickets.eu/dashboard/events/list.md).

# List

## Retrieving events

The events API returns:

* Events owned by the client associated with your API key.
* Events that another client has explicitly shared with your visitor-facing portal.

Every item includes `client`, identifying the client that owns the event.

### Shared and linked events

Two different relationships can appear in List responses.

**Shared events** appear because another client shared them with your visitor-facing portal. They stay owned by that other client. You get them in this list for discovery and linking. Details stays limited to events your API key owns.

**Linked events** share ticket inventory between events. When an event you own lists `linked_events`, Details sold counts for matching ticket types (and sales-data endpoints) include those linked events. You still open Details only for events you own.

{% hint style="info" %}
For public homepage listings, filter on `status === "published"`. For multi-day events, `date` is an array.
{% endhint %}

{% hint style="warning" %}
A shared event's `client` can differ from your API key's client. Treat `client` and `slug` together as the event identity.
{% endhint %}

### Building event URLs

Every listed event has a ticket shop. Link to it with `client` and `slug`: both in the path on entrytickets.be, or just the event slug if you have your own domain.

<table><thead><tr><th width="271.49081493355334">Setup</th><th>Example</th></tr></thead><tbody><tr><td>Default domain</td><td><code>https://entrytickets.be/acme/summer-festival</code></td></tr><tr><td>Your own domain (if activated)</td><td><code>https://tickets.example.com/summer-festival</code></td></tr></tbody></table>

{% hint style="info" %}

#### Optional: Entrybe membership login

If you use the Entrybe membership module and ticket purchasing for that event is members-only, send visitors to your portal login with a `redirect` parameter set to that same `{client}/{slug}` path. After they sign in, they will be redirected to the ticket shop.&#x20;

\
For example `https://entrytickets.be/acme/portal/login?redirect=acme%2Fsummer-festival` \
or `https://tickets.example.com/portal/login?redirect=acme%2Fsummer-festival`
{% endhint %}

### Request

**`GET`** `/events`

**Request Example**

```
curl --request GET \
  --url 'https://entrytickets.be/api/events'
```

**Response**

{% tabs %}
{% tab title="200" %}

```json
[
  {
    "client": "acme",
    "date": "2026-08-15",
    "slug": "summer-festival",
    "name": "Summer Music Festival",
    "cover": "https://cdn.entrytickets.be/images/events/cover/a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6.jpeg",
    "location": "Fukuoka Convention Center",
    "status": "published",
    "sales_start": "2026-06-01T08:00:00Z",
    "sales_end": "2026-08-14T14:59:00Z",
    "tags": ["Music", "Festival"],
    "default_lang": "english",
    "descriptions": {
      "english": {
        "html": "<p>Join us for an unforgettable weekend of live music.</p>",
        "text": "Join us for an unforgettable weekend of live music."
      }
    }
  },
  {
    "client": "partner-org",
    "date": ["2026-10-07", "2026-10-08"],
    "slug": "annual-event",
    "name": "Partner Annual Event",
    "cover": "https://cdn.entrytickets.be/images/events/cover/q7r8s9t0u1v2w3x4y5z6a7b8c9d0e1f2.jpg",
    "status": "published",
    "sales_start": "2026-07-01T00:00:00Z",
    "sales_end": "2026-10-06T14:59:00Z"
  }
]
```

{% endtab %}

{% tab title="404" %}

```json
{
  "status": false,
  "message": "No events were found"
}
```

{% endtab %}

{% tab title="401" %}

```json
{
  "message": "Unauthorized access"
}
```

{% endtab %}
{% endtabs %}