# Switcloud API

**Canonical:** https://apis.io/apis/switstack/switcloud-api/  
**Provider:** Switstack — https://apis.io/providers/switstack/  
**Base URL:** https://switcloud.switstack.io/  
**Documentation:** https://docs.switstack.io/switcloud/

Switcloud API is one of 2 APIs that [Switstack](https://apis.io/providers/switstack/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. Tagged areas include Payments, EMV, emv-level-2, Card Present, and estate-management. The published artifact set on APIs.io includes an OpenAPI specification, an API reference, API documentation, a getting-started guide, and authentication docs.

REST API for the Switcloud platform, organized in three surfaces: switcloud-bom (estate — merchants, stores and points of interaction), switcloud-config (EMV L2 configuration — BINs, BIN lists/configs, CAPKs and CAPK lists, CRs and CR lists, EMVs and EMV lists/configs, POI configs) and switcloud-payment (payment lifecycle plus the encrypted transaction log data sets). OAuth 2.0 password / client-credentials grant issues a bearer token from /auth/token. Version 2.28.0 publishes 106 operations across 40 paths as OpenAPI 3.1.0.

## Machine-readable artifacts (12)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/switstack/refs/heads/main/openapi/switstack-switcloud-openapi.yml
- **APIReference** — https://docs.switstack.io/api/switcloud/api/switcloud-srv/
- **Documentation** — https://docs.switstack.io/switcloud/
- **GettingStarted** — https://docs.switstack.io/switcloud/getting_started/
- **Authentication** — https://docs.switstack.io/switcloud/security_authentication/
- **Overlay** — https://raw.githubusercontent.com/api-evangelist/switstack/refs/heads/main/overlays/switstack-switcloud-overlay.yaml
- **DataModel** — https://raw.githubusercontent.com/api-evangelist/switstack/refs/heads/main/data-model/switstack-data-model.yml
- **APIsJSON** — https://raw.githubusercontent.com/api-evangelist/switstack/refs/heads/main/apis.yml
- **Arazzo** — https://raw.githubusercontent.com/api-evangelist/switstack/refs/heads/main/arazzo/_index.yml
- **Arazzo** — https://raw.githubusercontent.com/api-evangelist/switstack/refs/heads/main/arazzo/switstack-onboard-a-terminal.yml
- **Arazzo** — https://raw.githubusercontent.com/api-evangelist/switstack/refs/heads/main/arazzo/switstack-run-a-test-suite.yml
- **Arazzo** — https://raw.githubusercontent.com/api-evangelist/switstack/refs/heads/main/arazzo/switstack-take-a-payment.yml

## Other Switstack APIs (1)

- [Swittest API](https://apis.io/apis/switstack/swittest-api/)

## Tags

Payments, EMV, emv-level-2, Card Present, estate-management, Point-of-Sale, In-Store Payments

---

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