> ## Documentation Index
> Fetch the complete documentation index at: https://docs.gomry.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Hold seats

> Reserve seats on an experience session while your customer pays. Optional.

Seats stay reserved for `ttl_seconds`, then return to sale. Holds are for experience products; an event answers `not_supported`: [place the order](https://docs.gomry.com/distribution-api/create-order.md) directly.

**external\_ref** `string` *required*

Your cart or reservation id. 1 to 128 letters, digits, `.`, `_`, `:` or `-`. Sending it again returns the same hold.

**product\_id** `string` *required*

An experience product: `exp_…`.

**start** `string` *required*

The session's `start.utc`, from the product's [sessions](https://docs.gomry.com/distribution-api/product-sessions.md).

**lines** `array` *required*

One to 20 lines.

**Line**

**offer\_id** `string` *required*

From the product's `offers`.

**quantity** `integer` *required*

1 to 50.

**ttl\_seconds** `integer`

60 to 3600. Defaults to 1800.

```bash theme={null}
curl -X POST https://www.gomry.com/api/v1/distribution/holds \
  -H "Authorization: Bearer gdk_..." \
  -H "Content-Type: application/json" \
  -d '{
    "external_ref": "your-cart-1",
    "product_id": "exp_1y9Gr0O6FGmS38BSQcJf",
    "start": "2026-12-01T10:00:00.000Z",
    "lines": [{ "offer_id": "tc-adult", "quantity": 2 }],
    "ttl_seconds": 1800
  }'
```

## Response

Answers `201` with the hold:

**hold\_id** `string`

Pass it as `hold_id` when you [place the order](https://docs.gomry.com/distribution-api/create-order.md).

**external\_ref** `string`

**status** `string`

`held`, `released` or `booked`.

**product\_id** `string`

**start** `string`

**lines** `array`

Each with its `offer_id` and `quantity`.

**expires\_at** `string`

When the seats return to sale.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.