List reservations

GET

https://api.ocpplab.io/booking/bookings

GET

/booking/bookings

import { OcpplabSDK } from "ocpplab";
async function main() {
    const client = new OcpplabSDK({
        token: "YOUR_TOKEN_HERE",
    });
    await client.booking.bookings.list({
        location_id: "LOC-AMS-01",
        reservation_status: "PENDING",
        limit: 50,
    });
}
main();

{
  "data": [
    {
      "id": 3001,
      "booking_id": "BOOK-2026-10-03-0001",
      "request_id": "REQ-2026-10-03-0001",
      "location_id": "LOC-AMS-01",
      "period": {
        "start_date_time": "2026-10-03T12:00:00Z",
        "end_date_time": "2026-10-03T13:00:00Z"
      },
      "reservation_status": "PENDING",
      "authorization_reference": "AUTH-7f3c9a",
      "booking_terms": {
        "early_start": 10
      },
      "booking_requests": [
        {
          "request_id": "REQ-2026-10-03-0001"
        }
      ],
      "last_updated": "2026-10-03T10:00:00Z",
      "role": "CPO",
      "origin": "LOCAL",
      "organization_id": "550e8400-e29b-41d4-a716-446655440000",
      "country_code": "NL",
      "party_id": "OCP",
      "ocpi_version": "2.3.0",
      "created_at": "2026-10-03T10:00:00Z",
      "updated_at": "2026-10-03T10:00:00Z",
      "booking_tokens": [
        {
          "uid": "04A2B3C4D5E6F7",
          "type": "RFID",
          "contract_id": "NL-OCP-C12345678-X"
        }
      ],
      "tariff_ids": [
        "TARIFF-AC-STD"
      ],
      "access_information": [
        {
          "text": "Barrier opens with your charge card."
        }
      ]
    }
  ],
  "pagination": {
    "has_next": false,
    "end_cursor": "3001"
  }
}

Your reservations, lowest id first, optionally filtered by location, party, role, origin or status. Pass pagination.end_cursor as after to read the next page.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Query parameters

afterstring or nullOptionalformat: "^[0-9]+$"1-20 characters

Cursor: the previous page’s pagination.end_cursor. Omit it for the first page.

limitintegerOptional1-200Defaults to 50

Maximum rows per page (default 50, max 200).

location_idstring or nullOptional1-36 characters

Only rows for this OCPI location.

country_codestring or nullOptionalformat: "^[A-Za-z]{2}$"=2 characters

Only rows of this OCPI party country code, e.g. NL (case-insensitive).

party_idstring or nullOptionalformat: "^[A-Za-z]{3}$"=3 characters

Only rows of this OCPI party id, e.g. OCP (case-insensitive).

roleenum or nullOptional

Only rows with this OCPI role, e.g. CPO or EMSP.

originenum or nullOptional

LOCAL rows are yours; REMOTE rows came from a roaming partner.

Allowed values:

reservation_statusenum or nullOptional

Only reservations in this lifecycle status.

Response

One page of reservations, lowest id first; pagination.has_next says whether another page follows.

datalist of objects

paginationobject

Cursor page. Pass end_cursor as the next after value.

Errors

400

Bad Request Error

401

Unauthorized Error

422

Unprocessable Entity Error

429

Too Many Requests Error

502

Bad Gateway Error

504

Gateway Timeout Error