API v1

Programmatic OSINT.

Bearer-token auth, JSON in/out, one credit per lookup — same credit pool as the web dashboard. Pro or Enterprise plan required. Full OpenAPI 3.1 spec at /api/openapi.json.

Create a lookup

POST /api/v1/lookups

curl -X POST https://letmecreep.app/api/v1/lookups \
  -H "Authorization: Bearer lmc_live_..." \
  -H "Content-Type: application/json" \
  -d '{"phone": "+14155552671"}'

Returns { ok:true, data:{ snapshotUid, balance } }. Poll GET /api/v1/lookups/{uid} until status is done or partial (typically 5–20s).

Get a snapshot

GET /api/v1/lookups/{uid}

curl https://letmecreep.app/api/v1/lookups/{snapshotUid} \
  -H "Authorization: Bearer lmc_live_..."

Rate limits

Default 60 requests / minute per API key (configurable when you create the key). Exceeding returns HTTP 429.

Error codes

HTTP	Code	Meaning
400	invalid_phone	Number couldn't be parsed.
401	unauthorized	Missing or revoked API key.
402	insufficient_credits	Buy more credits.
429	rate_limited	Slow down — see rate limits.