Use Public API v2
Call seven stable lookup products, create one of four bounded scans and read tenant-scoped retained job state.
Use the executable quickstart
Open /docs/api/quickstart for the current generated route, environment-variable key setup, first completed lookup, accepted-job polling and paginated result retrieval flow.
Submit exact product intent
Every write uses a workspace application key, JSON content type and Idempotency-Key. A scan target contains type and value, profile is quick, balanced, deep or advanced, and options.maxCredits is required.
curl -sS -X POST "${TIGESS_API_BASE_URL}/v2/scans" \
-H "Authorization: Bearer ${TIGESS_API_KEY}" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: first-quick-scan-1" \
--data '{"target":{"type":"domain_name","value":"example.org"},"profile":"quick","options":{"active":false,"maxCredits":100}}'Distinguish completed and accepted
MAC, phone, IP and DNS return a bounded 200 projection. Domain, mail, web/TLS and scans return 202 with an opaque jobRef. Poll /v2/jobs/{job_ref}, then page /results or /findings using the required read scope.
Preserve errors and coverage
Honor Retry-After on rate limits, reuse an idempotency key only for the identical normalized write, and retain partial, unavailable, evidence-summary and limitation fields. See /docs/api/governance for generated machine-code parity.