System
Health, server time, and the OpenAPI spec
GET /v2/health
Service health
Always answers 200, even during maintenance — the body carries the state. A MAINTENANCE status means every other route is returning 503, so poll this to know when to resume instead of probing a real endpoint.
Responses
| Code | Description | Body |
|---|---|---|
200 | Success. | HealthResponse |
500 | application/problem+json (RFC 9457) — branch on code, not on the status: internal_error (retryable). | — |
GET /v2/time
Server time for request signing and clock synchronization
Unauthenticated. Use it to measure your clock offset against Skipo before signing a Tier-2 request: a signed JWT carries iat and an exp at most 60 s later, so a client whose clock drifts past that window has every money-movement call rejected as expired — which looks like an auth failure rather than a clock problem. Poll it at start-up, not per request.
Responses
| Code | Description | Body |
|---|---|---|
200 | Success. | TimeResponse |
500 | application/problem+json (RFC 9457) — branch on code, not on the status: internal_error (retryable). | — |
Schemas
HealthResponse
| Field | Type | Description |
|---|---|---|
status | UP | MAINTENANCE | UP when serving normally. MAINTENANCE when the API is in maintenance — every other route is returning 503 with the maintenance problem type, so retry later rather than treating it as an outage. e.g. UP. |
Problem
| Field | Type | Description |
|---|---|---|
type | string | Stable problem-type URI. Resolves to docs for this error. e.g. https://docs.skipo.com/errors/rate_limited. |
title | string | Short, human-readable summary (stable, English). e.g. Rate limit exceeded. |
status | number | HTTP status code. e.g. 429. |
code | string | Stable machine-readable error code (equals the last path segment of type). e.g. rate_limited. |
retryable | boolean | Whether retrying the identical request may succeed. e.g. true. |
detail (optional) | string | Human-readable, possibly localized detail. |
instance (optional) | string | The request path that produced the error. |
traceId (optional) | string | Trace id — joins BigQuery api_request and Cloud Logging. |
TimeResponse
| Field | Type | Description |
|---|---|---|
serverTime | number | Server time, milliseconds since Unix epoch. e.g. 1783003522123. |
iso | string | The same instant as ISO-8601 UTC. e.g. 2026-07-28T12:34:56.789Z. |
Back to the endpoint reference. See also: Pagination · Errors · Ids and correlation.