Verifier API

Sponsor verification API

Ask one question, which accountable sponsor stands behind this agent , and get a signed answer. The API delegates the actual verification to the edge resolver; you never integrate with individual issuers.

Try it

Run a name check

Calls POST /check/name/:name on the verifier API with a demo key. The response includes the sponsor and verification result.

@

Base URL

https://verify.idn.global

Authentication

Every call carries a verifier API key as a bearer token. Keep the key server-side; this site proxies calls so the key is never exposed to the browser.

Authorization: Bearer <your verifier key>

Endpoints

POST /verify

Full hosted verification of a compact JWS attestation.

POST https://verify.idn.global/verify
Authorization: Bearer <key>

{ "token": "eyJhbGciOiJFZERTQSJ9..." }

-> {
  "verification": { "valid": true, "sponsor_class": "bank", "tenure_bucket": "T3" }
}

POST /check/name/:name

Simple name check, answered from the resolver. Add ?revocation=true for a fresh revocation lookup.

POST https://verify.idn.global/check/name/acme.payments?revocation=false
Authorization: Bearer <key>

-> {
  "name": "acme.payments",
  "valid": true,
  "sponsor_class": "bank",
  "tenure_bucket": "T3"
}

POST /account/rotate-key

Rotate the API key. The previous key is invalidated immediately.

POST https://verify.idn.global/account/rotate-key
Authorization: Bearer <key>

Status codes

  • 200, check ran; see verification/valid.
  • 404, name_not_found at the edge.
  • 409, version_negotiation_failed on a spec-version mismatch.

SDK

Most verifiers integrate with @idn-network/sdk-verifierrather than calling the API by hand. See the SDK pagefor the five-line integration.