API Keys

Generate a free API key

Generates a free API key with 200 requests/month quota (batch validation counts 1 request per IBAN). The first key issued to a network is instant. A repeat creation from the same network within 7 days must prove the mailbox is readable: that call answers 403 "verification_required" and mails a 6-digit code to the address supplied, and the SAME request is then repeated with a "code" field within 15 minutes. At most 3 keys per network per day. A caller that cannot receive mail does not need this endpoint at all: prepaid credits (POST /v1/credits/buy/1k) and x402 pay-per-call need no key.

post/v1/keys/generate

Request body

emailstring email required

Email address for key registration

codestring

Optional. The 6-digit code mailed after a 403 "verification_required". Repeat the same request with it within 15 minutes; omit it to be mailed a fresh one. The challenge locks after 5 wrong attempts.

Example request

{
  "code": "123456"
}

Response

API key generated (shown only once)

Changes