Async API User Guide

Updated: May 21, 2026

Copy for LLM

Ads in WhatsApp Status are available via the Marketing API. Learn more about ads in WhatsApp Status.

Asynchronous computing is a paradigm where the user does not expect the system to execute a workload immediately; instead, the system schedules it for execution sometime in the near future without blocking the latency-critical path of the application. This page gives you guidance and the best practices to follow to retrieve the results of the async API.

Poll the async session ID for results

Request

curl -G -X GET \
  -d 'fields=id,status,result' \
  -d 'access_token=<ACCESS_TOKEN>' \
  "https://graph.facebook.com/v26.0/<ASYNC_SESSION_ID>"

Response

{
  "id": "<ASYNC_SESSION_ID>",
  "status": "enum string",
  "result": "string"
}

Response parameters

Name	Description
`id` numeric string	The ID of the async request. Also known as the `ASYNC_SESSION_ID`.
`status` enum string	The status of the async job. Values: `UNKNOWN` `NOT_STARTED` `IN_PROGRESS` `COMPLETED` `FAILED`
`result` string	The result as returned by the async job. For details, look at the corresponding API call’s success and failure responses.

Polling best practices

The polling requests also count towards the overall API rate limit for your application. Consider using exponential backoff for polling.