Search, Order & Retrieve

Every report product is delivered through the same three steps - learn the pattern once and it applies to every report in the catalog.

1. 1
   Search

   Find the target and get its unique identifier.

   
2. 2
   Submit Order

   Order the report. Credits are deducted here.

   
3. 3
   Retrieve Data

   Poll or take the webhook, fetch the dataset.

1. Search - resolve the target company or individual to its unique identifier. Search supports exact and fuzzy matching.
2. Order - submit a data-service order for the target. The order is validated, credits are deducted, and an order number is returned.
3. Retrieve - fetch the dataset with the order number: poll about every 10 seconds (at most 5 requests/second), or skip polling and receive a webhook when the order is ready. If an order can't be fulfilled it is refunded automatically.

The shared endpoints behind these steps — with parameters, response dictionaries and a per-report selector — are documented in API Reference (sign-in required).