Test without spending

Send POST /v1/validate to check your request body without being charged anything.

A call sent from a reference page with your key is a real call; /v1/validate is free there too.

Check the request shape

Use a valid API key, the credential that identifies your account, the record that owns your keys and the money you add. An account sign-in also works. This free call works at a zero balance, the money available on your account.

It checks shape, required fields and the property cap for POST /v1/predict. It never calls the underwriting service.

A true result does not prove that the address exists, is inside coverage or can be underwritten. The underwriting call decides whether a well-formed address can be underwritten. The validate reference describes the accepted body.

In the playground, use plain-text mode with valid JSON and an active Content-Type: application/json header. The request example sets both; other body modes or a missing content type receive 400.

Full response
{
  "valid": true
}

Handle availability

With an API Key it answers even while the Ledger is down. A connected app reads the Ledger to check that its connection is still approved. If that lookup is unavailable or its result is unclear, it returns 503 call-not-started.

A revoked connection receives 401 invalid-key. Nothing is charged either way.

If the operator temporarily switches this endpoint off, it returns 503 route-unavailable. Other endpoints are unaffected, and nothing was charged. Wait for Retry-After before sending the same call again.

Any Idempotency-Key header is ignored; this free call has no charge to replay.

Next steps