Create Booking - Plugixa Car Parking

POST /plugixa-car-parking/v1/bookings

Create a booking as staff: the plugin checks the dates, the opening hours and the free spaces, prices the stay, and stores the booking with its price lines.

The user needs the plugixa_carparking_create capability.

Note. This route applies the same date rules as the booking form. An entry in the past, or sooner than the minimum notice set in the settings, is refused with too_soon, and one further ahead than the booking window (365 days by default) with too_far. To record a stay that has already started, create it and then move its dates with Update Booking, which does not apply those two rules.

Request

POST https://your-site.example/wp-json/plugixa-car-parking/v1/bookings

Request body

Content type: application/json

payment_status and amount_paid cannot be sent: they are worked out from the payments, and a body that contains either is refused. Prices, totals and the currency are worked out by the plugin; values sent for them are ignored, and so are unknown fields.

When the booking is created with the pending status and the settings give pending bookings a hold time, hold_expires_at is set. A booking created with another status has no hold. If booking notifications are switched on, the booking-created messages are sent.

{
  "location_id": 3,
  "space_type_id": 2,
  "entry_datetime": "2026-12-01 08:00",
  "exit_datetime": "2026-12-04 08:00",
  "status": "confirmed",
  "customer_name": "Lucas Bernard",
  "customer_email": "lucas@example.com",
  "customer_phone": "+33 6 12 34 56 78",
  "license_plate": "AB-123-CD"
}

Responses

201 Created. data is the new booking.

{
  "success": true,
  "data": {
    "id": 57,
    "booking_ref": "PKG-3F9A1C",
    "language_code": null,
    "location_id": 3,
    "space_type_id": 2,
    "space_id": null,
    "booking_form_id": null,
    "user_id": null,
    "status": "confirmed",
    "billing_type": "day",
    "entry_datetime": "2026-12-01 08:00:00",
    "exit_datetime": "2026-12-04 08:00:00",
    "quantity": 1,
    "hold_expires_at": null,
    "license_plate": "AB-123-CD",
    "vehicle": null,
    "customer_name": "Lucas Bernard",
    "customer_email": "lucas@example.com",
    "customer_phone": "+33 6 12 34 56 78",
    "billing": null,
    "currency": "EUR",
    "subtotal": 37.5,
    "discount_total": 0,
    "tax_total": 0,
    "deposit_amount": 0,
    "total": 37.5,
    "amount_paid": 0,
    "coupon_id": null,
    "payment_method": "offline",
    "payment_status": "unpaid",
    "notes": null,
    "meta": null,
    "created_by": 1,
    "modified_by": 1,
    "created_at": "2026-11-12 09:30:00",
    "updated_at": null,
    "modified_at": "2026-11-12 09:30:00",
    "deleted_at": null,
    "items": [
      {
        "id": 91,
        "booking_id": 57,
        "type": "parking",
        "reference_id": 2,
        "label": "1 space × 3 days",
        "quantity": 3,
        "unit_price": 12.5,
        "total": 37.5,
        "tax_rate_id": null,
        "meta": null
      }
    ],
    "custom_fields": [],
    "location_name": "Airport North",
    "space_type_name": "Standard"
  }
}

See List Bookings for the other fields.

Errors

Plus the errors every endpoint can return.

Examples

curl -s -X POST "https://your-site.example/wp-json/plugixa-car-parking/v1/bookings" \
  -u "admin:$WP_APP_PASSWORD" \
  -H "Content-Type: application/json" \
  -d '{"location_id":3,"space_type_id":2,"entry_datetime":"2026-12-01 08:00","exit_datetime":"2026-12-04 08:00","status":"confirmed","customer_name":"Lucas Bernard","customer_email":"lucas@example.com","license_plate":"AB-123-CD"}'

<?php
$ch = curl_init('https://your-site.example/wp-json/plugixa-car-parking/v1/bookings');
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST  => 'POST',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_USERPWD        => 'admin:' . getenv('WP_APP_PASSWORD'),
    CURLOPT_HTTPHEADER     => ['Content-Type: application/json'],
    CURLOPT_POSTFIELDS     => json_encode([
        'location_id'    => 3,
        'space_type_id'  => 2,
        'entry_datetime' => '2026-12-01 08:00',
        'exit_datetime'  => '2026-12-04 08:00',
        'status'         => 'confirmed',
        'customer_name'  => 'Lucas Bernard',
        'customer_email' => 'lucas@example.com',
        'license_plate'  => 'AB-123-CD',
    ]),
]);
$response = json_decode(curl_exec($ch), true);
curl_close($ch);

const response = await fetch('https://your-site.example/wp-json/plugixa-car-parking/v1/bookings', {
  method: 'POST',
  headers: {
    'Authorization': 'Basic ' + btoa(`admin:${process.env.WP_APP_PASSWORD}`),
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    location_id: 3,
    space_type_id: 2,
    entry_datetime: '2026-12-01 08:00',
    exit_datetime: '2026-12-04 08:00',
    status: 'confirmed',
    customer_name: 'Lucas Bernard',
    customer_email: 'lucas@example.com',
    license_plate: 'AB-123-CD',
  }),
});
const { data } = await response.json();