Introduction
Liigu API is designed for third parties who want to integrate Liigu's features with their system. Liigu API uses GraphQL.
If you are new to GraphQL, take some time to learn about it from here.
The API supports the following flows:
- Partial booking process where rates are shown on a third party website and the customer is redirected to Liigu's website
- Full booking process where rates are shown on a third party website and the booking is also created on the third party website
API Explorer
You can try out queries and mutation with our API Explorer.
Making requests
Liigu API can be accessed over HTTPS. You can use any HTTP library or any GraphQL client to make a request.
Endpoints
All requests go to a single endpoint:
https://api.liigu.me/graphql
Production and Sandbox use the same endpoint with different credentials.
Authentication
Authentication is performed via HTTP basic authentication:
curl -u "username:password" https://api.liigu.me/graphql
Content-type header
Content type of the query must be application/json.
Message body
Message body must be a JSON object with query and variables if applicable.
The value for the query must be a single string containing a well-formatted GraphQL document. You can also reference variables.
{
"query": "query { ping(ping: $message) }",
"variables": {
"message": "this is text variable"
}
}
Example request
Here is an example query:
GraphQL query
query {
ping(ping: "echo") {
pong
}
}
JSON Object
{
"query": "query { ping(ping:\"echo\") { pong }}"
}
CURL
curl -u "username:password" -H "Content-Type: application/json" -X POST https://api.liigu.me/graphql -d '{"query": "query { ping(ping:\"echo\") { pong }}"}'
Response
{
"data": {
"ping": {
"pong": "echo"
}
}
}
Error handling
Unlike REST API, GraphQL does not rely on HTTP status codes. Liigu API always returns a JSON body and the status code is always 200.
If an error occurs, the response body will include a top level errors array that describes the error.
For example, if there is a problem with your credentials, the following is returned:
Response
{
"errors": [
{
"message": "Context creation failed: Failed to authenticate, please try again later!",
"extensions": {
"code": "UNAUTHENTICATED"
}
}
]
}
Pagination
If pagination is supported in the response, the response objects are wrapped in the following object:
{
"branches": {
"edges": [],
"pageInfo": {
"hasNextPage": true,
"endCursor": "AYEBCg"
}
}
}
To retrieve the next set of items, you can add the argument after and set its value to endCursor.
query {
branches(after: "AYEBCg") {
...
}
}
Branches
To retrieve available rates by using Availability, you need to know which branches (locations) are available.
It is good practice to synchronise the branches database at least once a week.
Every branch has a unique id that can be used to retrieve the list of available rates in that branch.
GraphQL query
query {
branches {
edges {
node {
id
location {
name
}
}
}
pageInfo {
hasNextPage
endCursor
}
}
}
Response
{
"data": {
"branches": {
"edges": [
{
"node": {
"id": "NCE",
"location": {
"name": "Nice Airport"
}
}
},
{
"node": {
"id": "OPO",
"location": {
"name": "Porto Airport"
}
}
}
],
"pageInfo": {
"hasNextPage": true,
"endCursor": "AYEBCg"
}
}
}
}
Check our API Explorer for full specifications.
Retrieving available rates and redirecting customers to Liigu's website
To redirect a customer to Liigu's website, Liigu API returns a deep link to the offer the customer selected.
GraphQL query
query {
availability(
input: {
pickUpBranchId: "NCE"
pickUpBranchDateTime: "2026-01-05T12:00:00"
dropOffBranchId: "NCE"
dropOffBranchDateTime: "2026-01-11T16:45:00"
residenceCountryCode: "US"
driverAge: 30
}
) {
rates {
vehicle {
code
model
}
packages {
deepLink
payments {
total {
amount
currency
}
}
}
}
}
}
Response
{
"data": {
"availability": {
"rates": [
{
"vehicle": {
"code": "CWAR",
"model": "Opel/Vauxhall Astra Sports Tourer"
},
"packages": [
{
"deepLink": "https://liigu.me/en-us/results?offer=1",
"payments": {
"total": {
"amount": "449.78",
"currency": "EUR"
}
}
}
]
},
{
"vehicle": {
"code": "IDAR",
"model": "Renault Megane"
},
"packages": [
{
"deepLink": "https://liigu.me/en-us/results?offer=2",
"payments": {
"total": {
"amount": "491.04",
"currency": "EUR"
}
}
}
]
}
]
}
}
}
Retrieving available rates and making a booking
Every package in an availability response has a rate reference. Rate reference can be used to make a booking.
Availability
GraphQL query
query {
availability(
input: {
pickUpBranchId: "NCE"
pickUpBranchDateTime: "2026-01-05T12:00:00"
dropOffBranchId: "NCE"
dropOffBranchDateTime: "2026-01-11T16:45:00"
residenceCountryCode: "US"
driverAge: 30
}
) {
rates {
vehicle {
code
model
}
packages {
rateReference
payments {
total {
amount
currency
}
}
}
}
}
}
Response
{
"data": {
"availability": {
"rates": [
{
"vehicle": {
"code": "CWAR",
"model": "Opel/Vauxhall Astra Sports Tourer"
},
"packages": [
{
"rateReference": "7_O_Jwn0-WTOBU8zQ9rsaqmJYZ1y7feH5ebv6x",
"payments": {
"total": {
"amount": "449.78",
"currency": "EUR"
}
}
}
]
},
{
"vehicle": {
"code": "IDAR",
"model": "Renault Megane"
},
"packages": [
{
"rateReference": "7_O6T-baV7fKk0s9TX3PrOjae9j9xPnbWqa8",
"payments": {
"total": {
"amount": "491.04",
"currency": "EUR"
}
}
}
]
}
]
}
}
}
Booking
To make a booking, you need to pass the rate reference from the availability response. It is also good practice to send your own unique reference which can be used to link Liigu's booking to your booking.
GraphQL query
mutation {
createBooking(
input: {
rateReference: "7_O_Jwn0-WTOBU8zQ9rsaqmJYZ1y7feH5ebv6x"
externalReference: "your-unique-reference-for-this-booking"
customer: {
firstName: "John"
lastName: "Smith"
email: "support@liigu.me"
birthDate: "1998-05-21"
phone: "+447818005232"
countryCode: "GB"
city: "London"
address: "51 Liigu Road"
postalCode: "W54 0XP"
languageCode: "en-gb"
}
flightNumber: "BA1476"
extras: [{ code: "7", quantity: 2 }]
}
) {
booking {
id
}
}
}
Response
{
"data": {
"booking": {
"id": 57483948
}
}
}
