[Cotlet](https://cotlet.dev/index.md) · [Integrations](https://cotlet.dev/integrations.md) · [How it works](https://cotlet.dev/how-it-works.md) · [Use cases](https://cotlet.dev/use-cases.md) · [Security](https://cotlet.dev/security.md) · [For developers](https://cotlet.dev/for-developers.md) · [For automation agencies](https://cotlet.dev/for-agencies.md) · [Blog](https://cotlet.dev/blog.md) · [API docs](https://cotlet.dev/docs.md) · [Help center](https://cotlet.dev/help.md) · [Changelog](https://cotlet.dev/changelog.md) · [Contact](https://cotlet.dev/contact.md) · [Pricing](https://cotlet.dev/pricing.md) · [Sign up](https://cotlet.dev/signup)

# List orders

> Orders across all your events, searched by buyer email, name or order ID. Inputs, cURL, Python and Node.js examples and an example response.

Source: https://cotlet.dev/docs/api/billetto/list_orders

Docs sections: [Get started](https://cotlet.dev/docs.md) · [REST API](https://cotlet.dev/docs/api.md) · [MCP](https://cotlet.dev/docs/mcp.md) · [SDKs & CLI](https://cotlet.dev/docs/sdks.md) · [Integrations](https://cotlet.dev/docs/integrations.md)

Orders across all your events, searched by buyer email, name or order ID.

Billetto API: https://cotlet.dev/docs/api/billetto.md

`GET https://cotlet.dev/api/v1/billetto/orders`

Access: read.

Searches the account-level order list (Manage > Attendees), newest first. query matches the buyer's email address, name or order ID, the three ways Billetto looks an order up. event_id narrows the list to one event. Each row has the order_id, buyer, event and ticket count; get_order returns the tickets.

## Parameters

| Name | Type | Required | Description |
|---|---|---|---|
| `query` | string | no | Buyer email address, buyer name or order ID. |
| `event_id` | string | no | Only orders of this event, from list_events. |
| `cursor` | string | no | Next page cursor from the previous call. |

## Request

**cURL**

```bash
curl https://cotlet.dev/api/v1/billetto/orders \
  -H "Authorization: Bearer $COTLET_API_KEY"
```

**Python**

```python
result = client.call("billetto", "list_orders")
```

**Node.js**

```js
const result = await cotlet.call('billetto', 'list_orders');
```

**CLI**

```bash
cotlet call billetto list_orders
```

## Example response

```json
{
  "orders": [
    {
      "order_id": "9035127",
      "event_id": "1204551",
      "event": "Autumn Jazz Night",
      "buyer": "Maria Jensen",
      "email": "maria.jensen@example.com",
      "placed_at": "2026-10-19T18:42:10+02:00",
      "tickets": 3
    }
  ],
  "next_cursor": null
}
```

Previous: [List ticket types](https://cotlet.dev/docs/api/billetto/list_ticket_types.md)
Next: [Get order](https://cotlet.dev/docs/api/billetto/get_order.md)

---

Give your AI agents your signed-in browser.

**Product:** [Integrations](https://cotlet.dev/integrations.md) · [Use cases](https://cotlet.dev/use-cases.md) · [How it works](https://cotlet.dev/how-it-works.md) · [Pricing](https://cotlet.dev/pricing.md) · [Security](https://cotlet.dev/security.md)

**Resources:** [Blog](https://cotlet.dev/blog.md) · [API docs](https://cotlet.dev/docs.md) · [Help center](https://cotlet.dev/help.md) · [Changelog](https://cotlet.dev/changelog.md) · [GitHub](https://github.com/cotletdev/cotlet)

**Solutions:** [For developers](https://cotlet.dev/for-developers.md) · [For automation agencies](https://cotlet.dev/for-agencies.md)

**Company:** [About](https://cotlet.dev/about.md) · [AI info: company facts](https://cotlet.dev/ai-info.md) · [Contact](https://cotlet.dev/contact.md)

**Legal:** [Terms of service](https://cotlet.dev/terms) · [Privacy policy](https://cotlet.dev/privacy) · [Refund policy](https://cotlet.dev/refunds) · [Acceptable use](https://cotlet.dev/acceptable-use) · [Cookie policy](https://cotlet.dev/cookies) · [DPA](https://cotlet.dev/dpa) · [Subprocessors](https://cotlet.dev/subprocessors)

**Elsewhere:** [Status page](https://status.cotlet.dev) · [Cotlet on GitHub](https://github.com/cotletdev) · [Cotlet on X](https://x.com/cotletdev) · [Cotlet on LinkedIn](https://www.linkedin.com/company/cotletdev) · [Cotlet on Product Hunt](https://www.producthunt.com/products/cotlet) · [Cotlet on Crunchbase](https://www.crunchbase.com/organization/cotlet) · [Cotlet on SaaSHub](https://www.saashub.com/cotlet)

Cotlet.dev is built by Bart Krawczyk and Jake Slugocki, the founders of Take Group sp. z o.o., ul. Wincentego Janasa 4, 40-855 Katowice, Poland. KRS 0000871398, NIP 6342984273, VAT EU: PL6342984273. [About us](https://cotlet.dev/about.md)

Cotlet is an independent service. It is not affiliated with, endorsed by or sponsored by any of the products listed on this site. Product names are trademarks of their respective owners.