> ## Documentation Index > Fetch the complete documentation index at: https://developer.jtl-software.com/llms.txt > Use this file to discover all available pages before exploring further. # Set the reservation for a specific voucher > This call temporary reserves an amount on a specific voucher, that can later be charged. A reservation expires after 30 minutes or in case a new one is requested for this voucher. ## OpenAPI ````yaml /openapi/voucher.json post /reservations openapi: 3.0.0 info: version: '1.8' title: JTL-Voucher Cloud API description: >- # Introduction Welcome to the JTL Voucher Cloud API documentation. Here you will find all information to get started using our API in your projects. contact: name: JTL-Software-GmbH url: https://www.jtl-software.com email: info@jtl-software.de servers: - url: https://vouchers.api.jtl-software.com/v1 description: JTL-Voucher Cloud API (Production) - url: https://vouchers-sbx.api.jtl-software.com/v1 description: JTL-Voucher Cloud API (Sandbox) security: - BearerAuth: - read - read-lists - read-secrets - use - manage - update - recharge tags: - name: Vouchers - name: Reservations - name: Charges - name: Clients paths: /reservations: post: tags: - Reservations summary: Set the reservation for a specific voucher description: > This call temporary reserves an amount on a specific voucher, that can later be charged. A reservation expires after 30 minutes or in case a new one is requested for this voucher. requestBody: description: Voucher reservation request body required: true content: application/json: schema: type: object properties: amount: type: string minLength: 4 maxLength: 9 pattern: ^\d+\.\d{2}$ description: > Amount in the currency of this voucher. Must be send as string in the following pattern: * Up to five digits before the decimal point * The decimal point (.) * Exactly two digits after the decimal point example: '10.53' currency: type: string description: >- The three-character ISO-4217 currency code - https://en.wikipedia.org/wiki/ISO_4217#Active_codes (must match the currency of the voucher) minLength: 3 maxLength: 3 example: EUR code: type: string maxLength: 255 description: >- A code that must be entered during the ordering process to receive the savings indidcated on the assiciated voucher. example: test pin: type: string maxLength: 255 description: An additional security feature on printed vouchers example: test required: - amount - currency - code responses: '201': description: OK content: application/json: schema: type: object properties: id: type: string description: >- Primary identification key - will be used in voucher-reservation calls readOnly: true example: da39a3ee5eb28b7392ef5 voucher_id: type: string description: Voucher primary identification key (see voucher -> id) readOnly: true example: da39a3ee4528b7392ef5 voucher_taxable: type: boolean description: Defines if this voucher is a taxable multi purpose voucher example: false voucher_tax_rate: type: string description: >- The tax rate for this voucher (only needed when taxable is true, can also be null) example: null client_id: type: string description: Client primary identification key (see client -> id) readOnly: true example: cff8784e5eb28b9b04860 amount: type: string minLength: 4 maxLength: 9 pattern: ^\d+\.\d{2}$ description: > Amount in the currency of this voucher. Must be send as string in the following pattern: * Up to five digits before the decimal point * The decimal point (.) * Exactly two digits after the decimal point example: '10.53' valid_until: type: string format: RFC3339 description: >- valid_until - datetime in RFC3339 format, see https://tools.ietf.org/html/rfc3339 example: '2017-07-21T17:32:28+00:00' created_at: type: string format: RFC3339 readOnly: true description: >- created_at - datetime in RFC3339 format, see https://tools.ietf.org/html/rfc3339 example: '2017-07-21T17:32:28+00:00' updated_at: type: string format: RFC3339 readOnly: true description: >- updated_at - datetime in RFC3339 format, see https://tools.ietf.org/html/rfc3339 example: '2017-07-21T17:32:28+00:00' '403': description: >- The request contained valid data and was understood by the server, but the server is refusing action. content: application/json: schema: type: string example: Forbidden '404': description: >- The requested resource could not be found but may be available in the future. Subsequent requests by the client are permissible. content: application/json: schema: type: object properties: status: type: number description: The HTTP status code default: 404 code: type: string description: A unique code for this error example: VOUCHER.NOT_FOUND message: type: string description: The error message example: The requested Voucher was not found. '422': description: >- The request was well-formed but was unable to be followed due to semantic errors. content: application/json: schema: type: object properties: status: type: number description: The HTTP status code default: 422 code: type: string description: A unique code for this error example: VOUCHER.CREATE.UNPROCESSABLE_ENTITY message: type: string description: The error message default: The given data was invalid. errors: type: array items: type: object properties: code: type: string description: A unique code for this specific validation error example: VOUCHER.CREATE.CURRENCY.VALID_CURRENCY property: type: string description: The property where the validation fails example: currency rule: type: string description: The rule that caused the validation fail example: valid_currency message: type: string description: The validation rule error message example: Currency must be a valid currency code security: - BearerAuth: - use components: securitySchemes: BearerAuth: type: oauth2 description: > This API uses OAuth 2 with Client Credentials Flow (see: https://www.oauth.com/oauth2-servers/access-tokens/client-credentials). > You can request only a subset of specific scopes for your client, however the available scopes for each client are defined through the client groups in the UI. > Within your token request, you can also send the optional parameter *client_type* (string with a max length of 32 chars). This value is only used for internal statistics. flows: clientCredentials: tokenUrl: https://vouchers.api.jtl-software.com/oauth/token scopes: read: Read single vouchers read-lists: Read voucher lists read-secrets: Read secret voucher information like code and pin use: Use a voucher (activation, reservation, charge and cancel) manage: Create and delete vouchers update: Update vouchers recharge: Recharge a voucher ````