Skip to content

Idempotency key

An idempotency key is a unique value a client sends with a request so that retrying it does not repeat the action or the charge.

Networks fail in the middle of a request. If a client submits a job and the connection drops before the response arrives, it cannot tell whether the job was created. Resending blindly might create a second job and a second charge.

With an idempotency key, the client generates a unique value, such as a UUID, and sends it with the request. The server remembers the result for that key and returns the same outcome if the key shows up again. The key must be new for each distinct operation and reused only when retrying the same one.

On 1lookup.dev, bulk jobs take an idempotency key, so a retried submission returns the original job instead of starting another. Generate the key before the first attempt and store it with your own record of the job.

[ Validate ][ Enrich ]
[Get started]

Run your first lookup in two minutes

Create a key, pick a plan and call any product in the catalog. Plans start at $29 a month.

[ Screen ][ Scrape ]