» iabilet.ro
API docs by Redocly

iaBilet API (1.2)

Overview

This API is the interface for interacting with the iaBilet platform.

Examples:

Errors

In case of an error, any call returns a structure of the form:

{
    "error": 100,
    "message": "Error message"
}

Heads up! The HTTP status returned in case of an error is 200. This behavior will change in a future version of the API.

To identify if a call has returned an error, test for the existence of the error key in the response.

Authentication

To authenticate with the API, log in using the /login endpoint to obtain a bearer token. This token must be included in the Authorization header of all subsequent requests.

All API endpoints require authentication unless specified otherwise. Unauthorized access will result in a 401 Unauthorized response.

Log in

Authenticates the client using an application key and secret. Returns an authentication token to be used in subsequent requests.

Request Body schema: application/json

API login request

key
required
string

Application key

secret
required
string

Application secret

Responses

Response Schema: application/json
authToken
string

Authentication token

Request samples

Content type
application/json
{
  • "key": "c6jm3R3JDGkwb2bP",
  • "secret": "pHbEahQdbiVmpFqV"
}

Response samples

Content type
application/json
{
  • "authToken": "string"
}

Get user identity information

Returns the username and API key of the authenticated user.

Authorizations:
Bearer
header Parameters
Authorization
required
string
Example: Bearer 00000000058pG5D4vPSs34ba2bd62caf68a4855249841b5d56f4f

Authentication token returned by /login

Responses

Response Schema: application/json
username
string

The username of the authenticated user

key
string

The API key associated with the authenticated user

Response samples

Content type
application/json
{
  • "username": "user438274",
  • "key": "c6jm3R3JDGkwb2bP"
}

Reading data

Access to data is determined by the permissions assigned to the API key.

If you need access to additional data, please contact the administrator to adjust your API key permissions.

Events

Get a list of available events, optionally filtering by date, sold-out status, and other parameters.

Authorizations:
Bearer
query Parameters
fromDate
string <date>
Example: fromDate=2014-08-20

Start date for filtering events (format YYYY-MM-DD)

toDate
string <date>

End date for filtering event (format YYYY-MM-DD)

includeSoldOut
integer

Include sold-out events. 1 for yes, 0 for no.

includeVenueOnly
integer

Include "venue only" events

includeExternal
integer

Include third-party events (external URL only)

orderBy
string
Enum: "popularity" "date"
Example: orderBy=popularity

Order results by popularity or date

category
string
Example: category=concerte

Event category code. See /categories for the list of available categories.

fullVenue
integer

Include full details about the venue

fullDesc
integer

Include full description of the event

header Parameters
Authorization
required
string
Example: Bearer 00000000058pG5D4vPSs34ba2bd62caf68a4855249841b5d56f4f

Authentication token returned by /login

Responses

Response Schema: application/json
Array
id
integer

Event ID

title
string

Event title

startDate
string <date>

Event start date

endDate
string <date>

Event end date

startDateTime
string <date-time>

Event start date and time

hasTime
boolean

Whether the event has a specific start time

string or object
One of
string

Venue name (if fullVenue is 0)

venueId
integer

Venue ID

allowBooking
boolean

Whether booking is allowed for this event

allowBookingEx
string
Enum: "draft" "Y" "pending" "venue_only" "free_entry" "sold_out" "cancelled" "disabled" "pre_register" "require_voucher" "maintenance" "ready_for_sale"

Booking status

maxNrTicketsPerOrder
integer

Maximum number of tickets allowed per order

soldOut
boolean

Whether the event is sold out

hasAvailableSeats
boolean

Whether there are available seats for this event

imageUrl
string

URL of the event poster image

shortDesc
string

Short description of the event

category
string

Main category of the event

moreCategories
Array of strings

Additional categories for the event

tags
Array of strings

Tags associated with the event

fullDesc
string

Full description of the event (if fullDesc is 1)

eventPageUrl
string

URL of the event page

Array of objects

List of artists performing at the event

Array
artistName
string

Name of the artist

artistId
integer

ID of the artist

Response samples

Content type
application/json
[
  • {
    }
]

Event tariffs

Returns the ticket types for a specific event, including prices, areas, and other related information.

Authorizations:
Bearer
query Parameters
eventId
required
integer
Example: eventId=22189

Event ID for which the tariffs are being requested

forceAll
integer

Whether to return all tariffs, regardless of whether they are active or tickets are available. Possible values: 1 - yes, 0 - no (default).

header Parameters
Authorization
required
string
Example: Bearer 00000000058pG5D4vPSs34ba2bd62caf68a4855249841b5d56f4f

Authentication token returned by /login

Responses

Response Schema: application/json
Array of objects
Array
id
integer

Tariff ID

displayName
string

Name of the tariff (printed on the ticket)

price
number <float>

Sale price (can have a discount applied)

listPrice
number <float>

List price (informational, usually displayed as a crossed-out price)

currency
string

Currency for the price

minNrTickets
integer

Minimum number of tickets that can be purchased for this tariff

maxNrTickets
integer

Maximum number of tickets that can be purchased for this tariff

eventId
integer

Event ID

areas
Array of strings

Area codes that the tariff applies to

notice
string

Additional information related to the tariff

fiscalCodePrefix
string

Fiscal code prefix for tickets

Response samples

Content type
application/json
{
  • "tariffs": [
    ]
}

Tickets

Returns a paginated list of tickets for a specific event, including detailed ticket and customer information.

Authorizations:
Bearer
query Parameters
eventId
required
string
Example: eventId=22189

Event ID for which the tickets are being requested

orderDatetimeFrom
string <date-time>
Example: orderDatetimeFrom=2017-09-01 00:00:00

Filter tickets ordered from this date

orderDatetimeTo
string <date-time>
Example: orderDatetimeTo=2017-09-07 23:59:59

Filter tickets ordered up to this date

currentPage
integer
Default: 1
Example: currentPage=1

Current page (default is 1)

pageSize
integer
Default: 1000
Example: pageSize=1000

Page size (default is 1000)

header Parameters
Authorization
required
string
Example: Bearer 00000000058pG5D4vPSs34ba2bd62caf68a4855249841b5d56f4f

Authentication token returned by /login

Responses

Response Schema: application/json
Array of objects
Array
codeHash
string

MD5 hash of the ticket's barcode

scanCode
string

Ticket's barcode (if the API key has the rights to view it)

fiscalCode
string

Ticket's fiscal code

status
string
Enum: "booked" "cancelled" "cancelled_order" "blank"

Ticket status

orderDatetime
string <date-time>

Date and time of the ticket order

orderNr
string

Order number

eventId
integer

Event ID

seatCategoryId
integer

Seat category ID

seatCategoryName
string

Seat category name

tariffId
integer

Tariff ID

tariffName
string

Tariff name

areaCode
string

Area code

seatCode
string or null

Seat code (null if the ticket has no assigned seat)

seatLabel
string

Seat label or area name (if seatCode is null)

price
number <float>

Ticket price (0 for invitations)

currency
string

Ticket currency

isInvitation
boolean

Whether the ticket is an invitation

used
boolean

Whether the ticket has been validated

useDatetime
string <date-time>

Date and time of ticket validation (if validated)

object

Information about the customer

object

Pagination information

totalItemCount
integer

Total number of results

pageSize
integer

Page size

currentPage
integer

Current page

nextPage
integer or null

Next page (null if no more pages)

Response samples

Content type
application/json
{
  • "tickets": [
    ],
  • "pagination": {
    }
}

Event categories

Get a list of all event categories available in the system.

Authorizations:
Bearer
header Parameters
Authorization
required
string
Example: Bearer 00000000058pG5D4vPSs34ba2bd62caf68a4855249841b5d56f4f

Authentication token returned by /login

Responses

Response Schema: application/json
Array of objects
Array
code
string

Code for the category

displayName
string

Human-readable name for the category

Response samples

Content type
application/json
{
  • "categories": [
    ]
}

Artists

Returns a paginated list of artists.

Authorizations:
Bearer
query Parameters
currentPage
integer
Default: 1
Example: currentPage=1

Current page

pageSize
integer
Default: 1000
Example: pageSize=1000

Page size

header Parameters
Authorization
required
string
Example: Bearer 00000000058pG5D4vPSs34ba2bd62caf68a4855249841b5d56f4f

Authentication token returned by /login

Responses

Response Schema: application/json
Array of objects
Array
id
integer

The artist's ID

name
string

The artist's name

slug
string

The artist's slug

mainImageUrl
string or null

The artist's main image URL

object

Pagination information

totalItemCount
integer

Total number of results

pageSize
integer

Page size

currentPage
integer

Current page

nextPage
integer or null

Next page (null if no more pages)

Response samples

Content type
application/json
{
  • "artists": [
    ],
  • "pagination": {
    }
}

Placing orders

The process of placing an order involves three steps:

  1. /lockSeats This step involves locking the desired seats. This ensures the seats are not sold to another customer during the ordering process.

  2. /prepareOrder In this step, the order details are prepared, including the customer's information and payment details.

  3. /confirmOrder This is the final step where the order is confirmed and finalized. Once the order is confirmed, the tickets are generated.

It's important to follow these steps in order to successfully place an order.

Lock seats

Temporarily locks a set of seats for a predefined interval (5 minutes). Also unlocks any seats previously locked during the current session.

Authorizations:
Bearer
header Parameters
Authorization
required
string
Example: Bearer 00000000058pG5D4vPSs34ba2bd62caf68a4855249841b5d56f4f

Authentication token returned by /login

Request Body schema: application/json

Request to lock a set of seats

eventId
required
integer

Event ID for which seats are being locked

required
Array of objects

List of seats to lock with their tariff and seat details

Array
tariffId
integer

Tariff ID for the seat

seatAreaCode
string

Code of the seat area

ref
string

Client reference, must be unique within the order

price
number <float>

Price of the ticket (must match the value from the /eventTariffs call)

Responses

Response Schema: application/json
bookingRef
string

Booking reference obtained from the /lockSeats call

Array of objects

List of locked seats

Array
uuid
string

Unique identifier of the seat lock

status
string

Status of the seat (locked)

tariffId
integer

Tariff ID for the locked seat

hasSeat
boolean

Whether the seat is assigned

seatCode
string

Seat code (if available)

areaCode
string

Code of the seat area

ref
string

Client reference associated with the seat

object
totalBeforeModifiers
number <float>

Total before any price modifiers are applied

Array of objects

List of price modifiers (e.g., discounts, commissions)

Array
type
string

Type of the modifier (e.g., discount, commission)

label
string

Label for the modifier

value
number <float>

Value of the modifier (positive or negative)

totalPrice
number <float>

Total price after applying price modifiers

totalPriceCurrenty
string

Currency in which the total price is expressed

totalPaid
number <float>

Total amount paid after including any processing fees

totalPaidCurrency
string

Currency in which the total paid is expressed

Request samples

Content type
application/json
{
  • "eventId": 22189,
  • "seats": [
    ]
}

Response samples

Content type
application/json
{
  • "bookingRef": "347GXHB4EV",
  • "seats": [
    ],
  • "totals": {
    }
}

Prepare a ticket order

This endpoint prepares the order and verifies the total price.

Authorizations:
Bearer
header Parameters
Authorization
required
string
Example: Bearer 00000000058pG5D4vPSs34ba2bd62caf68a4855249841b5d56f4f

Authentication token returned by /login

Request Body schema: application/json

Request to prepare an order

bookingRef
required
string

Booking reference obtained from the /lockSeats call

totalPrice
required
number <float>

Total price of the order, used for verification

shippingMethod
string

Shipping method code for the order (optional)

paymentMethod
string

Payment method code for the order (optional)

object

Customer information (optional)

phone
string

Customer's phone number

email
string

Customer's email address

object

Custom fields for the order (optional)

object

Custom fields set at the order level

property name*
additional property
string
Array of objects

Custom fields set for each ticket in the order

Array
uuid
string

Identifier from the /lockSeats response

property name*
additional property
string

Responses

Response Schema: application/json
bookingRef
string

Booking reference obtained from the /lockSeats call

object
totalBeforeModifiers
number <float>

Total before any price modifiers are applied

Array of objects

List of price modifiers (e.g., discounts, commissions)

Array
type
string

Type of the modifier (e.g., discount, commission)

label
string

Label for the modifier

value
number <float>

Value of the modifier (positive or negative)

totalPrice
number <float>

Total price after applying price modifiers

totalPriceCurrenty
string

Currency in which the total price is expressed

totalPaid
number <float>

Total amount paid after including any processing fees

totalPaidCurrency
string

Currency in which the total paid is expressed

Request samples

Content type
application/json
{
  • "bookingRef": "347GXHB4EV",
  • "totalPrice": 215,
  • "shippingMethod": "Api",
  • "paymentMethod": "Api",
  • "customerInfo": {
    },
  • "customFields": {
    }
}

Response samples

Content type
application/json
{
  • "bookingRef": "347GXHB4EV",
  • "totals": {
    }
}

Confirm a ticket order and generate tickets

Confirms the order after it has been prepared. Only after calling confirmOrder will the tickets be generated and a PDF download link provided. If called multiple times for the same booking, only the first call will be successful.

Authorizations:
Bearer
header Parameters
Authorization
required
string
Example: Bearer 00000000058pG5D4vPSs34ba2bd62caf68a4855249841b5d56f4f

Authentication token returned by /login

Request Body schema: application/json

Request to confirm an order

bookingRef
required
string

Booking reference obtained from the /lockSeats call

paymentExtRef
string

Reference from the payment system (optional)

Responses

Response Schema: application/json
orderCode
string

Unique order code used for server-to-server calls (not shared with the client)

orderNr
string

Order number to be shared with the client, used by the call-center to identify the order

printUrl
string

URL to download the PDF with the tickets

Array of objects

List of tickets generated for the order

Array
code
string

Ticket barcode

fiscalCode
string

Fiscal code for the ticket

shortCode
string

Short code that can be used by the organizer to quickly identify the ticket in printed lists

eventTitle
string

Event title

venueName
string

Venue name

tariffName
string

Tariff name (the type of ticket purchased)

price
number <float>

Ticket price

currency
string

Currency for the ticket price

object
totalBeforeModifiers
number <float>

Total before any price modifiers are applied

Array of objects

List of price modifiers (e.g., discounts, commissions)

Array
type
string

Type of the modifier (e.g., discount, commission)

label
string

Label for the modifier

value
number <float>

Value of the modifier (positive or negative)

totalPrice
number <float>

Total price after applying price modifiers

totalPriceCurrenty
string

Currency in which the total price is expressed

totalPaid
number <float>

Total amount paid after including any processing fees

totalPaidCurrency
string

Currency in which the total paid is expressed

Request samples

Content type
application/json
{
  • "bookingRef": "347GXHB4EV",
  • "paymentExtRef": "hg948y76"
}

Response samples

Content type
application/json
{
  • "orderCode": "HROBREWLAI",
  • "orderNr": "171013032220",
  • "printUrl": "http://...",
  • "tickets": [
    ],
  • "totals": {
    }
}

Get current booking information

Returns information about the current booking, including event details, status, and locked seats.

Authorizations:
Bearer
query Parameters
bookingRef
required
string
Example: bookingRef=347GXHB4EV

Booking reference obtained from the /lockSeats call

header Parameters
Authorization
required
string
Example: Bearer 00000000058pG5D4vPSs34ba2bd62caf68a4855249841b5d56f4f

Authentication token returned by /login

Responses

Response Schema: application/json
eventId
integer

Event ID for the current booking

ref
string

Booking reference

eventTitle
string

Title of the event

status
string

Current status of the booking (e.g., locked, prepared, completed, cancelled, timeout)

seats
Array of objects

List of locked seats (refer to the response format of /lockSeats)

object
totalBeforeModifiers
number <float>

Total before any price modifiers are applied

Array of objects

List of price modifiers (e.g., discounts, commissions)

Array
type
string

Type of the modifier (e.g., discount, commission)

label
string

Label for the modifier

value
number <float>

Value of the modifier (positive or negative)

totalPrice
number <float>

Total price after applying price modifiers

totalPriceCurrenty
string

Currency in which the total price is expressed

totalPaid
number <float>

Total amount paid after including any processing fees

totalPaidCurrency
string

Currency in which the total paid is expressed

Response samples

Content type
application/json
{
  • "eventId": 22189,
  • "ref": "347GXHB4EV",
  • "eventTitle": "SMILEY in concert la Beraria H pe 6 noiembrie",
  • "status": "locked",
  • "seats": [
    ],
  • "totals": {
    }
}

Add a voucher to a booking

Adds a voucher to the booking specified by the booking reference.

Authorizations:
Bearer
header Parameters
Authorization
required
string
Example: Bearer 00000000058pG5D4vPSs34ba2bd62caf68a4855249841b5d56f4f

Authentication token returned by /login

Request Body schema: application/json

Request to add a voucher to a booking

bookingRef
required
string

Booking reference obtained from the /lockSeats call

voucherCode
required
string

The voucher code to apply to the booking

Responses

Response Schema: application/json
bookingRef
string

Booking reference for which the voucher was applied

object
totalBeforeModifiers
number <float>

Total before any price modifiers are applied

Array of objects

List of price modifiers (e.g., discounts, commissions)

Array
type
string

Type of the modifier (e.g., discount, commission)

label
string

Label for the modifier

value
number <float>

Value of the modifier (positive or negative)

totalPrice
number <float>

Total price after applying price modifiers

totalPriceCurrenty
string

Currency in which the total price is expressed

totalPaid
number <float>

Total amount paid after including any processing fees

totalPaidCurrency
string

Currency in which the total paid is expressed

Request samples

Content type
application/json
{
  • "bookingRef": "347GXHB4EV",
  • "voucherCode": "HIBIQA30"
}

Response samples

Content type
application/json
{
  • "bookingRef": "347GXHB4EV",
  • "totals": {
    }
}

Remove a voucher from a booking

Removes a voucher from the booking specified by the booking reference.

Authorizations:
Bearer
header Parameters
Authorization
required
string
Example: Bearer 00000000058pG5D4vPSs34ba2bd62caf68a4855249841b5d56f4f

Authentication token returned by /login

Request Body schema: application/json

Request to remove a voucher from a booking

bookingRef
required
string

Booking reference obtained from the /lockSeats call

voucherCode
required
string

The voucher code to be removed from the booking

Responses

Response Schema: application/json
success
boolean

Indicates whether the voucher was successfully removed

Request samples

Content type
application/json
{
  • "bookingRef": "347GXHB4EV",
  • "voucherCode": "HIBIQA30"
}

Response samples

Content type
application/json
{
  • "success": true
}

Unlock seats

Unlocks all seats that were locked during the current session. This is useful if the user goes back to the seat selection screen after locking seats.

Authorizations:
Bearer
header Parameters
Authorization
required
string
Example: Bearer 00000000058pG5D4vPSs34ba2bd62caf68a4855249841b5d56f4f

Authentication token returned by /login

Responses

Response Schema: application/json
success
boolean

Indicates whether the seats were successfully unlocked

Response samples

Content type
application/json
{
  • "success": true
}

Event access

Endpoints to verify if a ticket is valid for a specific event and to confirm that the ticket has not been previously used.

Validate a ticket for event access

Validates a ticket by its scan code for entry to the event. The response includes ticket details or an error if the ticket is invalid.

Authorizations:
Bearer
header Parameters
Authorization
required
string
Example: Bearer 00000000058pG5D4vPSs34ba2bd62caf68a4855249841b5d56f4f

Authentication token returned by /login

Request Body schema: application/json

Request to validate a ticket

eventId
required
string

ID of the event for which the ticket is being validated

scanCode
required
string

The scanned ticket code

Responses

Response Schema: application/json
status
string

Status of the validation (e.g., success, already_validated)

object

Details of the validated ticket

scanCode
string

Scanned code of the ticket

fiscalCode
string

Fiscal code of the ticket

fiscalCodePrefix
string

Prefix for the fiscal code

status
string
Enum: "booked" "cancelled" "cancelled_order" "blank"

Ticket status

orderDatetime
string <date-time>

The datetime of the ticket order

orderNr
string

The order number associated with the ticket

eventId
string

ID of the event the ticket is valid for

tariffName
string

Name of the ticket tariff

price
number <float>

Price of the ticket

currency
string

Currency of the ticket price

isInvitation
boolean

Whether the ticket is an invitation (free ticket)

used
boolean

Whether the ticket has been validated for access

useDatetime
string or null <date-time>

Datetime when the ticket was validated for access, null if the ticket was not validated

object

Information about the ticket holder

countryCode
string

Country code of the ticket holder

Request samples

Content type
application/json
{
  • "eventId": "22189",
  • "scanCode": "EB6TWEU2Y78A"
}

Response samples

Content type
application/json
{
  • "status": "success",
  • "ticket": {
    }
}