# Creates a BookingOrder resource.

Creates a BookingOrder resource.

Endpoint: POST /v1/booking/orders/_bulk
Version: release
Security: JWT

## Security:

  - `JWT` (unknown)
    apiKey in header Authorization

## Request body:

  - `application/ld+json` (unknown)
    The new BookingOrder resource

## Request fields (application/ld+json):

  - `reservations` (array)

  - `customer` (object)

  - `customer.phone` (string)
    Example: +33610203040

  - `customer.firstname` (string, required)
    Example: john

  - `customer.lastname` (string, required)
    Example: doe

  - `customer.email` (string, required)
    Example: john.doe@example.com

  - `customer.country` (string)
    Example: FR

  - `customer.language` (string)
    Example: fr

  - `customer.optin` (boolean)

  - `customer.title` (string)
    Enum: "mr", "mrs", "mx"

  - `customer.dateOfBirth` (string | null)
    Example: 2025-01-27

  - `externalReference` (string, required)

  - `notes` (string | null)
    Example: Special assistance needed

## Response 200:

  - `200` (unknown)
    BookingOrder resource created

## Response 200 fields (application/ld+json):

  - `@context` (any)

  - `@context.@vocab` (string, required)

  - `@context.hydra` (string, required)
    Enum: "http://www.w3.org/ns/hydra/core#"

  - `@id` (string, required)

  - `@type` (string, required)

  - `orders` (array, required)

  - `orders.id` (string, required)
    Example: 0194cb22-b891-754c-8c4c-777b93f8d072

  - `orders.createdAt` (string, required)
    Example: 2025-01-27T15:15:20+00:00

  - `orders.catalog` (string, required)
    Example: /v1/ticketing/catalogs/0194cb23-170e-71f0-b4bb-0a7e644dea34

  - `orders.organization` (string, required)
    Example: /v1/organizations/0194cb23-170e-71f0-b4bb-0a7e644dea34

  - `orders.reference` (string, required)
    Example: KT-ORD-123456

  - `orders.externalReference` (string | null, required)
    Example: YOUR-CUSTOM-REFERENCE

  - `orders.connectorReference` (string | null, required)

  - `orders.totalAmountInclTax` (string, required)
    Example: 100.00

  - `orders.totalAmountExclTax` (string, required)
    Example: 100.00

  - `orders.reservation` (string, required)
    Example: /v1/booking/reservations/0194cb23-f18e-7c8e-9729-a7a65e961639

  - `orders.customer` (object, required)

  - `orders.customer.firstname` (string, required)
    Example: john

  - `orders.customer.lastname` (string, required)
    Example: doe

  - `orders.customer.email` (string, required)
    Example: john.doe@example.com

  - `orders.customer.phone` (string, required)
    Example: +33610203040

  - `orders.customer.optin` (boolean, required)

  - `orders.customer.country` (string, required)
    Example: FR

  - `orders.customer.language` (string, required)
    Example: fr

  - `orders.customer.title` (string, required)
    Example: mr

  - `orders.status` (string, required)
    Enum: "confirmed", "cancelled"

  - `orders.cancelledAt` (string | null, required)
    Example: 2025-02-27T15:15:20+00:00

  - `orders.notes` (string | null, required)
    Example: Special assistance needed

  - `orders.items` (array, required)

  - `orders.items.id` (string, required)
    Example: 0194cb22-b891-754c-8c4c-777b93f8d072

  - `orders.items.amountInclTax` (string, required)
    Example: 100.00

  - `orders.items.amountExclTax` (string, required)
    Example: 80.00

  - `orders.items.date` (string | null, required)
    Example: 2025-01-27

  - `orders.items.product` (string, required)

  - `orders.items.tickets` (array, required)

  - `orders.items.tickets.id` (string, required)
    Example: 0194cb22-b891-754c-8c4c-777b93f8d072

  - `orders.items.tickets.voucher` (string | null, required)

  - `orders.items.tickets.occursAt` (string | null, required)
    Example: 2025-02-27T15:15:20+00:00

  - `orders.items.tickets.requiredBeneficiaryFields` (array, required)
    Example: ["firstname","lastname"]

  - `orders.items.tickets.beneficiary` (any, required)

  - `orders.items.tickets.beneficiary.firstname` (string, required)
    Example: John

  - `orders.items.tickets.beneficiary.lastname` (string, required)
    Example: Doe

  - `orders.items.tickets.beneficiary.email` (string | null, required)
    Example: john.doe@example.com

  - `orders.items.tickets.beneficiary.phone` (string | null, required)
    Example: +33610203040

  - `orders.items.tickets.beneficiary.title` (string | null, required)
    Enum: "mr", "mrs", "mx"

  - `orders.items.tickets.beneficiary.dateOfBirth` (string | null, required)
    Example: 2000-01-01

  - `orders.items.tickets.beneficiary.placeOfBirth` (string | null, required)
    Example: Aix-en-Provence

  - `orders.items.tickets.beneficiary.nationality` (string | null, required)
    Example: FR

  - `orders.items.tickets.beneficiary.identityDocumentNumber` (string | null, required)
    Example: 12AB34567

  - `orders.items.tickets.beneficiary.identityDocumentType` (string | null, required)
    Enum: "passport", "nationalIdCard", "drivingLicence", null

  - `orders.items.tickets.beneficiary.identityDocumentExpiry` (string | null, required)
    Example: 2030-01-01

  - `orders.items.tickets.beneficiaryDesignationDeadline` (string | null, required)

  - `orders.items.tickets.beneficiaryAmendable` (boolean, required)

  - `orders.items.tickets.status` (string, required)
    Enum: "waiting_beneficiary_data", "validated"

  - `orders.items.tickets.seating` (any, required)

  - `orders.items.tickets.seating.seatNumber` (string, required)
    Example: 12

  - `orders.items.tickets.seating.level` (string | null, required)
    Example: WEST/LOW-01-02

  - `orders.items.tickets.seating.row` (string | null, required)
    Example: R

  - `orders.items.tickets.seating.stand` (string | null, required)
    Example: S

  - `orders.items.tickets.seating.stair` (string | null, required)
    Example: 2

  - `orders.items.tickets.seating.gate` (string | null, required)
    Example: G

  - `orders.items.tickets.documents` (array, required)

  - `orders.documents` (array, required)

  - `orders.cancellationAllowed` (boolean, required)

  - `orders.consolidatedDocument` (string | null, required)
    Example: https://example.com/

  - `failedOrders` (array, required)

  - `failedOrders.message` (string, required)

  - `failedOrders.reservation` (string, required)

## Response 400:

  - `400` (unknown)
    Invalid input

## Response 400 fields (application/ld+json):

  - `@context` (any)

  - `@context.@vocab` (string, required)

  - `@context.hydra` (string, required)
    Enum: "http://www.w3.org/ns/hydra/core#"

  - `@id` (string, required)

  - `@type` (string, required)

  - `title` (string | null, required)
    A short, human-readable summary of the problem.

  - `detail` (string | null, required)
    A human-readable explanation specific to this occurrence of the problem.

  - `status` (integer | null, required)

  - `instance` (string | null, required)
    A URI reference that identifies the specific occurrence of the problem. It may or may not yield further information if dereferenced.

  - `type` (string, required)
    A URI reference that identifies the problem type

  - `description` (string | null, required)

## Response 403:

  - `403` (unknown)
    Forbidden

## Response 403 fields (application/ld+json):

  - `@context` (any)

  - `@context.@vocab` (string, required)

  - `@context.hydra` (string, required)
    Enum: "http://www.w3.org/ns/hydra/core#"

  - `@id` (string, required)

  - `@type` (string, required)

  - `title` (string | null, required)
    A short, human-readable summary of the problem.

  - `detail` (string | null, required)
    A human-readable explanation specific to this occurrence of the problem.

  - `status` (integer | null, required)

  - `instance` (string | null, required)
    A URI reference that identifies the specific occurrence of the problem. It may or may not yield further information if dereferenced.

  - `type` (string, required)
    A URI reference that identifies the problem type

  - `description` (string | null, required)

## Response 422:

  - `422` (unknown)
    An error occurred

## Response 422 fields (application/ld+json):

  - `@context` (any)

  - `@context.@vocab` (string, required)

  - `@context.hydra` (string, required)
    Enum: "http://www.w3.org/ns/hydra/core#"

  - `@id` (string, required)

  - `@type` (string, required)

  - `status` (integer, required)

  - `violations` (array, required)

  - `violations.propertyPath` (string, required)
    The property path of the violation

  - `violations.message` (string, required)
    The message associated with the violation

  - `violations.code` (string)
    The code of the violation

  - `violations.hint` (string)
    An extra hint to understand the violation

  - `violations.payload` (object)
    The serialized payload of the violation

  - `detail` (string, required)

  - `description` (string, required)

  - `type` (string, required)

  - `title` (string | null, required)

  - `instance` (string | null, required)