Skip to main content

Base URLs

The same URLs serve test and live. Your access token decides which environment a request acts in: see Environments.

Authentication

Send an access token from your OAuth client as a bearer token:
Get an access token explains how. Each operation lists the scope it needs.

Conventions

  • Requests and responses are JSON (Content-Type: application/json).
  • Amounts are integer strings in minor units: see Money.
  • Timestamps are milliseconds since the Unix epoch.
  • Writes that create something or move money require an Idempotency-Key header: see Idempotency.
  • Every response has an x-request-id header.
  • Errors look like {"error": {"code": "…", "message": "…"}}: see Errors and limits.