# Swiss Post API

**Canonical:** https://apis.io/apis/swiss-post/swiss-post-api/  
**Provider:** Swiss Post — https://apis.io/providers/swiss-post/  
**Base URL:** https://api.post.ch  
**Documentation:** https://developer.post.ch/en/technical-specifications-of-postcard-api

Swiss Post API is one of 2 APIs that [Swiss Post](https://apis.io/providers/swiss-post/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 6 JSON Schema definitions. The published artifact set on APIs.io includes an OpenAPI specification and 6 JSON Schemas.

Swiss Post API as documented publicly: 14 operations. Contract generated from the documentation by API Evangelist (2026-10-28); not the provider's own document.

## Operations (14)

| Method | Path | Summary |
|---|---|---|
| POST | `/OAuth/token` | POST /OAuth/token |
| POST | `/api/v1/postcards` | Create a Post card resource via the versioned API (POST /api/v1/postcards). |
| PUT | `/api/v1/postcards/{cardkey}/branding/qrtag` | Add a branding block of type QR‑Tag with text (PUT /api/v1/postcards/{cardKey}/branding/qrtag). |
| POST | `/orders` | Create a order resource |
| POST | `/orders/{orderkey}/approval` | Set the approval for the order |
| POST | `/postcards` | Create a Post card resource (POST /postcards) minimally providing the recipientAddress. |
| POST | `/postcards/{cardkey}/approval` | Set the approval for printing the post card (POST /postcards/{cardKey}/approval). |
| PUT | `/postcards/{cardkey}/branding/image` | Add a branding block of type image (PUT /postcards/{cardKey}/branding/image). |
| PUT | `/postcards/{cardkey}/branding/qrtag` | Add a branding block of type QR‑Tag with text (PUT /postcards/{cardKey}/branding/qrtag). |
| PUT | `/postcards/{cardkey}/branding/stamp` | Add a stamp image (PUT /postcards/{cardKey}/branding/stamp). |
| PUT | `/postcards/{cardkey}/branding/text` | Add a branding block of type text (PUT /postcards/{cardKey}/branding/text). |
| PUT | `/postcards/{cardkey}/image` | Add an image (PUT /postcards/{cardKey}/image). |
| GET | `/userinfo` | GET /userinfo |
| GET | `/wsws/soap/v6` | GET /wsws/soap/v6 |

## Machine-readable artifacts (7)

- **OpenAPI** — https://artifacts.apis.io/swiss-post/openapi/_ae-authored/swiss-post-openapi-generated.yml
- **JSONSchema** — https://artifacts.apis.io/swiss-post/json-schema/swiss-post-put-postcards-cardkey-branding-qrtag-request-schema.json
- **JSONSchema** — https://artifacts.apis.io/swiss-post/json-schema/swiss-post-put-postcards-cardkey-branding-text-request-schema.json
- **JSONSchema** — https://artifacts.apis.io/swiss-post/json-schema/swiss-post-post-postcards-request-schema.json
- **JSONSchema** — https://artifacts.apis.io/swiss-post/json-schema/swiss-post-post-orders-response-schema.json
- **JSONSchema** — https://artifacts.apis.io/swiss-post/json-schema/swiss-post-post-postcards-response-schema.json
- **JSONSchema** — https://artifacts.apis.io/swiss-post/json-schema/swiss-post-post-orders-orderkey-approval-response-schema.json

## Other Swiss Post APIs (1)

- [Swiss Post API](https://apis.io/apis/swiss-post/swiss-post-api-2/)

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/swiss-post/swiss-post-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/swiss-post/.