Docs

API reference / Meta

OpenAPI specification

GET/v1/openapi.json

No authentication

OpenAPI 3.1 specification of this API, served without authentication.

Authentication#

This route is public: no API key is needed.

Responses#

200OpenAPI document.

Body

  • responseobjectrequired

    OpenAPI 3.1 document.

Example 200 response
{
  "openapi": "3.1.0",
  "info": {
    "title": "Tilt Pay API",
    "version": "2026-10-08"
  },
  "servers": [
    {
      "url": "https://sdk.tilt-pay.com"
    }
  ],
  "paths": {
    "/v1/me": {
      "get": {
        "operationId": "getMe"
      }
    }
  }
}
500Internal error. Retry; give request_id to support if it persists.

Example: internal_error

Example 500 response
{
  "error": {
    "type": "api_error",
    "code": "internal_error",
    "message": "Internal server error",
    "request_id": "0b2c8f6e-41f9-4c0a-8d55-6f6a3c1d9e21"
  }
}

Errors#

Errors share one format, described in Errors. Branch your code on error.code.

Errors this route can return
StatusCodeMeaning
500internal_errorInternal error. Retry; give request_id to support if it persists.