Changer le titulaire d’une location

curl --request POST \
  --url https://api.lexio.rent/api/external/v1/rentals/{rentalId}/change-customer \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'Idempotency-Key: <idempotency-key>' \
  --data '
{
  "customer": {
    "firstName": "Paul",
    "lastName": "Martin",
    "email": "paul.martin@example.com",
    "phone": "+33698765432"
  },
  "expectedTotalTTC": 308.4
}
'

const options = {
  method: 'POST',
  headers: {
    'Idempotency-Key': '<idempotency-key>',
    Authorization: 'Bearer <token>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    customer: {
      firstName: 'Paul',
      lastName: 'Martin',
      email: 'paul.martin@example.com',
      phone: '+33698765432'
    },
    expectedTotalTTC: 308.4
  })
};

fetch('https://api.lexio.rent/api/external/v1/rentals/{rentalId}/change-customer', 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/{rentalId}/change-customer"

payload = {
    "customer": {
        "firstName": "Paul",
        "lastName": "Martin",
        "email": "paul.martin@example.com",
        "phone": "+33698765432"
    },
    "expectedTotalTTC": 308.4
}
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/{rentalId}/change-customer",
  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([
    'customer' => [
        'firstName' => 'Paul',
        'lastName' => 'Martin',
        'email' => 'paul.martin@example.com',
        'phone' => '+33698765432'
    ],
    'expectedTotalTTC' => 308.4
  ]),
  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": {
    "priceChange": {
      "previousTotalHT": 257,
      "previousTotalTTC": 308.4,
      "newTotalHT": 351.8,
      "newTotalTTC": 422.16,
      "differenceHT": 94.8,
      "differenceTTC": 113.76
    },
    "previousCustomer": {
      "id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
      "isCompany": true,
      "firstName": "<string>",
      "lastName": "<string>",
      "companyName": "<string>",
      "email": "<string>",
      "phone": "<string>"
    },
    "customerResolution": "PROVIDED",
    "overpayment": {
      "overpaidAmount": 24,
      "resolution": "REFUND_PENDING",
      "resolvableByKey": true,
      "refundPaymentId": "b7c8d9e0-f1a2-4b3c-8d4e-5f6a7b8c9d0e"
    }
  }
}

{
  "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/not-found",
  "title": "Ressource introuvable",
  "status": 404,
  "code": "NOT_FOUND",
  "detail": "<string>",
  "instance": "<string>",
  "requestId": "<string>",
  "resource": "RENTAL"
}

{
  "type": "https://api.lexio.rent/errors/booking-refused",
  "title": "Réservation refusée",
  "status": 409,
  "code": "BOOKING_REFUSED",
  "detail": "<string>",
  "instance": "<string>",
  "requestId": "<string>"
}

{
  "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/idempotency-key-reused",
  "title": "Clé d’idempotence réutilisée",
  "status": 422,
  "code": "IDEMPOTENCY_KEY_REUSED",
  "detail": "<string>",
  "instance": "<string>",
  "requestId": "<string>"
}

{
  "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>"
}

Modifications

Changer le titulaire d’une location

Accès : rentals.write

Change le titulaire d’une location RESERVED (en cours : dans Lexio), par customerId (clé interne) ou customer (effects.customerResolution), jamais les deux. Aucun email envoyé.

Conducteurs : un titulaire particulier devient conducteur principal ; s’il remplace une société, le conducteur principal de celle-ci devient conducteur additionnel facturé. Une société qui remplace un particulier le garde en conducteur principal. Options conducteur recalculées (priceChange possible).

Refus

REFERENCE_NOT_FOUND, REFERENCE_INACTIVE : customerId inconnu, anonymisé.
400 invalid_value : titulaire actuel ; 400 not_applicable : customerId avec une clé partenaire.
CUSTOMER_BLOCKED (clé interne), BOOKING_REFUSED (clé partenaire) : client bloqué.
VAT_REVERSE_CHARGE_NOT_ALLOWED : autoliquidation, nouveau titulaire sans n° de TVA.
INVOICE_FINALIZED : facture déjà émise.
BOOKING_REFUSED : option conducteur sur un contrat au loyer mensuel.

Aperçu et prix : ?dryRun=true, expectedTotalTTC (PRICE_CHANGED), overpaymentResolution (OVERPAYMENT_RESOLUTION_REQUIRED, SEPA_DEBIT_PENDING) : voir Idempotence.

POST

rentals

{rentalId}

change-customer

Changer le titulaire d’une location

curl --request POST \
  --url https://api.lexio.rent/api/external/v1/rentals/{rentalId}/change-customer \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'Idempotency-Key: <idempotency-key>' \
  --data '
{
  "customer": {
    "firstName": "Paul",
    "lastName": "Martin",
    "email": "paul.martin@example.com",
    "phone": "+33698765432"
  },
  "expectedTotalTTC": 308.4
}
'

const options = {
  method: 'POST',
  headers: {
    'Idempotency-Key': '<idempotency-key>',
    Authorization: 'Bearer <token>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    customer: {
      firstName: 'Paul',
      lastName: 'Martin',
      email: 'paul.martin@example.com',
      phone: '+33698765432'
    },
    expectedTotalTTC: 308.4
  })
};

fetch('https://api.lexio.rent/api/external/v1/rentals/{rentalId}/change-customer', 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/{rentalId}/change-customer"

payload = {
    "customer": {
        "firstName": "Paul",
        "lastName": "Martin",
        "email": "paul.martin@example.com",
        "phone": "+33698765432"
    },
    "expectedTotalTTC": 308.4
}
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/{rentalId}/change-customer",
  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([
    'customer' => [
        'firstName' => 'Paul',
        'lastName' => 'Martin',
        'email' => 'paul.martin@example.com',
        'phone' => '+33698765432'
    ],
    'expectedTotalTTC' => 308.4
  ]),
  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": {
    "priceChange": {
      "previousTotalHT": 257,
      "previousTotalTTC": 308.4,
      "newTotalHT": 351.8,
      "newTotalTTC": 422.16,
      "differenceHT": 94.8,
      "differenceTTC": 113.76
    },
    "previousCustomer": {
      "id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
      "isCompany": true,
      "firstName": "<string>",
      "lastName": "<string>",
      "companyName": "<string>",
      "email": "<string>",
      "phone": "<string>"
    },
    "customerResolution": "PROVIDED",
    "overpayment": {
      "overpaidAmount": 24,
      "resolution": "REFUND_PENDING",
      "resolvableByKey": true,
      "refundPaymentId": "b7c8d9e0-f1a2-4b3c-8d4e-5f6a7b8c9d0e"
    }
  }
}

{
  "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/not-found",
  "title": "Ressource introuvable",
  "status": 404,
  "code": "NOT_FOUND",
  "detail": "<string>",
  "instance": "<string>",
  "requestId": "<string>",
  "resource": "RENTAL"
}

{
  "type": "https://api.lexio.rent/errors/booking-refused",
  "title": "Réservation refusée",
  "status": 409,
  "code": "BOOKING_REFUSED",
  "detail": "<string>",
  "instance": "<string>",
  "requestId": "<string>"
}

{
  "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/idempotency-key-reused",
  "title": "Clé d’idempotence réutilisée",
  "status": 422,
  "code": "IDEMPOTENCY_KEY_REUSED",
  "detail": "<string>",
  "instance": "<string>",
  "requestId": "<string>"
}

{
  "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"

Paramètres de chemin

rentalId

string<uuid>

requis

Identifiant de la location.

Exemple:

"9c2d7e4a-5b1f-4d3c-8a6e-0f1b2c3d4e5f"

Paramètres de requête

dryRun

enum<string>

true : aperçu, la même action annulée en fin de transaction.

Options disponibles:

true,

false

Corps

application/json

customerId

string<uuid>

Clé interne seulement (clé partenaire → 400 not_applicable). Inconnu → 422 REFERENCE_NOT_FOUND ; anonymisé → 422 REFERENCE_INACTIVE ; égal au titulaire actuel → 400 invalid_value.

Exemple:

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

customer

object

Même objet qu’à la création : repris par email parmi les fiches particulier de l’espace de la clé (fiches internes pour une clé interne), sinon créé. Une fiche reprise est gardée telle quelle : seuls ses champs vides sont complétés. Repris sur le titulaire actuel → 400 invalid_value.

Show child attributes

expectedTotalTTC

number

Total TTC affiché par l’aperçu (dryRun). Écart d’au moins une unité mineure avec le total recalculé → 409 PRICE_CHANGED.

overpaymentResolution

enum<string>

REFUND_PENDING : remboursement PENDING par virement du trop-perçu ; NO_REFUND : le loueur le conserve. Exige le scope payments.refund.

Options disponibles:

REFUND_PENDING,

NO_REFUND

Réponse

Changer le titulaire d’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

Changer le titulaire d’une location

Autorisations

En-têtes

Paramètres de chemin

Paramètres de requête

Corps

Réponse