---
title: "Find voucher by ID"
method: GET
path: "/Voucher/{voucherId}"
tags: ["Voucher"]
---

# Find voucher by ID

`GET /Voucher/{voucherId}`

Returns a single voucher

## Path parameters

- `voucherId` integer, required

## Response `200`

Successful operation

- object
  - `objects` ModelVoucherResponse[]
    - `id` string — The voucher id
    - `objectName` string — The voucher object name
    - `mapAll` boolean
    - `create` string, date-time — Date of voucher creation
    - `update` string, date-time — Date of last voucher update
    - `sevClient` object — Client to which voucher belongs. Will be filled automatically
      - `id` string, required — Unique identifier of the client
      - `objectName` string, required — Model name, which is 'SevClient'
    - `createUser` object — User who created the voucher. Will be filled automatically.
      - `id` string, required — Unique identifier of the user
      - `objectName` string, required — Model name, which is 'SevUser'
    - `voucherDate` string, date-time, nullable — Needs to be provided as timestamp or dd.mm.yyyy
    - `supplier` object, nullable — The contact used in the voucher as a supplier.<br> If you don't have a contact as a supplier, you can set this object to null.
      - `id` string, required — Unique identifier of the contact
      - `objectName` string, required — Model name, which is 'Contact'
    - `supplierName` string, nullable — The supplier name.<br> The value you provide here will determine what supplier name is shown for the voucher in case you did not provide a supplier.
    - `description` string, nullable — The description of the voucher. Essentially the voucher number.
    - `document` object, nullable — The document of the voucher.
      - `id` string, required — Unique identifier of the document
      - `objectName` string, required — Model name, which is 'Document'
    - `payDate` string, date-time, nullable — Needs to be timestamp or dd.mm.yyyy
    - `status` '50' | '100' | '1000', nullable — Please have a look in <a href='#tag/Voucher/Types-and-status-of-vouchers'>status of vouchers</a> to see what the different status codes mean
    - `sumNet` string — Net sum of the voucher
    - `sumTax` string — Tax sum of the voucher
    - `sumGross` string — Gross sum of the voucher
    - `sumNetAccounting` string — Net accounting sum of the voucher. Is usually the same as sumNet
    - `sumTaxAccounting` string — Tax accounting sum of the voucher. Is usually the same as sumTax
    - `sumGrossAccounting` string — Gross accounting sum of the voucher. Is usually the same as sumGross
    - `sumDiscounts` string — Sum of all discounts in the voucher
    - `sumDiscountsForeignCurrency` string — Discounts sum of the voucher in the foreign currency
    - `paidAmount` number, nullable — Amount which has already been paid for this voucher by the customer
    - `taxRule` object — **Use this in sevdesk-Update 2.0 (replaces taxType / taxSet).**
      - `id` '1' | '2' | '3' | '4' | '5' | '11', required — **Use this in sevdesk-Update 2.0 (replaces taxType / taxSet).** Defines the vat-regulation. For "Regelbesteuerung" it can be one of: - `1` - Umsatzsteuerpflichtige Umsätze (tax rates: 0.0, 7.0, 19.0) - replaces `"taxType": "default"` - `2` - Ausfuhren (tax rates: 0.0) - `3` - Innergemeinschaftliche Lieferungen (tax rates: 0.0, 7.0, 19.0) - replaces `"taxType": "eu"` - `4` - Steuerfreie Umsätze §4 UStG (tax rates: 0.0) - `5` - Reverse Charge gem. §13b UStG (tax rates: 0.0) For small business owner ("Kleinunternehmer") it can be: - `11` - Steuer nicht erhoben nach §19UStG (tax rates: 0.0) - replaces `"taxType": "ss"`
      - `objectName` 'TaxRule', required — Name of the object. Must always be TaxRule
    - `taxType` string, nullable — **Use this in sevdesk-Update 1.0 (instead of taxRule).** Tax type of the voucher. There are four tax types: 1. default - Umsatzsteuer ausweisen 2. eu - Steuerfreie innergemeinschaftliche Lieferung (Europäische Union) 3. noteu - Steuerschuldnerschaft des Leistungsempfängers (außerhalb EU, z. B. Schweiz) 4. custom - Using custom tax set 5. ss - Not subject to VAT according to §19 1 UStG Tax rates are heavily connected to the tax type used.
    - `creditDebit` 'C' | 'D', nullable — Defines if your voucher is a credit (C) or debit (D)
    - `costCentre` object — Cost centre for the voucher
      - `id` string, required — Unique identifier of the cost centre
      - `objectName` string, required — Model name, which is 'CostCentre'
    - `voucherType` 'VOU' | 'RV', nullable — Type of the voucher. For more information on the different types, check <a href='#tag/Voucher/Types-and-status-of-vouchers'>this</a>
    - `currency` string, nullable — specifies which currency the voucher should have. Attention: If the currency differs from the default currency stored in the account, then either the "propertyForeignCurrencyDeadline" or "propertyExchangeRate" parameter must be specified. If both parameters are specified, then the "propertyForeignCurrencyDeadline" parameter is preferred
    - `propertyForeignCurrencyDeadline` string, date-time, nullable — Defines the exchange rate day and and then the exchange rate is set from sevdesk. Needs to be provided as timestamp or dd.mm.yyyy
    - `propertyExchangeRate` string, nullable — Defines the exchange rate
    - `recurringInterval` 'P0Y0M1W' | 'P0Y0M2W' | 'P0Y1M0W' | 'P0Y3M0W' | 'P0Y6M0W' | 'P1Y0M0W' | 'P2Y0M0W' | 'P3Y0M0W' | 'P4Y0M0W' | 'P5Y0M0W', nullable — The DateInterval in which recurring vouchers are generated.<br> Necessary attribute for all recurring vouchers.
    - `recurringStartDate` string, date-time, nullable — The date when the recurring vouchers start being generated.<br> Necessary attribute for all recurring vouchers.
    - `recurringNextVoucher` string, date-time, nullable — The date when the next voucher should be generated.<br> Necessary attribute for all recurring vouchers.
    - `recurringLastVoucher` string, date-time, nullable — The date when the last voucher was generated.
    - `recurringEndDate` string, date-time, nullable — The date when the recurring vouchers end being generated.<br> Necessary attribute for all recurring vouchers.
    - `enshrined` string, date-time — Enshrined vouchers cannot be changed. Can only be set via [Voucher/{voucherId}/enshrine](#tag/Voucher/operation/voucherEnshrine). This operation cannot be undone.
    - `taxSet` object, nullable — **Use this in sevdesk-Update 2.0 (replaces taxType / taxSet).** Tax set of the voucher. Needs to be added if you chose the taxType=custom.
      - `id` string, required — Unique identifier of the object
      - `objectName` string, required — Model name, which is 'TaxSet'
    - `paymentDeadline` string, date-time, nullable — Payment deadline of the voucher.
    - `deliveryDate` string, date-time — Needs to be provided as timestamp or dd.mm.yyyy
    - `deliveryDateUntil` string, date-time, nullable — Needs to be provided as timestamp or dd.mm.yyyy

## Other responses

- `400` — Bad request. Voucher was not found
- `401` — Authentication required
- `500` — Server Error

---

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