Skip to main content

List claimed domains

GET /v1/domains

List claimed domains

Credential. A dashboard session token only. An API key cannot call this — a key must never be able to mint another key.

curl --fail-with-body "https://api-833252724876.us-central1.run.app/v1/domains" \
-H "Authorization: Bearer $JEAN_SESSION_TOKEN"

Response · 200

{
"domains": [
{
"org_id": "org_k3j2h4g5f6d7s8a9q0w1",
"domain": "example.com",
"claimed_by": "usr_b2c3d4e5f6g7h8i9j0k1",
"verified_at": "2026-01-15T09:30:00Z",
"created_at": "2026-01-15T09:30:00Z"
}
]
}

Errors

StatusMeaning
401Unauthenticated, invalid token or revoked key.
403Forbidden, session required or org required.
409Already exists, or stale version.
422Validation failed.
429Quota or rate limit exceeded; error.details says which, and when.
500Internal error; quote error.request_id when reporting it.

Every one carries the same envelope.

API overview · Full contract