Responses & errors#

Success envelope#

{
  "status": true,
  "message": "Subscription created",
  "data": { }
}

Error envelope#

{
  "status": false,
  "message": "Human readable message",
  "error_code": "subscription_already_completed",
  "errors": {
    "email": ["The email field is required."]
  }
}

Important: Check error_code for business-rule failures (e.g. subscription_already_completed). Check errors for field validation failures (422).

HTTP statuses#

Amounts#

Important: All amounts are integers in minor units (cents). 1000 = €10.00.

Versioning#