← Customer pilot application

Customer pilot integration guide

Choose the result you need

Basic phone checks return format and validity, not possession. Identity onboarding returns hosted document, liveness, face-match and provider decisions; your system owns the business decision.

Apply, get approval and integrate

  1. Register a merchant account, verify email, then select task, country and required capabilities.
  2. Wait for the owner to confirm purpose, supplier terms, agreements and free allowance. Applying does not activate access or charge you.
  3. After approval, create a read-write API key in the merchant console. Read capabilities first; invoke only capabilities with available=true.
  4. Generate request and consent-reference UUIDs per business request. Obtain subject consent first; retries must reuse the same request UUID and parameters.
  5. Read phone results directly. For identity, let the subject complete the hosted link, then read or refresh the existing record. Never approve based only on the return page.

API and MCP

API base path:https://gridzen.ai/console/api/production. Use Bearer authentication with your merchant key; provider keys stay on the server.

GET /capabilities
POST /verifications
GET /verifications/{id}
POST /verifications/{id}/refresh

Agents use the separate production-pilot MCP; public research MCP and offline Skills remain for research and prototypes.

Download production pilot MCP client
python3 -m venv .venv
.venv/bin/python -m pip install mcp==2.3.0 httpx==0.28.1
# Set GRIDZEN_API_KEY in your local MCP configuration
# Command: .venv/bin/python production_mcp.py

Handling problems

401: check key and email verification. 403: check approval and permissions. 409: check UUID parameter changes. 429: wait or check request limits. 503: capability, free allowance or expiry blocks access. After creation timeout, read the original record; never create a replacement request.

completed means a final provider result exists; still inspect provider_result.status. Handle Approved, Declined and In Review separately. Unknown, timeout and incomplete are not approval or evidence of fraud.

Read pilot terms · View live verification