Booking API

A booking is a type of permit that is anonymous and not visible to existing clients in autopay.io. It is tied to the vehicle. Typical usage for a booking is providing paid parking for a hotel guests who does not wish to go through the sign up procedure.

Available resources

• GET - get a list of permit definitions that can be used to create a booking
• GET - get a status of a booking
• GET - get booking's availability
• POST - request a booking for a vehicle
• PUT - update an existing booking
• DELETE - delete a booking
• Error handling

Access requirements

• A valid authentication token is required to access the API. How to authenticate your application.
• Access to the Booking API is offered as a paid service. Please contact your Autopay representative for details.
• There is a 15-minute query rate limit per booking on the GET Get a status of a booking endpoint.

GET Get a status of a booking

To see the restrictions applied to change a booking, please see PUT - update an existing booking.

This method allows you to retrieve a status of a booking to see if it exists and whether it has been used. There are four different statuses:

Endpoint

GET https://api.autopay.io/booking/v2/{id}/status

Request parameters

• The HTTP headers must include a valid access token with scope: permit_booking.

Success response

HTTP Code: 200 OK

Example success response

    
    {
        "status": "USED"
    }
    
    

GET Get a list of permit definitions

This method allows you to retrieve a list of permit definitions that can be used to create a booking. Permit definitions are managed by Autopay operators.

Endpoint

GET https://api.autopay.io/booking/v2/permit_definitions

Request parameters

• The HTTP headers must include a valid access token with scope: permit_booking.

Success response

HTTP Code: 200 OK

Example success response

[
    {
        "id": 17,
        "name": "Hotel guest parking in zone 215",
        "tenantName": "Example tenant",
        "accessLimit": null
    },
    {
        "id": 7,
        "name": "Airport - Online booking",
        "tenantName": "Example tenant",
        "accessLimit": {
            "mon": 1,
            "tue": 1,
            "wed": 1,
            "thu": 2,
            "fri": 1,
            "sat": 1,
            "sun": 1
        }
    }
]

GET Get booking's availability

This method allows you to retrieve available booking limit and it's validity period, if there is no available limit then it returns the time when there is one.

Endpoint

GET https://api.autopay.io/booking/v2/products/availability/validFrom/{validFrom}

Request parameters

• The HTTP headers must include a valid access token with scope: permit_booking.
• The request path must include valid from datetime in ISO 8601 format.

Success response

HTTP Code: 200 OK

Example success response

    
    {
    "available": true,
    "limitAmount": 5,
    "validFrom": "2021-11-17T13:00:00+02:00",
    "validTo": "2021-11-18T13:00:00+02:00"
    }
    
    

POST Request a booking

This method allows you request a booking for a vehicle. A booking can start and end at a specific time (fixed booking) or be relative to when the vehicle enters the parking venue (entry booking). Both types can be applied wither beforehand or when the parking is already in progress.

Endpoint

POST https://api.autopay.io/booking/v2

Request parameters

• The request body must be in JSON format and HTTP headers must include Content-Type: application/json.
• The HTTP headers must include a valid access token with scope: permit_booking.

Example request

{
    "type": "FIXED",
    "validFrom": "2017-12-23T12:05:56.833Z",
    "validTo": "2017-12-30T12:05:56.833Z",
    "duration": null,
    "licencePlate": "123ABC",
    "permitDefinitionId": 17,
    "payment": {
        "amount": 370,
        "currency": "NOK"
    },
    "customer": {
        "email": "test@test.com",
        "mobile": "+47123456"
    },
    "travelInformation": {
        "flightId": "AB123"
    }
}

Success response

HTTP Code: 200 OK

Example success response

{
    "bookingId": "123456",
    "type": "FIXED",
    "validFrom": "2017-12-23T12:05:56+0000",
    "validTo": "2017-12-30T12:05:56+0000",
    "licencePlate": "123ABC",
    "permitDefinitionId": 17,
    "usableOnce": false
}

PUT Update an existing booking

This method allows you to edit booking information. The following restrictions are applied when changing a booking:

• One cannot change a booking’s id, type, or anonymous flag.
• The valid from time and license plate number cannot be changed when the booking is in use (status IN_USE).
• Bookings with statuses USED and EXPIRED cannot be changed.

Endpoint

PUT https://api.autopay.io/booking/v2/{id}

Request parameters

• The request body must be in JSON format and HTTP headers must include Content-Type: application/json.
• The HTTP headers must include a valid access token with scope: permit_booking.
• The request path must include permit id.

Example request

{
    "type": "FIXED",
    "validFrom": "2017-12-23T12:05:56.833Z",
    "validTo": "2017-12-30T12:05:56.833Z",
    "duration": null,
    "licencePlate": "123ABC",
    "permitDefinitionId": 32,
    "payment": {
        "amount": 370,
        "currency": "NOK"
    },
    "customer": {
        "email": "test@test.com",
        "mobile": "+47123456"
    },
    "travelInformation": {
        "flightId": "AB123"
    }
}

Success response

HTTP Code: 200 OK

Example success response

    
    {
    "bookingId": "123456",
    "type": "FIXED",
    "validFrom": "2017-12-23T12:05:56+0000",
    "validTo": "2017-12-30T12:05:56+0000",
    "licencePlate": "123ABC",
    "permitDefinitionId": 17,
    "usableOnce": false
    }
    
    

DELETE Delete booking

This method allows you to delete end-users booking. Only unused bookings can be deleted.

Endpoint

DELETE https://api.autopay.io/booking/v2/{id}

Request parameters

• The HTTP headers must include a valid access token with scope: permit_booking.
• The request path must include permit id.

Request example

DELETE https://api.autopay.io/booking/v2/6648392

Success response

HTTP Code: 200 OK

Error messages

Example error response

    
    {
        "error_id": "authentication_error",
        "message": "No access token present in header!"
    }
    
    

Possible error IDs

Migration guide

Migration from V1 to V2 (current version) and version differences

• GET v2/permit_definitions
  • renamed from v1/products
• POST /v2
  • renamed from /v1/permit
  • renamed response parameter productId to permitDefinitionId
  • added optional anonymous_booking parameter to request and booking_activation_code to response if that parameter is true
• PUT /v2/{permitId}
  • renamed from /v1/permit/{permitId]
  • renamed response parameter productId to permitDefinitionId
• Error handling
  • error_id (string) is returned instead of error_code (integer)