Place2Book Developers
api@place2book.com

Purchases

A purchase is a completed order for an event. It holds the buyer’s contact details, the tickets bought, any additionals, answers to custom questions and messages from the buyer.

The purchase object

Field Type Description
purchase_id integer Unique identifier.
customer_profile_id integer Identifier of the buyer’s customer profile.
full_name string Buyer’s name.
email string Buyer’s email address.
phone_number string Buyer’s phone number.
zip_code string Buyer’s postal code.
total_price_paid integer Total amount paid by the buyer, in øre.
transaction_type string State of the purchase: completed or finalize_completed. Both mean the purchase is paid.
created_at datetime When the purchase was made.
tickets array Tickets in the purchase. See The ticket object.
custom_field_values array Answers to questions asked once per purchase (Information om kunder).
custom_field_values[].custom_field_name string The question.
custom_field_values[].value string The buyer’s answer.
transaction_inquires array Messages from the buyer. See Transaction inquiries.
transaction_inquires[].id integer Identifier of the message.
transaction_inquires[].body string Message text.
transaction_inquires[].is_read boolean Whether the message has been marked as read in Event Admin.
transaction_inquires[].created_at datetime When the message was sent.

The ticket object

Field Type Description
ticket_id integer Unique identifier.
price_id integer Price (ticket type) of the ticket.
total_amount_paid integer Amount paid for this ticket, in øre.
arrived_at datetime or string Time of the latest scan, or an empty string "" if the ticket hasn’t been scanned. Can be reset for re-entry tickets. See Ticket arrivals for the full scan history.
seating string Seat or section, if the event has a seating plan. Empty string otherwise.
barcode string Barcode printed on the ticket.
custom_fields array Answers to questions asked per ticket, each with custom_field_name and value.
additional_sales array Additionals bought with this ticket.
additional_sales[].additional_sale_id integer Identifier of the sale.
additional_sales[].additional_id integer Identifier of the additional.
additional_sales[].additional_name string Name of the additional.
additional_sales[].debit_total_for_customer integer Amount paid for the additional, in øre.

List purchases

Returns all completed purchases for an event. Pending, failed and abandoned orders are not included.

GET/event_makers/:event_maker_id/events/:event_id/purchases
Response200 OK
[
  {
    "purchase_id": 1545123,
    "customer_profile_id": 56421234,
    "full_name": "Jane Doe",
    "email": "jane@example.com",
    "phone_number": "+4512345678",
    "zip_code": "2730",
    "total_price_paid": 39000,
    "transaction_type": "completed",
    "created_at": "2026-11-11T07:30:02Z",
    "tickets": [
      {
        "ticket_id": 124665,
        "price_id": 23456789,
        "total_amount_paid": 15000,
        "arrived_at": "2026-12-05T18:42:10Z",
        "seating": "Række 3, sæde 5",
        "custom_fields": [
          {
            "custom_field_name": "Allergier",
            "value": "Skaldyr"
          }
        ],
        "barcode": "ABCD1234",
        "additional_sales": [
          {
            "additional_sale_id": 342946,
            "additional_id": 345678,
            "additional_name": "Ølbillet",
            "debit_total_for_customer": 4500
          }
        ]
      },
      {
        "ticket_id": 124666,
        "price_id": 23456789,
        "total_amount_paid": 15000,
        "arrived_at": "",
        "seating": "Række 3, sæde 6",
        "custom_fields": [
          {
            "custom_field_name": "Allergier",
            "value": "Skaldyr"
          }
        ],
        "barcode": "ABCD1235",
        "additional_sales": []
      }
    ],
    "custom_field_values": [
      {
        "custom_field_name": "Transportmiddel",
        "value": "Bil"
      }
    ],
    "transaction_inquires": [
      {
        "id": 1515333,
        "body": "I have severe allergies to shellfish and peanuts. Does the food served at the event contain any of these?",
        "is_read": false,
        "created_at": "2026-11-11T07:32:19Z"
      }
    ]
  }
]
Possible errors404 Not Found

Cached for finished events Once an event is held or completed, this response may be cached for up to a week. Use Ticket arrivals for up-to-date scan data.