Overview
EPOS Developer API (1.0.0)
Section titled “EPOS Developer API (1.0.0)”Public/partner API for approved EPOS integrations. Every route lives under /v1 and is versioned, redacted and rate-limited independently of EPOS’s internal (unversioned) API, which is out of scope for this document and never appears in it. Access requires an Integration API key issued to an approved IntegrationClient, scoped to specific capabilities and optionally restricted to specific stores. This document is a DEV review artifact and is not yet published to a public developer docs site.
- OpenAPI version: 3.0.0
Authentication
Section titled “ Authentication ”IntegrationApiKey
Section titled “IntegrationApiKey ”EPOS integration API key issued to an IntegrationClient via Back Office Developer Tools > Integrations. Not a JWT, not OAuth2 - a static API key. Format: Authorization: Bearer epos_live_sk_... (production) or Bearer epos_dev_sk_... (development). Staff/Back Office JWT sessions are never valid for /v1 - only Integration API keys are.
Security scheme type: http
Bearer format: EPOS integration API key issued to an IntegrationClient