Skip to main content
POST
/
programmatic
/
verify-email
cURL
curl -X POST https://apx.didit.me/auth/v2/programmatic/verify-email/ \
  -H "Content-Type: application/json" \
  -d '{
    "email": "you@yourdomain.com",
    "code": "A3K9F2"
  }'
{
  "access_token": "eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9...",
  "refresh_token": "eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9...",
  "expires_in": 86400,
  "organization": {
    "uuid": "a1b2c3d4-5678-90ab-cdef-111111111111",
    "name": "developer"
  },
  "application": {
    "uuid": "b2c3d4e5-6789-01bc-defg-222222222222",
    "name": "developer",
    "client_id": "S9LIYGSoWNuGMLHsvEt9dQ",
    "api_key": "05mHcOWL8GathLZlz8oIDawYj9qFAcoSHtz-75PAkuo"
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.didit.me/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
x-api-key
string
header
required

Body

application/json
​
email
string<email>
required

Email used during POST /programmatic/register/.

Example:

"you@yourdomain.com"

​
code
string
required

6-character alphanumeric code from the verification email. Codes expire 15 minutes after registration.

Required string length: 6
Example:

"A3K9F2"

Response

Email verified. The response contains tokens for this auth API plus the brand-new application's client_id and api_key. Persist the api_key securely — it is the long-lived credential used by every verification API call.

​
access_token
string

RS256-signed JWT. Use as Authorization: Bearer <token> for Account Management endpoints on apx.didit.me/auth/v2.

​
refresh_token
string

Refresh token paired with the access token.

​
expires_in
integer

Lifetime of the access token in seconds (default 86400).

Example:

86400

​
organization
object

Minimal organization shape returned inline by POST /programmatic/verify-email/.

​
application
object

Minimal application shape returned inline by POST /programmatic/verify-email/. Persist the api_key immediately.