Parcel labels for high consignment volumes
API interface Barcode

If you would like a consultation about the following APIs or web services, contact your salesperson or e-mail e-commerce@swisspost.ch

You can find technical documentation for our APIs here.

You can find further information on each individual interface here:

• API
• “Barcode” web service
• “Track consignments” web service
• DataTransfer

Please use our developer portal to receive credentials for our APIs or con-tact your salesperson.

Please note that a billing relationship with Swiss Post is required in order for you to use the APIs.

Apply for a billing relationship

“Barcode” web service based on SOAP technology, the technical successor of the “Barcode” web service is the Barcode API (REST technology). We recommend using the APIs, as the APIs enable a modular structure of additional services and the “Barcode” web service is no longer being developed.

Please check with your service provider / developer whether a REST or SOAP-based connection is planned.

Our sales teams will be happy to assist you in providing the access data for our web services. For French language queries, please contact our team at pme.ouest@swisspost.ch, and for all other languages, at kmu.mitte@swisspost.ch.

All information can be found here.

You can submit your request using this form.

Please check the status under “printPreview” in your request:

• false = label printed without SPECIMEN
• true = label printed with SPECIMEN

If the problem persists, contact us via the contact form below.

Please use our developer portal to receive more scopes for our APIs.

Alternatively, you can also contact us using the form below.

Information on error messages can be found in chapters 8.14.1 and 9.3 of the technical documentation or in the swagger documentation of the relevant API.

You can find the swagger documentation in the developer portal. Search for the relevant API and click on “OpenAPI” on the left-hand side.

If you continue to receive error messages, contact us using the below form and send the request and response along with your message as an attachment.

Please contact us using the form below, specify the number to which we should change the meter, and barcode labels will then be generated starting from that number.

Please use track and trace or contact customer service at +41 848 888 888.

Contact us using the form below.

In most cases, this is a decoding issue.

Please ensure that the Base64 code which you receive from us as a response is decoded with CP437 or CP850 and not with UTF-8.

We cannot provide any product recommendations.

If you pass the labels on directly to a continuous-feed label printer, this can be done using printer language ZPL2. For this, the printer model used must support the printer language ZPL2, as otherwise the quality requirements on the labels will not be met.

It also depends on the format in which you would like to generate the label.

Information on the formats and printers can be found in chapters 8.2 – 8.6 and 8.9 of the technical documentation.

If you registered via our developer portal, you can track the status of your registra-tion in Your Subscriptions.

If you registered via our sales team or web form, we will usually send you your access details within three working days.

We send the access details in encrypted form. The following link will take you to a detailed set of instructions on how to open the encrypted IncaMail.

Instructions on opening encrypted IncaMail

Please also check your spam folder.

If this doesn’t answer your question, you can contact us using the form below.

You can obtain the same reports that you get from DataTransfer.

Since the start of 2023, we no longer provide test access details.

Testing can also be done with working access data, e.g. if you set the “printpreview” status on the barcode to true in the request.

If, for example, you change the value of the “Printpreview” field to “true”, you will receive “SPECIMEN labels”.

All test access details were deactivated at the beginning of 2023 and are no longer valid.

Testing can also be done with working access data, e.g. if you set the “printpreview” status on the barcode to “true” in the request.

Multiple labels may not be created in the same request. Please create one request per label.

Since the start of 2023, we no longer provide test access details.

Please register your company for the API so that we can provide you with access details for your company.

Alternatively, we would recommend that you ask for your (pilot) customers’ access details.

You can find the technical documents for the API here.

You can find the swagger documentation in the developer portal. Search for the relevant API and click on “OpenAPI” on the left-hand side.