> ## Documentation Index
> Fetch the complete documentation index at: https://docs.workfloo.ws/llms.txt
> Use this file to discover all available pages before exploring further.

# How to run async APIs

> What are asynchronous APIs and how to use them

<div className="relative pt-[56.25%]">
  <iframe src="https://customer-1zc4ejigeg1ncomz.cloudflarestream.com/2d273260d9048a66f58800ed336ce77f/iframe?poster=https%3A%2F%2Fcustomer-1zc4ejigeg1ncomz.cloudflarestream.com%2F2d273260d9048a66f58800ed336ce77f%2Fthumbnails%2Fthumbnail.jpg%3Ftime%3D%26height%3D600&title=How+to+run+async+APIs" loading="lazy" className="absolute top-0 left-0 w-full h-full border-0 rounded-xl" allow="accelerometer; gyroscope; autoplay; encrypted-media; picture-in-picture;" allowFullScreen />
</div>

## What are async APIs?

Asynchronous API endpoints let you start jobs that may take some time to complete, such as research or crawling tasks. Instead of waiting for an immediate response, you receive a job ID and can check the status or retrieve results once the job is finished.

## How to run

<Steps>
  <Step title="Create job">
    Make a request to async API endpoint (e.g. deep version of Similar companies API: `POST /companies/similar/deep`). In a response you will receive a job ID.
  </Step>

  <Step title="Check status">
    Make a `GET /jobs/{jobId}` request to check job status. Until the job is completed, the response will include `status: "pending"` or `status: "processing"`.
  </Step>

  <Step title="Retrieve results">
    When the job is completed (`status: "completed"`), you will receive results in the response to your request for check status (`GET /jobs/{jobId}`). Job results are **available for 24 hours**.
  </Step>
</Steps>
