lookup

Read progress for an active browser lookup

Returns coarse progress emitted by work the lookup engine actually started or completed. Progress is short-lived and bound to the same opaque X-Lookup-Session supplied to POST /api/lookup; a missing or mismatched session returns 404. Snapshots never contain the lookup input or result data.

get/api/lookup/progress

Request

  • Base URL: https://lookup.disclose.io
  • URL: https://lookup.disclose.io/api/lookup/progress
  • Auth: one of:
    • none
    • HTTP bearer
    • API key in header X-API-Key

Query parameters

requestIdstring required

The X-Request-Id supplied to the active lookup request.

Headers

X-Request-Idstring

Caller-supplied request identifier. Must match ^[A-Za-z0-9._:-]+$ and be at most 128 characters. Replaced with a server-generated req_<uuid> if absent or malformed. Echoed on every response.

X-Lookup-Sessionstring

Stable opaque browser/client identifier used only to give individual users a fair new-work allowance behind shared NATs. Must be 20–128 characters from A-Z a-z 0-9 . _ : -. Create once and persist; do not rotate per request. Missing or malformed values fall back to IP policy. API-key requests use their key quota instead.

Response

Current progress snapshot.

requestIdstring required
status'active' | 'complete' | 'error' required
updatedAtstring date-time required

Changes

No recorded changes to this operation across all 1 revision of this API.