Documentation

Quickstart

Get your first API call working in under a minute.

1. Create a free account (no card required).
2. After signing in, go to Dashboard → API Keys and generate one. Copy the plaintext — it's shown only once.
3. Make a request.

curl -X POST https://api.snipget.ai/common/phone/format \
  -H "Authorization: Bearer sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{"phone": "800 555-1234", "country": "US"}'

Response:

{
  "status": "ok",
  "confidence": 1.0,
  "result": {
    "e164": "+18005551234",
    "national": "(800) 555-1234",
    "country_code": "US",
    "valid": true
  },
  "meta": {
    "version": "0.1.0",
    "elapsed_ms": 2,
    "cost_units": 1,
    "request_id": "req_abc123..."
  }
}

Response envelope

Every endpoint returns the same shape. Successful responses have status: "ok", errors have status: "error". Every response includes a confidence score and meta block.

Authentication

Send your API key via the Authorization: Bearer ... header, or alternatively X-API-Key.

Rate limiting

Limits depend on your tier. 429 responses include exact retry_after_seconds, limit_type, and current_tier so your agent can back off correctly.

Full API reference

Every endpoint is documented in the interactive OpenAPI spec.

MCP integration

Snipget exposes the full utility catalog as an MCP server. In Claude Desktop, Cursor, Windsurf, or any MCP-aware environment, configure the server URL and your API key — your agent will discover every utility automatically.