---
title: "Set the reservation for a specific voucher"
method: POST
path: "/reservations"
tags: ["Reservations"]
---

# Set the reservation for a specific voucher

`POST /reservations`

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.

## Request body

- object
  - `amount` string, required — 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
  - `currency` string, required — The three-character ISO-4217 currency code - https://en.wikipedia.org/wiki/ISO_4217#Active_codes (must match the currency of the voucher)
  - `code` string, required — A code that must be entered during the ordering process to receive the savings indidcated on the assiciated voucher.
  - `pin` string — An additional security feature on printed vouchers

## Response `201`

OK

- object
  - `id` string — Primary identification key - will be used in voucher-reservation calls
  - `voucher_id` string — Voucher primary identification key (see voucher -> id)
  - `voucher_taxable` boolean — Defines if this voucher is a taxable multi purpose voucher
  - `voucher_tax_rate` string — The tax rate for this voucher (only needed when taxable is true, can also be null)
  - `client_id` string — Client primary identification key (see client -> id)
  - `amount` string — 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
  - `valid_until` string, RFC3339 — valid_until - datetime in RFC3339 format, see https://tools.ietf.org/html/rfc3339
  - `created_at` string, RFC3339 — created_at - datetime in RFC3339 format, see https://tools.ietf.org/html/rfc3339
  - `updated_at` string, RFC3339 — updated_at - datetime in RFC3339 format, see https://tools.ietf.org/html/rfc3339

## Other responses

- `403` — The request contained valid data and was understood by the server, but the server is refusing action.
- `404` — The requested resource could not be found but may be available in the future. Subsequent requests by the client are permissible.
- `422` — The request was well-formed but was unable to be followed due to semantic errors.

---

[API](https://skmtc.net/jtl-software/apis/scx-authentication-api.md) · [All operations](https://skmtc.net/jtl-software/apis/scx-authentication-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/jtl-software/scx-authentication-api/revisions/f979b1ea6951/schema)