Developer Portal

curl -X POST https://uat.gateway.verify-group.io/api/v1/developers/register \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"organizationId": "'$ORG_ID'", "type": "organization", "tier": "starter"}'

curl -X POST https://uat.gateway.verify-group.io/api/v1/oauth-apps \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"name":"My Integration","type":"server","organizationId":"'$ORG_ID'","scopes":["kyc:read","claims:read","voice:read"]}'

{
  "data": {
    "clientId": "vg_client_...",
    "clientSecret": "vg_secret_...",
    "status": "active"
  }
}

# Generate a key
curl -X POST https://uat.gateway.verify-group.io/api/v1/developers/$DEVELOPER_ID/api-keys \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -d '{"name":"production","permissions":["kyc:read","claims:read"]}'

# Use it
curl https://uat.gateway.verify-group.io/api/v1/kyc/verifications \
  -H "X-API-Key: vg_live_xxxxx" \
  -H "X-Organization-ID: $ORG_ID"

curl -X POST https://uat.gateway.verify-group.io/api/v1/oauth/token \
  -u "$CLIENT_ID:$CLIENT_SECRET" \
  -d "grant_type=client_credentials&scope=kyc:read claims:read"

curl -X POST https://uat.gateway.verify-group.io/api/v1/tokens/purchase \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H "X-Organization-ID: $ORG_ID" \
  -d '{"amount": 1000, "currency": "KES"}'

curl https://uat.gateway.verify-group.io/api/v1/tokens/me/balance \
  -H "Authorization: Bearer $ACCESS_TOKEN"

curl -X POST https://uat.gateway.verify-group.io/api/v1/kyc/verifications \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H "X-Organization-ID: $ORG_ID" \
  -H "Content-Type: application/json" \
  -d '{"participant_id":"<uuid>","type":"individual","scenario":"identity","payload":{"identifier_type":"national_id","identifier_number":"12345678","country":"KE"}}'