DevsDevelopers
Bookings

Remove a line item from a booking

DELETE
/bookings/{booking_id}/line-items/{id}

Removes a line item from a booking, releasing the held stock for that item. The booking must be in pending state.

Returns the full booking resource with the remaining line items.

Allowed states: pending → returns 200. Rejected states: pending_payment, completed, cancelled → returns 422.

Stock held outside Easol is given back before the line item goes. If that cannot be done, because the app managing it is unreachable for example, the line item stays on the booking and the request returns 422. Retry once the cause clears.

Path Parameters

booking_id*string

Booking prefixed ID (e.g. bk_mR2nL5pW)

id*string

Line item prefixed ID

Header Parameters

Idempotency-Key?string

Client-generated key for idempotent writes; the server deduplicates retries within a 24-hour window.

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X DELETE "https://example.com/bookings/string/line-items/string" \  -H "Easol-API-Version: 2026-11-01"
{
  "object": "booking",
  "id": "string",
  "reference": "string",
  "state": "pending",
  "sales_channel": "string",
  "total": {
    "amount": 0,
    "currency": "string"
  },
  "subtotal": {
    "amount": 0,
    "currency": "string"
  },
  "balance": {
    "amount": 0,
    "currency": "string"
  },
  "customer": {
    "object": "customer",
    "id": "string",
    "first_name": "string",
    "last_name": "string",
    "email": "user@example.com",
    "phone": "+447762000000",
    "email_marketing_consent": {
      "consented": true,
      "consented_at": "2026-09-04T10:00:00Z"
    },
    "sms_marketing_consent": {
      "consented": true,
      "consented_at": "2026-09-04T10:00:00Z"
    }
  },
  "billing_address": {
    "line_one": "string",
    "line_two": "string",
    "city": "string",
    "post_code": "string",
    "country_code": "string",
    "subdivision_code": "string"
  },
  "purchase_order_number": "string",
  "vat_number": "string",
  "expires_at": "string",
  "cancelled_at": "string",
  "created_at": "string",
  "custom_fields": [
    {
      "custom_field_id": "fld_aBcDeFgHiJ",
      "key": "flight_number",
      "type": "text",
      "value": "BA2612",
      "option": {
        "id": "string",
        "value": "string"
      }
    }
  ],
  "first_visit": {
    "object": "customer_visit",
    "id": "visit_7hK2mQ9x",
    "occurred_at": "2026-09-04T10:00:00Z",
    "landing_page": "https://shop.example.com/",
    "referrer_url": "https://partner.example.com/",
    "referral_code": "ExternalPartner"
  },
  "last_visit": {
    "object": "customer_visit",
    "id": "visit_7hK2mQ9x",
    "occurred_at": "2026-09-04T10:00:00Z",
    "landing_page": "https://shop.example.com/",
    "referrer_url": "https://partner.example.com/",
    "referral_code": "ExternalPartner"
  },
  "line_items": {
    "object": "list",
    "url": "string",
    "has_more": false,
    "next_cursor": "string",
    "data": [
      {
        "object": "line_item",
        "id": "string",
        "variant_id": "string",
        "product_id": "string",
        "quantity": 1,
        "state": "pending",
        "variant_name": "string",
        "product_name": "string",
        "start_date": "2019-08-24",
        "end_date": "2027-04-19",
        "start_time": "string",
        "experience_slot_id": "string",
        "total": {
          "amount": 0,
          "currency": "string"
        },
        "guest_count": 2,
        "allocated_resources": {
          "object": "list",
          "url": "string",
          "has_more": false,
          "next_cursor": "string",
          "data": [
            {
              "object": "resource",
              "id": "string",
              "name": "string",
              "resource_group_name": "string"
            }
          ]
        }
      }
    ]
  },
  "guests": {
    "object": "list",
    "url": "string",
    "has_more": false,
    "next_cursor": "string",
    "data": [
      {
        "object": "guest",
        "id": "string",
        "first_name": "string",
        "last_name": "string",
        "email": "string",
        "phone": "+447762000000",
        "line_item_id": "string",
        "check_in_status": "pending",
        "is_lead": true,
        "custom_fields": [
          {
            "custom_field_id": "fld_aBcDeFgHiJ",
            "key": "flight_number",
            "type": "text",
            "value": "BA2612",
            "option": {
              "id": "string",
              "value": "string"
            }
          }
        ]
      }
    ]
  }
}
{
  "error": {
    "code": "string",
    "message": "string"
  }
}
{
  "error": {
    "code": "string",
    "message": "string"
  }
}
{
  "error": {
    "code": "string",
    "message": "string"
  }
}
{
  "error": {
    "code": "string",
    "message": "string"
  }
}

Add a line item to a booking POST

Previous Page

Payments

Collect payment against a booking. A payment is initiated against a connected card reader and confirmed asynchronously. Poll the payment until it reaches `charged`, `failed`, or `cancelled`. A cancelled payment cannot complete. Create a new payment to retry.