Conventions.

Money is integer cents. Always.

1600 = $16.00. No floats, no decimal strings.

Timestamps.

ISO-8601, UTC. Example: 2026-08-24T19:04:11Z.

Pagination.

List endpoints take limit (max 100, default 50). GET /v1/checks supports cursoring with starting_after=<check id>.

{ "data": [ ... ], "has_more": true }

Additive-only versioning.

Within v1, fields are never removed or renamed, and error codes are never repurposed. New fields may appear at any time — build your parser to ignore unknown fields.

Deprecation policy.

If an endpoint or version is ever sunset, you get at least 6 months’ notice by email to key owners, and deprecated endpoints send IETF Deprecation and Sunset headers in the meantime.