Skip to main content

Overview

The Subtotal API lets brands and developers build experiences around customer-permissioned retail purchases. The Subtotal API follows REST principles and uses standard HTTP methods and JSON payloads, making it straightforward to work with in any modern programming language or framework.

Base URL

Append an endpoint to the base URL root address to form a complete request URL.
https://api.subtotal.com

Authentication

All requests must include an API key for authentication. Include the following header in each request:
headers = {
  "X-Api-Key": "{yourkeyvalue}"
}

Authorization

We reserve the Authorization header for endpoints that require a connection token.
headers = {
  "Authorization": "Bearer: {connection_token}"
}