Créer une location

curl --request POST \
  --url https://api.lexio.rent/api/external/v1/rentals \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'Idempotency-Key: <idempotency-key>' \
  --data '
{
  "vehicleId": "3b1f5c2a-8d4e-4f6a-9b7c-2e5d8a1f4c63",
  "startAt": "2026-11-10T10:00",
  "endAt": "2026-11-15T10:00",
  "deductibleId": "2c3d4e5f-6a7b-4c8d-9e0f-1a2b3c4d5e6f",
  "options": [
    {
      "optionId": "6a7b8c9d-0e1f-4a2b-9c3d-5e6f70819203",
      "quantity": 1
    }
  ],
  "customer": {
    "firstName": "Marie",
    "lastName": "Martin",
    "email": "marie.martin@example.com",
    "phone": "+33612345678"
  },
  "partnerReference": "AV-884213",
  "pickupLocation": {
    "locationId": "c41a9e3b-2d55-4b0f-8c11-0f3a7d6e9b42"
  },
  "returnLocation": {
    "name": "Hôtel Negresco",
    "address": "37 promenade des Anglais, 06000 Nice"
  },
  "notes": "Siège enfant à installer avant la remise."
}
'

const options = {
  method: 'POST',
  headers: {
    'Idempotency-Key': '<idempotency-key>',
    Authorization: 'Bearer <token>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    vehicleId: '3b1f5c2a-8d4e-4f6a-9b7c-2e5d8a1f4c63',
    startAt: '2026-11-10T10:00',
    endAt: '2026-11-15T10:00',
    deductibleId: '2c3d4e5f-6a7b-4c8d-9e0f-1a2b3c4d5e6f',
    options: [{optionId: '6a7b8c9d-0e1f-4a2b-9c3d-5e6f70819203', quantity: 1}],
    customer: {
      firstName: 'Marie',
      lastName: 'Martin',
      email: 'marie.martin@example.com',
      phone: '+33612345678'
    },
    partnerReference: 'AV-884213',
    pickupLocation: {locationId: 'c41a9e3b-2d55-4b0f-8c11-0f3a7d6e9b42'},
    returnLocation: {name: 'Hôtel Negresco', address: '37 promenade des Anglais, 06000 Nice'},
    notes: 'Siège enfant à installer avant la remise.'
  })
};

fetch('https://api.lexio.rent/api/external/v1/rentals', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://api.lexio.rent/api/external/v1/rentals"

payload = {
    "vehicleId": "3b1f5c2a-8d4e-4f6a-9b7c-2e5d8a1f4c63",
    "startAt": "2026-11-10T10:00",
    "endAt": "2026-11-15T10:00",
    "deductibleId": "2c3d4e5f-6a7b-4c8d-9e0f-1a2b3c4d5e6f",
    "options": [
        {
            "optionId": "6a7b8c9d-0e1f-4a2b-9c3d-5e6f70819203",
            "quantity": 1
        }
    ],
    "customer": {
        "firstName": "Marie",
        "lastName": "Martin",
        "email": "marie.martin@example.com",
        "phone": "+33612345678"
    },
    "partnerReference": "AV-884213",
    "pickupLocation": { "locationId": "c41a9e3b-2d55-4b0f-8c11-0f3a7d6e9b42" },
    "returnLocation": {
        "name": "Hôtel Negresco",
        "address": "37 promenade des Anglais, 06000 Nice"
    },
    "notes": "Siège enfant à installer avant la remise."
}
headers = {
    "Idempotency-Key": "<idempotency-key>",
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.lexio.rent/api/external/v1/rentals",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'vehicleId' => '3b1f5c2a-8d4e-4f6a-9b7c-2e5d8a1f4c63',
    'startAt' => '2026-11-10T10:00',
    'endAt' => '2026-11-15T10:00',
    'deductibleId' => '2c3d4e5f-6a7b-4c8d-9e0f-1a2b3c4d5e6f',
    'options' => [
        [
                'optionId' => '6a7b8c9d-0e1f-4a2b-9c3d-5e6f70819203',
                'quantity' => 1
        ]
    ],
    'customer' => [
        'firstName' => 'Marie',
        'lastName' => 'Martin',
        'email' => 'marie.martin@example.com',
        'phone' => '+33612345678'
    ],
    'partnerReference' => 'AV-884213',
    'pickupLocation' => [
        'locationId' => 'c41a9e3b-2d55-4b0f-8c11-0f3a7d6e9b42'
    ],
    'returnLocation' => [
        'name' => 'Hôtel Negresco',
        'address' => '37 promenade des Anglais, 06000 Nice'
    ],
    'notes' => 'Siège enfant à installer avant la remise.'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json",
    "Idempotency-Key: <idempotency-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

{
  "data": {
    "id": "9c2d7e4a-5b1f-4d3c-8a6e-0f1b2c3d4e5f",
    "number": "LOC-2026.11-0042",
    "status": "RESERVED",
    "source": "PARTNER",
    "partnerCode": "azur-voyages",
    "partnerReference": "AV-884213",
    "period": {
      "startAt": "2026-11-10T10:00:00+01:00",
      "endAt": "2026-11-15T10:00:00+01:00",
      "timezone": "Europe/Paris",
      "billedDays": 5,
      "durationMinutes": 7200
    },
    "actualStartAt": null,
    "actualEndAt": null,
    "vehicle": {
      "id": "3b1f5c2a-8d4e-4f6a-9b7c-2e5d8a1f4c63",
      "name": "208 Allure",
      "brand": "Peugeot",
      "model": "208",
      "vehicleType": "CITY",
      "plate": "AB-123-CD",
      "serialNumber": null
    },
    "customer": {
      "id": "7c4e2b9a-1f3d-4a6e-8b5c-9d0e1f2a3b4c",
      "isCompany": false,
      "firstName": "Marie",
      "lastName": "Martin",
      "companyName": null,
      "email": "marie.martin@example.com",
      "phone": "+33612345678"
    },
    "pickupLocation": {
      "locationId": "c41a9e3b-2d55-4b0f-8c11-0f3a7d6e9b42",
      "name": "Agence Nice Gare",
      "address": "12 avenue Thiers, 06000 Nice"
    },
    "returnLocation": {
      "locationId": null,
      "name": "Hôtel Negresco",
      "address": "37 promenade des Anglais, 06000 Nice"
    },
    "mileage": {
      "mileagePackageId": "5b7c9d1e-2f3a-4b5c-8d6e-7f8091a2b3c4",
      "name": "200 km/jour",
      "isUnlimited": false,
      "includedKm": 1000,
      "overageRatePerKmHT": 0.25
    },
    "deductible": {
      "deductibleId": "2c3d4e5f-6a7b-4c8d-9e0f-1a2b3c4d5e6f",
      "name": "Franchise réduite",
      "description": "Reste à charge réduit en cas de sinistre.",
      "excessAmount": 500
    },
    "deposit": {
      "depositId": "4e5f6a7b-8c9d-4e0f-9a1b-3c4d5e6f7081",
      "name": "Caution citadine",
      "depositAmount": 800
    },
    "options": [
      {
        "optionId": "6a7b8c9d-0e1f-4a2b-9c3d-5e6f70819203",
        "name": "Siège enfant",
        "kind": "STANDARD",
        "quantity": 1
      }
    ],
    "lines": [
      {
        "key": "BASE",
        "label": "Tarif de base",
        "refId": null,
        "quantity": 1,
        "unitPriceHT": 210,
        "unitPriceTTC": 252,
        "amountHT": 210,
        "amountTTC": 252,
        "ratePercent": null
      },
      {
        "key": "DURATION_DISCOUNT",
        "label": "Réduction durée 5 jours",
        "refId": null,
        "quantity": 1,
        "unitPriceHT": -10.5,
        "unitPriceTTC": -12.6,
        "amountHT": -10.5,
        "amountTTC": -12.6,
        "ratePercent": 5
      },
      {
        "key": "MILEAGE",
        "label": "Forfait 200 km/jour",
        "refId": null,
        "quantity": 1,
        "unitPriceHT": 0,
        "unitPriceTTC": 0,
        "amountHT": 0,
        "amountTTC": 0,
        "ratePercent": null
      },
      {
        "key": "DEDUCTIBLE",
        "label": "Franchise réduite",
        "refId": null,
        "quantity": 1,
        "unitPriceHT": 37.5,
        "unitPriceTTC": 45,
        "amountHT": 37.5,
        "amountTTC": 45,
        "ratePercent": null
      },
      {
        "key": "OPTION",
        "label": "Siège enfant",
        "refId": "6a7b8c9d-0e1f-4a2b-9c3d-5e6f70819203",
        "quantity": 1,
        "unitPriceHT": 20,
        "unitPriceTTC": 24,
        "amountHT": 20,
        "amountTTC": 24,
        "ratePercent": null
      }
    ],
    "promoCode": null,
    "currency": "EUR",
    "vatPercent": 20,
    "isVatReverseCharge": false,
    "totalHT": 257,
    "vatAmount": 51.4,
    "totalTTC": 308.4,
    "balance": {
      "totalTTC": 308.4,
      "paidAmount": 0,
      "dueAmount": 308.4,
      "overpaidAmount": 0
    },
    "notes": "Siège enfant à installer avant la remise.",
    "createdAt": "2026-11-02T09:15:02+01:00",
    "updatedAt": "2026-11-02T09:15:02+01:00"
  },
  "effects": {
    "customerResolution": "CREATED"
  }
}

{
  "type": "https://api.lexio.rent/errors/malformed-request",
  "title": "Corps de requête illisible",
  "status": 400,
  "code": "MALFORMED_REQUEST",
  "detail": "<string>",
  "instance": "<string>",
  "requestId": "<string>"
}

{
  "type": "https://api.lexio.rent/errors/api-key-disabled",
  "title": "Clé API désactivée",
  "status": 401,
  "code": "API_KEY_DISABLED",
  "detail": "<string>",
  "instance": "<string>",
  "requestId": "<string>"
}

{
  "type": "https://api.lexio.rent/errors/feature-not-available",
  "title": "Fonctionnalité non incluse",
  "status": 403,
  "code": "FEATURE_NOT_AVAILABLE",
  "detail": "<string>",
  "instance": "<string>",
  "requestId": "<string>",
  "feature": "<string>"
}

{
  "type": "https://api.lexio.rent/errors/already-exists",
  "title": "Doublon",
  "status": 409,
  "code": "ALREADY_EXISTS",
  "detail": "<string>",
  "instance": "<string>",
  "requestId": "<string>",
  "field": "<string>",
  "conflictingId": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}

{
  "type": "https://api.lexio.rent/errors/payload-too-large",
  "title": "Corps trop volumineux",
  "status": 413,
  "code": "PAYLOAD_TOO_LARGE",
  "detail": "<string>",
  "instance": "<string>",
  "requestId": "<string>",
  "maxBytes": 2
}

{
  "type": "https://api.lexio.rent/errors/unsupported-media-type",
  "title": "Type de contenu non pris en charge",
  "status": 415,
  "code": "UNSUPPORTED_MEDIA_TYPE",
  "detail": "<string>",
  "instance": "<string>",
  "requestId": "<string>",
  "accepted": [
    "<string>"
  ]
}

{
  "type": "https://api.lexio.rent/errors/booking-rule-violation",
  "title": "Règle de réservation non respectée",
  "status": 422,
  "code": "BOOKING_RULE_VIOLATION",
  "detail": "<string>",
  "instance": "<string>",
  "requestId": "<string>",
  "errors": [
    {
      "pointer": "<string>",
      "code": "required",
      "detail": "<string>"
    }
  ],
  "rule": "LEAD_TIME"
}

{
  "type": "https://api.lexio.rent/errors/rate-limited",
  "title": "Trop de requêtes",
  "status": 429,
  "code": "RATE_LIMITED",
  "detail": "<string>",
  "instance": "<string>",
  "requestId": "<string>",
  "limit": "PRE_AUTH",
  "windowSeconds": 2,
  "retryAfter": 1
}

{
  "type": "https://api.lexio.rent/errors/internal-error",
  "title": "Erreur interne",
  "status": 500,
  "code": "INTERNAL_ERROR",
  "detail": "<string>",
  "instance": "<string>",
  "requestId": "<string>"
}

Locations

Créer une location

Accès : rentals.write

Crée une location RESERVED (tout ou rien), au prix d’un devis (quoteId) ou au prix du moment.

Obligatoire : customerId (clé interne) ou customer, jamais les deux ; puis quoteId seul, ou vehicleId, startAt, endAt avec les règles et défauts de POST /quotes. Un customer déjà connu n’est complété que sur ses champs vides.

Refus (sans devis, s’ajoutent ceux de POST /quotes)

REFERENCE_NOT_FOUND : devis inconnu.
QUOTE_ALREADY_USED, QUOTE_EXPIRED : devis déjà utilisé ; expiré ou départ passé.
PRICE_CHANGED : prix plus garanti.
CUSTOMER_BLOCKED (clé interne), BOOKING_REFUSED (clé partenaire) : titulaire bloqué.
DRIVER_AGE_MISMATCH (clé partenaire) : âge contraire à la majoration jeune conducteur du devis.
ALREADY_EXISTS : partnerReference déjà utilisée.
VEHICLE_UNAVAILABLE, OPTION_UNAVAILABLE : véhicule ou stock d’option indisponible, même avec un devis.
400 not_applicable : entrée de prix avec quoteId ; clé partenaire avec customerId, charges, isVatReverseCharge, internalNotes ou une source autre que PARTNER.

Effets : PDF de confirmation, alerte au loueur ; email au client si l’organisation l’a activé (clé interne seulement).

POST

rentals

Créer une location

curl --request POST \
  --url https://api.lexio.rent/api/external/v1/rentals \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'Idempotency-Key: <idempotency-key>' \
  --data '
{
  "vehicleId": "3b1f5c2a-8d4e-4f6a-9b7c-2e5d8a1f4c63",
  "startAt": "2026-11-10T10:00",
  "endAt": "2026-11-15T10:00",
  "deductibleId": "2c3d4e5f-6a7b-4c8d-9e0f-1a2b3c4d5e6f",
  "options": [
    {
      "optionId": "6a7b8c9d-0e1f-4a2b-9c3d-5e6f70819203",
      "quantity": 1
    }
  ],
  "customer": {
    "firstName": "Marie",
    "lastName": "Martin",
    "email": "marie.martin@example.com",
    "phone": "+33612345678"
  },
  "partnerReference": "AV-884213",
  "pickupLocation": {
    "locationId": "c41a9e3b-2d55-4b0f-8c11-0f3a7d6e9b42"
  },
  "returnLocation": {
    "name": "Hôtel Negresco",
    "address": "37 promenade des Anglais, 06000 Nice"
  },
  "notes": "Siège enfant à installer avant la remise."
}
'

const options = {
  method: 'POST',
  headers: {
    'Idempotency-Key': '<idempotency-key>',
    Authorization: 'Bearer <token>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    vehicleId: '3b1f5c2a-8d4e-4f6a-9b7c-2e5d8a1f4c63',
    startAt: '2026-11-10T10:00',
    endAt: '2026-11-15T10:00',
    deductibleId: '2c3d4e5f-6a7b-4c8d-9e0f-1a2b3c4d5e6f',
    options: [{optionId: '6a7b8c9d-0e1f-4a2b-9c3d-5e6f70819203', quantity: 1}],
    customer: {
      firstName: 'Marie',
      lastName: 'Martin',
      email: 'marie.martin@example.com',
      phone: '+33612345678'
    },
    partnerReference: 'AV-884213',
    pickupLocation: {locationId: 'c41a9e3b-2d55-4b0f-8c11-0f3a7d6e9b42'},
    returnLocation: {name: 'Hôtel Negresco', address: '37 promenade des Anglais, 06000 Nice'},
    notes: 'Siège enfant à installer avant la remise.'
  })
};

fetch('https://api.lexio.rent/api/external/v1/rentals', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://api.lexio.rent/api/external/v1/rentals"

payload = {
    "vehicleId": "3b1f5c2a-8d4e-4f6a-9b7c-2e5d8a1f4c63",
    "startAt": "2026-11-10T10:00",
    "endAt": "2026-11-15T10:00",
    "deductibleId": "2c3d4e5f-6a7b-4c8d-9e0f-1a2b3c4d5e6f",
    "options": [
        {
            "optionId": "6a7b8c9d-0e1f-4a2b-9c3d-5e6f70819203",
            "quantity": 1
        }
    ],
    "customer": {
        "firstName": "Marie",
        "lastName": "Martin",
        "email": "marie.martin@example.com",
        "phone": "+33612345678"
    },
    "partnerReference": "AV-884213",
    "pickupLocation": { "locationId": "c41a9e3b-2d55-4b0f-8c11-0f3a7d6e9b42" },
    "returnLocation": {
        "name": "Hôtel Negresco",
        "address": "37 promenade des Anglais, 06000 Nice"
    },
    "notes": "Siège enfant à installer avant la remise."
}
headers = {
    "Idempotency-Key": "<idempotency-key>",
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.lexio.rent/api/external/v1/rentals",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'vehicleId' => '3b1f5c2a-8d4e-4f6a-9b7c-2e5d8a1f4c63',
    'startAt' => '2026-11-10T10:00',
    'endAt' => '2026-11-15T10:00',
    'deductibleId' => '2c3d4e5f-6a7b-4c8d-9e0f-1a2b3c4d5e6f',
    'options' => [
        [
                'optionId' => '6a7b8c9d-0e1f-4a2b-9c3d-5e6f70819203',
                'quantity' => 1
        ]
    ],
    'customer' => [
        'firstName' => 'Marie',
        'lastName' => 'Martin',
        'email' => 'marie.martin@example.com',
        'phone' => '+33612345678'
    ],
    'partnerReference' => 'AV-884213',
    'pickupLocation' => [
        'locationId' => 'c41a9e3b-2d55-4b0f-8c11-0f3a7d6e9b42'
    ],
    'returnLocation' => [
        'name' => 'Hôtel Negresco',
        'address' => '37 promenade des Anglais, 06000 Nice'
    ],
    'notes' => 'Siège enfant à installer avant la remise.'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json",
    "Idempotency-Key: <idempotency-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

{
  "data": {
    "id": "9c2d7e4a-5b1f-4d3c-8a6e-0f1b2c3d4e5f",
    "number": "LOC-2026.11-0042",
    "status": "RESERVED",
    "source": "PARTNER",
    "partnerCode": "azur-voyages",
    "partnerReference": "AV-884213",
    "period": {
      "startAt": "2026-11-10T10:00:00+01:00",
      "endAt": "2026-11-15T10:00:00+01:00",
      "timezone": "Europe/Paris",
      "billedDays": 5,
      "durationMinutes": 7200
    },
    "actualStartAt": null,
    "actualEndAt": null,
    "vehicle": {
      "id": "3b1f5c2a-8d4e-4f6a-9b7c-2e5d8a1f4c63",
      "name": "208 Allure",
      "brand": "Peugeot",
      "model": "208",
      "vehicleType": "CITY",
      "plate": "AB-123-CD",
      "serialNumber": null
    },
    "customer": {
      "id": "7c4e2b9a-1f3d-4a6e-8b5c-9d0e1f2a3b4c",
      "isCompany": false,
      "firstName": "Marie",
      "lastName": "Martin",
      "companyName": null,
      "email": "marie.martin@example.com",
      "phone": "+33612345678"
    },
    "pickupLocation": {
      "locationId": "c41a9e3b-2d55-4b0f-8c11-0f3a7d6e9b42",
      "name": "Agence Nice Gare",
      "address": "12 avenue Thiers, 06000 Nice"
    },
    "returnLocation": {
      "locationId": null,
      "name": "Hôtel Negresco",
      "address": "37 promenade des Anglais, 06000 Nice"
    },
    "mileage": {
      "mileagePackageId": "5b7c9d1e-2f3a-4b5c-8d6e-7f8091a2b3c4",
      "name": "200 km/jour",
      "isUnlimited": false,
      "includedKm": 1000,
      "overageRatePerKmHT": 0.25
    },
    "deductible": {
      "deductibleId": "2c3d4e5f-6a7b-4c8d-9e0f-1a2b3c4d5e6f",
      "name": "Franchise réduite",
      "description": "Reste à charge réduit en cas de sinistre.",
      "excessAmount": 500
    },
    "deposit": {
      "depositId": "4e5f6a7b-8c9d-4e0f-9a1b-3c4d5e6f7081",
      "name": "Caution citadine",
      "depositAmount": 800
    },
    "options": [
      {
        "optionId": "6a7b8c9d-0e1f-4a2b-9c3d-5e6f70819203",
        "name": "Siège enfant",
        "kind": "STANDARD",
        "quantity": 1
      }
    ],
    "lines": [
      {
        "key": "BASE",
        "label": "Tarif de base",
        "refId": null,
        "quantity": 1,
        "unitPriceHT": 210,
        "unitPriceTTC": 252,
        "amountHT": 210,
        "amountTTC": 252,
        "ratePercent": null
      },
      {
        "key": "DURATION_DISCOUNT",
        "label": "Réduction durée 5 jours",
        "refId": null,
        "quantity": 1,
        "unitPriceHT": -10.5,
        "unitPriceTTC": -12.6,
        "amountHT": -10.5,
        "amountTTC": -12.6,
        "ratePercent": 5
      },
      {
        "key": "MILEAGE",
        "label": "Forfait 200 km/jour",
        "refId": null,
        "quantity": 1,
        "unitPriceHT": 0,
        "unitPriceTTC": 0,
        "amountHT": 0,
        "amountTTC": 0,
        "ratePercent": null
      },
      {
        "key": "DEDUCTIBLE",
        "label": "Franchise réduite",
        "refId": null,
        "quantity": 1,
        "unitPriceHT": 37.5,
        "unitPriceTTC": 45,
        "amountHT": 37.5,
        "amountTTC": 45,
        "ratePercent": null
      },
      {
        "key": "OPTION",
        "label": "Siège enfant",
        "refId": "6a7b8c9d-0e1f-4a2b-9c3d-5e6f70819203",
        "quantity": 1,
        "unitPriceHT": 20,
        "unitPriceTTC": 24,
        "amountHT": 20,
        "amountTTC": 24,
        "ratePercent": null
      }
    ],
    "promoCode": null,
    "currency": "EUR",
    "vatPercent": 20,
    "isVatReverseCharge": false,
    "totalHT": 257,
    "vatAmount": 51.4,
    "totalTTC": 308.4,
    "balance": {
      "totalTTC": 308.4,
      "paidAmount": 0,
      "dueAmount": 308.4,
      "overpaidAmount": 0
    },
    "notes": "Siège enfant à installer avant la remise.",
    "createdAt": "2026-11-02T09:15:02+01:00",
    "updatedAt": "2026-11-02T09:15:02+01:00"
  },
  "effects": {
    "customerResolution": "CREATED"
  }
}

{
  "type": "https://api.lexio.rent/errors/malformed-request",
  "title": "Corps de requête illisible",
  "status": 400,
  "code": "MALFORMED_REQUEST",
  "detail": "<string>",
  "instance": "<string>",
  "requestId": "<string>"
}

{
  "type": "https://api.lexio.rent/errors/api-key-disabled",
  "title": "Clé API désactivée",
  "status": 401,
  "code": "API_KEY_DISABLED",
  "detail": "<string>",
  "instance": "<string>",
  "requestId": "<string>"
}

{
  "type": "https://api.lexio.rent/errors/feature-not-available",
  "title": "Fonctionnalité non incluse",
  "status": 403,
  "code": "FEATURE_NOT_AVAILABLE",
  "detail": "<string>",
  "instance": "<string>",
  "requestId": "<string>",
  "feature": "<string>"
}

{
  "type": "https://api.lexio.rent/errors/already-exists",
  "title": "Doublon",
  "status": 409,
  "code": "ALREADY_EXISTS",
  "detail": "<string>",
  "instance": "<string>",
  "requestId": "<string>",
  "field": "<string>",
  "conflictingId": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}

{
  "type": "https://api.lexio.rent/errors/payload-too-large",
  "title": "Corps trop volumineux",
  "status": 413,
  "code": "PAYLOAD_TOO_LARGE",
  "detail": "<string>",
  "instance": "<string>",
  "requestId": "<string>",
  "maxBytes": 2
}

{
  "type": "https://api.lexio.rent/errors/unsupported-media-type",
  "title": "Type de contenu non pris en charge",
  "status": 415,
  "code": "UNSUPPORTED_MEDIA_TYPE",
  "detail": "<string>",
  "instance": "<string>",
  "requestId": "<string>",
  "accepted": [
    "<string>"
  ]
}

{
  "type": "https://api.lexio.rent/errors/booking-rule-violation",
  "title": "Règle de réservation non respectée",
  "status": 422,
  "code": "BOOKING_RULE_VIOLATION",
  "detail": "<string>",
  "instance": "<string>",
  "requestId": "<string>",
  "errors": [
    {
      "pointer": "<string>",
      "code": "required",
      "detail": "<string>"
    }
  ],
  "rule": "LEAD_TIME"
}

{
  "type": "https://api.lexio.rent/errors/rate-limited",
  "title": "Trop de requêtes",
  "status": 429,
  "code": "RATE_LIMITED",
  "detail": "<string>",
  "instance": "<string>",
  "requestId": "<string>",
  "limit": "PRE_AUTH",
  "windowSeconds": 2,
  "retryAfter": 1
}

{
  "type": "https://api.lexio.rent/errors/internal-error",
  "title": "Erreur interne",
  "status": 500,
  "code": "INTERNAL_ERROR",
  "detail": "<string>",
  "instance": "<string>",
  "requestId": "<string>"
}

Autorisations

Authorization

string

header

requis

Clé API lck_… créée dans Lexio (Paramètres → Développeur), envoyée en Authorization: Bearer. Voir Authentification.

En-têtes

Idempotency-Key

string

requis

Clé unique de l’opération, réutilisée à chaque nouvel essai : un rejeu avec la même clé et le même corps renvoie la réponse initiale sans rien réécrire. Voir Idempotence. Facultative avec ?dryRun=true sur les opérations qui l’acceptent.

Required string length: 1 - 255

Pattern: ^[\x20-\x7E]+$

Exemple:

"8b3e1d2c-4a5f-4c6b-9e7d-1f2a3b4c5d6e"

Corps

application/json

quoteId

string<uuid>

Devis de POST /quotes, consommé une fois : seule source du véhicule, de la période et des entrées de prix, alors absents du corps.

Exemple:

"7c9e6679-7425-40de-944b-e07fc1f90ae7"

vehicleId

string<uuid>

Sans quoteId, obligatoire : véhicule à louer.

Exemple:

"7c9e6679-7425-40de-944b-e07fc1f90ae7"

startAt

string

Sans quoteId, obligatoire : départ, heure murale de l’agence sans décalage.

Exemple:

"2026-11-10T10:00"

endAt

string

Sans quoteId, obligatoire : retour, heure murale de l’agence sans décalage.

Exemple:

"2026-11-10T10:00"

mileagePackageId

string<uuid> | null

Forfait kilométrique. Omis : forfait par défaut de l’organisation ; null : kilométrage illimité.

Exemple:

"7c9e6679-7425-40de-944b-e07fc1f90ae7"

deductibleId

string<uuid> | null

Franchise. Omis : franchise par défaut de la catégorie du véhicule, sinon de l’organisation ; null : sans franchise.

Exemple:

"7c9e6679-7425-40de-944b-e07fc1f90ae7"

depositId

string<uuid> | null

Caution. Omis : caution liée à la franchise retenue si elle est active, sinon caution par défaut de la catégorie, sinon de l’organisation, y compris avec deductibleId: null ; null : sans caution.

Exemple:

"7c9e6679-7425-40de-944b-e07fc1f90ae7"

options

object[]

Sans quoteId : options et quantités, règles de POST /quotes.

Maximum array length: 50

Show child attributes

charges

object[]

Sans quoteId, clé interne seulement : frais ou remises libres.

Maximum array length: 20

Show child attributes

Code promo, sans distinction de casse ; refusé → 422 PROMO_CODE_REJECTED (reason).

Required string length: 1 - 50

isVatReverseCharge

boolean

Sans quoteId, clé interne seulement : autoliquidation de la TVA, possible si isVatReverseChargeAvailable de GET /organization est vrai.

customerId

string<uuid>

Client existant (GET /customers), clé interne seulement.

Exemple:

"7c9e6679-7425-40de-944b-e07fc1f90ae7"

customer

object

Titulaire particulier : repris par email parmi les fiches de votre code partenaire, sinon créé (effects.customerResolution).

Show child attributes

partnerReference

string | null

Votre numéro de commande, unique par code partenaire (doublon → 409 ALREADY_EXISTS).

Required string length: 1 - 255

source

enum<string>

Canal de vente, ONLINE par défaut. Une clé partenaire ne peut envoyer que PARTNER, que porte toujours sa location.

Options disponibles:

ONLINE,

PHONE,

WALKIN,

PARTNER,

OTHER

pickupLocation

object | null

Lieu de départ ; omis ou null : aucun.

Show child attributes

returnLocation

object | null

Lieu de retour ; omis ou null : aucun.

Show child attributes

notes

string | null

Note libre.

Required string length: 1 - 2000

internalNotes

string | null

Note interne (clé interne seulement) : visible de l’équipe dans Lexio, jamais sur un document client ; clé partenaire → 400 not_applicable.

Required string length: 1 - 2000

Réponse

Créer une location

data

object

requis

Location, dans la même représentation pour la lecture, la liste et chaque écriture. Montants dans currency, voir Montants et TVA.

Show child attributes

Exemple:

{
  "id": "9c2d7e4a-5b1f-4d3c-8a6e-0f1b2c3d4e5f",
  "number": "LOC-2026.11-0042",
  "status": "RESERVED",
  "source": "PARTNER",
  "partnerCode": "azur-voyages",
  "partnerReference": "AV-884213",
  "period": {
    "startAt": "2026-11-10T10:00:00+01:00",
    "endAt": "2026-11-15T10:00:00+01:00",
    "timezone": "Europe/Paris",
    "billedDays": 5,
    "durationMinutes": 7200
  },
  "actualStartAt": null,
  "actualEndAt": null,
  "vehicle": {
    "id": "3b1f5c2a-8d4e-4f6a-9b7c-2e5d8a1f4c63",
    "name": "208 Allure",
    "brand": "Peugeot",
    "model": "208",
    "vehicleType": "CITY",
    "plate": "AB-123-CD",
    "serialNumber": null
  },
  "customer": {
    "id": "7c4e2b9a-1f3d-4a6e-8b5c-9d0e1f2a3b4c",
    "isCompany": false,
    "firstName": "Marie",
    "lastName": "Martin",
    "companyName": null,
    "email": "marie.martin@example.com",
    "phone": "+33612345678"
  },
  "pickupLocation": {
    "locationId": "c41a9e3b-2d55-4b0f-8c11-0f3a7d6e9b42",
    "name": "Agence Nice Gare",
    "address": "12 avenue Thiers, 06000 Nice"
  },
  "returnLocation": {
    "locationId": null,
    "name": "Hôtel Negresco",
    "address": "37 promenade des Anglais, 06000 Nice"
  },
  "mileage": {
    "mileagePackageId": "5b7c9d1e-2f3a-4b5c-8d6e-7f8091a2b3c4",
    "name": "200 km/jour",
    "isUnlimited": false,
    "includedKm": 1000,
    "overageRatePerKmHT": 0.25
  },
  "deductible": {
    "deductibleId": "2c3d4e5f-6a7b-4c8d-9e0f-1a2b3c4d5e6f",
    "name": "Franchise réduite",
    "description": "Reste à charge réduit en cas de sinistre.",
    "excessAmount": 500
  },
  "deposit": {
    "depositId": "4e5f6a7b-8c9d-4e0f-9a1b-3c4d5e6f7081",
    "name": "Caution citadine",
    "depositAmount": 800
  },
  "options": [
    {
      "optionId": "6a7b8c9d-0e1f-4a2b-9c3d-5e6f70819203",
      "name": "Siège enfant",
      "kind": "STANDARD",
      "quantity": 1
    }
  ],
  "lines": [
    {
      "key": "BASE",
      "label": "Tarif de base",
      "refId": null,
      "quantity": 1,
      "unitPriceHT": 210,
      "unitPriceTTC": 252,
      "amountHT": 210,
      "amountTTC": 252,
      "ratePercent": null
    },
    {
      "key": "DURATION_DISCOUNT",
      "label": "Réduction durée 5 jours",
      "refId": null,
      "quantity": 1,
      "unitPriceHT": -10.5,
      "unitPriceTTC": -12.6,
      "amountHT": -10.5,
      "amountTTC": -12.6,
      "ratePercent": 5
    },
    {
      "key": "MILEAGE",
      "label": "Forfait 200 km/jour",
      "refId": null,
      "quantity": 1,
      "unitPriceHT": 0,
      "unitPriceTTC": 0,
      "amountHT": 0,
      "amountTTC": 0,
      "ratePercent": null
    },
    {
      "key": "DEDUCTIBLE",
      "label": "Franchise réduite",
      "refId": null,
      "quantity": 1,
      "unitPriceHT": 37.5,
      "unitPriceTTC": 45,
      "amountHT": 37.5,
      "amountTTC": 45,
      "ratePercent": null
    },
    {
      "key": "OPTION",
      "label": "Siège enfant",
      "refId": "6a7b8c9d-0e1f-4a2b-9c3d-5e6f70819203",
      "quantity": 1,
      "unitPriceHT": 20,
      "unitPriceTTC": 24,
      "amountHT": 20,
      "amountTTC": 24,
      "ratePercent": null
    }
  ],
  "promoCode": null,
  "currency": "EUR",
  "vatPercent": 20,
  "isVatReverseCharge": false,
  "totalHT": 257,
  "vatAmount": 51.4,
  "totalTTC": 308.4,
  "balance": {
    "totalTTC": 308.4,
    "paidAmount": 0,
    "dueAmount": 308.4,
    "overpaidAmount": 0
  },
  "notes": "Siège enfant à installer avant la remise.",
  "createdAt": "2026-11-02T09:15:02+01:00",
  "updatedAt": "2026-11-02T09:15:02+01:00"
}

effects

object

requis

Show child attributes

Organisation

Offre

Locations

Modifications

Départ et retour

Paiements

Événements

Clients

Flotte

Catalogue

Tarification

Entretien

Créer une location

Autorisations

En-têtes

Corps

Réponse