Tickets / API reference

Update a ticket type

Edit a ticket type. Quantity cannot fall below tickets already sold or reserved.

PUT/ticket-types/{ticketType}

Authentication

Send your live API key in the Authorization: Bearer header. All requests use https://api.celerlinks.com/api-service.

Request parameters

ticketTypestring · path · required

ID of a ticket type belonging to your event.

namestring · body · required

Ticket name; up to 255 characters.

pricenumber · body · required

Price in NGN, not kobo. Use 0 for free admission.

quantityinteger · body · optional

Number of tickets available; minimum 1.

descriptionstring · body · optional

Optional ticket description.

sales_startstring · body · optional

ISO 8601 date/time.

sales_endstring · body · optional

Must be later than sales_start.

min_per_orderinteger · body · optional

Minimum tickets per order; at least 1.

max_per_orderinteger · body · optional

At least min_per_order.

Examples are illustrative. Catalogue IDs, product codes, prices, and provider-specific fields must come from your current API responses.

cURL request

curl --request PUT 'https://api.celerlinks.com/api-service/ticket-types/YOUR_TICKETTYPE' \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Accept: application/json' \
  --header 'Content-Type: application/json' \
  --data '{
  "name": "General admission",
  "price": 5000,
  "quantity": 150
}'

Illustrative response

{
  "success": true,
  "message": "Request completed successfully",
  "data": {
    "ticket_type": {
      "id": 456,
      "name": "General admission",
      "price": 5000,
      "quantity": 150
    }
  }
}