Prices

A price is a ticket type on an event, for example “Adult” or “Child”. Buyers choose one or more prices when they buy tickets.

The price object

Field	Type	Description
`id`	`integer`	Unique identifier.
`name`	`string`	Name of the price, e.g. `Voksen` or `Entré`.
`description`	`string`	Optional description shown to buyers.
`value`	`integer`	Price per ticket in øre. `15000` = 150.00 DKK.
`sale_begin_at`	`datetime`	When this price goes on sale. `null` follows the event’s sales period.
`sale_end_at`	`datetime`	When this price comes off sale. `null` follows the event’s sales period.
`minimum_count`	`integer`	Fewest tickets of this price per purchase, if any are bought. `0` means no minimum.
`maximum_count`	`integer`	Most tickets of this price per purchase.
`capacity`	`integer`	Number of tickets of this price. `null` if unlimited. Without its own capacity, a price is limited by the event’s capacity.
`sold_tickets`	`integer`	Number of tickets sold at this price.
`door_sales`	`integer`	Number of tickets sold at the door.
`meta_data.deletable`	`boolean`	`true` if no tickets have been sold at this price, so it can be deleted.

{
  "id": 23456789,
  "name": "Voksen",
  "description": "For 18-65 årige",
  "value": 15000,
  "sale_begin_at": "2026-10-01T08:00:00Z",
  "sale_end_at": "2026-12-05T18:00:00Z",
  "minimum_count": 0,
  "maximum_count": 10,
  "capacity": 1000,
  "sold_tickets": 312,
  "door_sales": 4,
  "meta_data": {
    "deletable": false
  }
}

List prices

GET/event_makers/:event_maker_id/events/:event_id/prices

Response200 OK

[
  {
    "id": 23456789,
    "name": "Voksen",
    "description": "For 18-65 årige",
    "value": 15000,
    "sale_begin_at": "2026-10-01T08:00:00Z",
    "sale_end_at": "2026-12-05T18:00:00Z",
    "minimum_count": 0,
    "maximum_count": 10,
    "capacity": 1000,
    "sold_tickets": 312,
    "door_sales": 4,
    "meta_data": {
      "deletable": false
    }
  }
]

Possible errors404 Not Found

Get a price

GET/event_makers/:event_maker_id/events/:event_id/prices/:price_id

Response200 OK

{
  "id": 23456789,
  "name": "Voksen",
  "description": "For 18-65 årige",
  "value": 15000,
  "sale_begin_at": "2026-10-01T08:00:00Z",
  "sale_end_at": "2026-12-05T18:00:00Z",
  "minimum_count": 0,
  "maximum_count": 10,
  "capacity": 1000,
  "sold_tickets": 312,
  "door_sales": 4,
  "meta_data": {
    "deletable": false
  }
}

Possible errors404 Not Found

Create a price

POST/event_makers/:event_maker_id/events/:event_id/prices

Adding the first price to a draft event can publish it. See Create an event.

Parameters

Parameter	Type	Description
`name`	`string`	required Name of the price. Longer text is cut at 30 characters.
`value`	`integer`	required Price per ticket in øre, `0` or more.
`description`	`string`	Description shown to buyers.
`minimum_count`	`integer`	Fewest tickets per purchase.
`maximum_count`	`integer`	Most tickets per purchase.
`sale_begin_at`	`datetime`	When the price goes on sale.
`sale_end_at`	`datetime`	When the price comes off sale.

Request body

{
  "price": {
    "name": "Voksen",
    "description": "For 18-65 årige",
    "value": 15000,
    "minimum_count": 0,
    "maximum_count": 10,
    "sale_begin_at": "2026-10-01T08:00:00Z",
    "sale_end_at": "2026-12-05T18:00:00Z"
  }
}

Response201 Created

Location: https://api.place2book.com/event_makers/1234567/events/12345678/prices/23456789

{
  "id": 23456789,
  "name": "Voksen",
  "description": "For 18-65 årige",
  "value": 15000,
  "sale_begin_at": "2026-10-01T08:00:00Z",
  "sale_end_at": "2026-12-05T18:00:00Z",
  "minimum_count": 0,
  "maximum_count": 10,
  "capacity": 1000,
  "sold_tickets": 312,
  "door_sales": 4,
  "meta_data": {
    "deletable": false
  }
}

Possible errors404 Not Found 422 Unprocessable Content

Update a price

PUT/event_makers/:event_maker_id/events/:event_id/prices/:price_id

Takes the same parameters as create. Every field is set from the request, so send the complete price.

Response200 OK

{
  "id": 23456789,
  "name": "Voksen",
  "description": "For 18-65 årige",
  "value": 15000,
  "sale_begin_at": "2026-10-01T08:00:00Z",
  "sale_end_at": "2026-12-05T18:00:00Z",
  "minimum_count": 0,
  "maximum_count": 10,
  "capacity": 1000,
  "sold_tickets": 312,
  "door_sales": 4,
  "meta_data": {
    "deletable": false
  }
}

Possible errors404 Not Found 422 Unprocessable Content

Delete a price

Only delete prices where meta_data.deletable is true.

DELETE/event_makers/:event_maker_id/events/:event_id/prices/:price_id

Response204 No Content

Possible errors404 Not Found 424 Failed Dependency