> 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/tickets/transactions.md).

# Transactions

## Retrieving transactions

The tickets transactions API allows you to retrieve a list of ticket transactions, including details such as payment status, ticket information, and customer details.

### Request

`GET` `/tickets/transactions`

**Params**

<table><thead><tr><th width="120.73046875">Name</th><th width="129.04296875">Mandatory</th><th width="98.26953125">Type</th><th>Description</th></tr></thead><tbody><tr><td><code>event</code></td><td><strong>Required</strong></td><td>string</td><td>Event slug identifier</td></tr><tr><td><code>from</code></td><td><em>Optional</em></td><td>string</td><td>Start date and time (format: <code>YYYY-MM-DD HH:MM:SS</code>)</td></tr><tr><td><code>to</code></td><td><em>Optional</em></td><td>string</td><td>End date and time (format: <code>YYYY-MM-DD HH:MM:SS</code>)</td></tr><tr><td><code>page</code></td><td><em>Optional</em></td><td>int</td><td>The current page of the results (default: 1)</td></tr><tr><td><code>limit</code></td><td><em>Optional</em></td><td>int</td><td>Number of results per page (default: 100, max: 10,000)</td></tr><tr><td><code>currency</code></td><td><em>Optional</em></td><td>string</td><td>Filter transactions by currency code (e.g. <code>EUR</code>, <code>USD</code>). Must be an enabled currency for the client</td></tr></tbody></table>

**Request Example**

```
curl --request GET \
  --url 'https://entrytickets.be/api/tickets/transactions?event=summer-festival&from=2024-08-31%2020%3A00%3A00&to=2025-09-30%2020%3A00%3A00&page=1&limit=100'
```

**Response**

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

```json
{
  "transactions": [
    {
      "time_created": "2025-07-15 14:32:18",
      "transaction_id": "a8f94b2c-7e15-4d89-bf23-9c4e8a7f6d12",
      "status": "paid",
      "amount": 89.5,
      "currency": "EUR",
      "fee": 2.5,
      "email": "sarah.johnson@example.com",
      "order": {
        "tickets": [
          {
            "type": "weekend_pass_early",
            "options": {
              "tier": "standard"
            },
            "naam": "Sarah Johnson"
          },
          {
            "type": "weekend_pass_early",
            "options": {
              "tier": "vip"
            },
            "naam": "Michael Chen"
          }
        ]
      },
      "metadata": {
        "language": "english"
      }
    }
  ],
  "total": 1547,
  "page": 1,
  "pages": 16,
  "limit": 100
}
```

{% endtab %}

{% tab title="400" %}

```json
{
  "error": "Invalid request"
}
```

{% endtab %}
{% endtabs %}

**General Response Fields**

<table><thead><tr><th width="133.06640625">Field</th><th width="106.44921875">Type</th><th>Description</th></tr></thead><tbody><tr><td>transactions</td><td>array</td><td>List of transaction objects</td></tr><tr><td>total</td><td>int</td><td>Total number of transactions available</td></tr><tr><td>page</td><td>int</td><td>Current page number</td></tr><tr><td>pages</td><td>int</td><td>Total number of pages</td></tr><tr><td>limit</td><td>int</td><td>Number of transactions per page</td></tr></tbody></table>

**Transaction Response Fields**

<table><thead><tr><th width="177.66796875">Field</th><th>Description</th></tr></thead><tbody><tr><td>time_created</td><td>The timestamp when the transaction was initiated (<code>YYYY-MM-DD HH:MM:SS</code>)</td></tr><tr><td>transaction_id</td><td>The unique transaction identifier</td></tr><tr><td>status</td><td>The payment status of the transaction (e.g., <code>paid</code>, <code>failed</code>, <code>open</code>)</td></tr><tr><td>amount</td><td>The total transaction amount (including fees)</td></tr><tr><td>currency</td><td>Currency code for the transaction amount (e.g. <code>EUR</code>, <code>USD</code>)</td></tr><tr><td>fee</td><td>The service fee charged for the transaction</td></tr><tr><td>email</td><td>Customer's email address</td></tr><tr><td>order</td><td>Object containing purchased items</td></tr><tr><td>order.tickets</td><td>Array of ticket objects purchased</td></tr><tr><td>order.vouchers</td><td>Object containing voucher types and quantities (if any)</td></tr><tr><td>metadata</td><td>Additional transaction metadata including language preference</td></tr></tbody></table>

**Ticket Object Fields**

<table><thead><tr><th width="126.47265625">Field</th><th>Description</th></tr></thead><tbody><tr><td>type</td><td>The ticket type identifier</td></tr><tr><td>options</td><td>Selected ticket options/upgrades</td></tr><tr><td>naam</td><td>Name assigned to the ticket</td></tr></tbody></table>