moovexDocs

Get reservations

Returns paginated reservations table data. Times are unix seconds; distances are in kilometers.

GET/reservations

Query Parameters

ParameterTypeRequiredDescription
sortstringNoSort by field:asc/desc Allowed: asc, desc
fromDatenumberNoStart date filter (unix seconds)
toDatenumberNoEnd date filter (unix seconds)
suppliersstring[]NoSupplier ids filter
profilesstring[]NoProfile ids filter
statusstring[]NoReservation statuses filter
groupIdstringNoGroup id filter
waitAndReturnIdstringNoWait-and-return id filter
attributesstring[]NoAttribute ids filter
driversstring[]NoDriver ids filter
vehiclesstring[]NoVehicle ids filter
fromstring[]NoSearch by origin names
tostring[]NoSearch by destination names
isGroupedbooleanNoFilter grouped reservations only
isWaitAndReturnbooleanNoFilter wait-and-return reservations
isRoundTripbooleanNoFilter round-trip reservations
isDropDatebooleanNoFilter drop-date based reservations
areasstring[]NoArea ids filter
limitnumberYes-
pagenumberYes-
searchstringNo-

Example Response

{
  "page": 1,
  "limit": 20,
  "totalPages": 1,
  "totalResults": 2,
  "records": [
    {
      "id": 101,
      "type": "normal",
      "date": 1700000000,
      "dateType": "pick",
      "status": "new",
      "fromAddress": {
        "name": "Airport",
        "lat": 32,
        "lng": 34.8
      },
      "toAddress": {
        "name": "Hotel",
        "lat": 32.08,
        "lng": 34.78
      },
      "seats": 1,
      "attributes": [
        "Wheelchair"
      ],
      "supplierId": 2,
      "serviceId": 5,
      "tripId": 5001,
      "profile": "Corporate",
      "email": "passenger@example.com",
      "phone": "+15551234567",
      "passengerLabel": "John Doe",
      "externalId": "RES-101",
      "inAndOut": 0,
      "roundTrip": false,
      "extendUntilDate": 1700000600,
      "tags": [
        {
          "key": "priority",
          "value": "medical"
        }
      ],
      "labels": [
        {
          "key": "category",
          "value": "vip",
          "type": "important"
        }
      ],
      "areas": [
        "Center"
      ],
      "distance": 14.2,
      "duration": 900,
      "price": 45.75
    },
    {
      "id": 102,
      "type": "shuttle",
      "date": 1700010000,
      "dateType": "pick",
      "status": "canceled",
      "fromAddress": {
        "name": "Stop A",
        "lat": 32.1,
        "lng": 34.82
      },
      "toAddress": {
        "name": "Stop B",
        "lat": 32.11,
        "lng": 34.83
      },
      "seats": 2,
      "attributes": [],
      "email": "jane@example.com",
      "phone": "+15559876543",
      "shuttleLine": "Blue",
      "shuttleDirection": "eastbound",
      "shuttleProfile": "Morning",
      "areas": [
        "North"
      ]
    }
  ]
}

On this page