Remove an item from a cart | TTG Developer Portal

{
  "id": "6aac14d3-5826-4da8-98b6-9e68c28629d6",
  "expiresAt": "2026-03-15T19:40:00Z",
  "items": [
    {
      "id": "Qm9va2luZ3Mx",
      "event": {
        "id": "123",
        "name": "Hamilton"
      },
      "occurrence": {
        "id": "456",
        "startsAt": "2026-03-15T19:30:00-04:00"
      },
      "venue": {
        "id": "UmljaGFyZCBSb2RnZXJzIFRoZWF0cmU",
        "name": "Richard Rodgers Theatre",
        "address": {
          "line1": "226 W 46th St",
          "line2": "Suite 200",
          "city": "New York",
          "state": "NY",
          "postalCode": "10036",
          "country": "US",
          "latitude": 40.759,
          "longitude": -73.9845
        },
        "timezone": "America/New_York"
      },
      "inventoryVariant": {
        "_type": "AssignedSeat",
        "attributes": [
          {
            "name": "Limited Legroom",
            "category": "NEGATIVE",
            "description": "Seats in this row have reduced legroom due to a safety barrier."
          }
        ],
        "id": "Orchestra-A-101",
        "name": "Orchestra A 101",
        "row": "A",
        "seat": "101",
        "section": "Orchestra",
        "description": "Closest to the stage",
        "entrance": "Door 4",
        "extendedDescription": "Includes a complimentary drink. **Over 18s only.**",
        "images": [
          {
            "url": "https://example.com/seat-views/orchestra-a-101-center.jpg"
          }
        ]
      },
      "priceOption": {
        "category": {
          "name": "Adult",
          "id": "4471",
          "description": "Ages 3-12"
        },
        "sellPrice": {
          "amount": 18500,
          "currency": "USD"
        },
        "id": "eyJjIjoiRlVMTCJ9",
        "constraints": {
          "requiresCategory": [
            "string"
          ]
        },
        "listPrice": {
          "amount": 18500,
          "currency": "USD"
        },
        "discountPercentage": 30,
        "discountAmount": {
          "amount": 18500,
          "currency": "USD"
        },
        "fees": [
          {
            "type": "SERVICE_FEE",
            "value": {
              "amount": 18500,
              "currency": "USD"
            }
          }
        ],
        "maxQuantityPerOrder": 4,
        "promotion": {
          "id": "promo-opening-week",
          "name": "Opening Week Special",
          "description": "40% off Orchestra seats for opening week performances."
        },
        "isDefault": true
      },
      "quantity": 1,
      "delivery": {
        "method": {
          "name": "E-ticket"
        },
        "instructions": "Your e-tickets will be emailed to you before the performance."
      }
    }
  ],
  "receiptLines": [
    {
      "label": "Subtotal",
      "total": {
        "amount": 18500,
        "currency": "USD"
      },
      "sign": "positive",
      "_type": "SubtotalLine"
    }
  ],
  "total": {
    "amount": 18500,
    "currency": "USD"
  },
  "protection": {
    "id": "prot_001",
    "pricePerItem": {
      "amount": 18500,
      "currency": "USD"
    },
    "total": {
      "amount": 18500,
      "currency": "USD"
    },
    "status": "ELIGIBLE"
  },
  "options": {
    "currencies": [
      "USD",
      "GBP",
      "EUR"
    ],
    "paymentMethods": [
      {
        "method": "CARD",
        "gateway": "ADYEN",
        "merchantAccount": "EncoreTicketsOwnBrand"
      }
    ],
    "extras": [
      {
        "id": "v1_AQAAAAPoAAAABk9yY2hlc3RyYS1BLTEwMQ",
        "inventoryVariant": {
          "_type": "AssignedSeat",
          "attributes": [
            {
              "name": "Limited Legroom",
              "category": "NEGATIVE",
              "description": "Seats in this row have reduced legroom due to a safety barrier."
            }
          ],
          "id": "Orchestra-A-101",
          "name": "Orchestra A 101",
          "row": "A",
          "seat": "101",
          "section": "Orchestra",
          "description": "Closest to the stage",
          "entrance": "Door 4",
          "extendedDescription": "Includes a complimentary drink. **Over 18s only.**",
          "images": [
            {
              "url": "https://example.com/seat-views/orchestra-a-101-center.jpg"
            }
          ]
        },
        "priceOptions": [
          {
            "category": {
              "name": "Adult",
              "id": "4471",
              "description": "Ages 3-12"
            },
            "sellPrice": {
              "amount": 18500,
              "currency": "USD"
            },
            "id": "eyJjIjoiRlVMTCJ9",
            "constraints": {
              "requiresCategory": [
                "string"
              ]
            },
            "listPrice": {
              "amount": 18500,
              "currency": "USD"
            },
            "discountPercentage": 30,
            "discountAmount": {
              "amount": 18500,
              "currency": "USD"
            },
            "fees": [
              {
                "type": "SERVICE_FEE",
                "value": {
                  "amount": 18500,
                  "currency": "USD"
                }
              }
            ],
            "maxQuantityPerOrder": 4,
            "promotion": {
              "id": "promo-opening-week",
              "name": "Opening Week Special",
              "description": "40% off Orchestra seats for opening week performances."
            },
            "isDefault": true
          }
        ],
        "quantityAvailable": 1,
        "maxQuantityPerOrder": 6,
        "selectionGroup": {
          "inventoryItemIds": [
            "v1_AQAAAAPoAAAABk9yY2hlc3RyYS1BLTEwMQ",
            "v1_AQAAAAPoAAAABk9yY2hlc3RyYS1BLTEwMg"
          ]
        },
        "selectionBlocked": {
          "chainSize": 3
        },
        "requirements": {
          "occurrence": {
            "earliestStart": "2026-03-01T15:00:00Z",
            "latestStart": "2026-03-02T03:00:00Z"
          }
        }
      }
    ]
  },
  "voucher": {
    "code": "SUMMER20",
    "discount": {
      "amount": 18500,
      "currency": "USD"
    }
  },
  "totalTaxes": {
    "amount": 18500,
    "currency": "USD"
  }
}

Drops an extra from the cart and returns the cart repriced without it. The rest of the cart is untouched — the customer keeps the same hold and the same expiry.

itemId is the id of the line on the cart response, not an inventory item ID. Two items of the same extra at different price options are separate lines with ids of their own
Idempotent — an itemId the cart does not hold returns the current cart
Only an Extra item can be removed. A cart is created from its admission items; one that should hold none is released with DELETE /carts/{cartId}

Authentication

X-TT-API-Keystring

API Key authentication via header

Path parameters

cartIdstringRequired

Cart ID (UUID)

itemIdstringRequired

Cart item ID, as it came back on the cart response items[].id

Response headers

X-RateLimit-Limitinteger

How many requests this API key may make for this retailer in the current window. Sent only when the request was counted against that limit. A response served from cache was not counted and repeats the value it was cached with.

X-RateLimit-Remaininginteger

How many requests this API key has left for this retailer in the current window. Sent only when the request was counted against that limit. A response served from cache was not counted and repeats the value it was cached with.

Response

Cart repriced without the item (or unchanged, if it did not hold it).

idstring

Cart ID

expiresAtstring

UTC timestamp when the cart hold expires and inventory is released. Clients should display a countdown timer and warn users before expiration.

itemslist of objects

Items currently in the cart (held inventory). Each item’s priceOption carries the itemized fees[] disclosure. Protection and credits are NOT items — see receiptLines.

receiptLineslist of objects

Server-ordered display lines for receipt rendering. Iterate in sequence. Always includes SubtotalLine. Conditionally: VoucherLine, ProtectionLine, CreditLine. Fees are never a receipt line — they are disclosed per item on priceOption.fees.

totalobject

Monetary amount in minor units (cents for USD). Never uses floating point to avoid precision errors.

protectionobjectOptional

Protection covering all items. Null if not added.

optionsobjectOptional

Options that can be applied to this cart. Each key is present only when that option is available.

voucherobjectOptional

A promo code applied to a cart.

totalTaxesobjectOptional

Monetary amount in minor units (cents for USD). Never uses floating point to avoid precision errors.

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

409

Conflict Error

410

Gone Error

429

Too Many Requests Error

Authentication

Path parameters

Headers

Response headers

Response

Errors