Skip to main content
Most LocalAds resources are asynchronous: a request accepts the job, answers 202 Accepted with the resource in its initial state, and the work happens after the response. Each 202 also carries a Location header pointing at the resource, the same URL you poll. Only four things are synchronous: GET requests, creating brands and audiences (201), and the free rewrites (200).

Resource statuses

Each resource’s statuses, exactly as the API returns them: A whole job can succeed while single items inside it fail: a photoshoot can be completed with one failed output, a campaign with one failed creative. Check item-level statuses, not just the job’s.

What a failure means for credits

A failed job or failed item is refunded: credits_charged counts only what completed. Nothing is charged when a request is refused outright (insufficient_credits, credit_limit_exceeded). See Credits and spending.

Reading the result

Poll the Location URL with backoff until the status is terminal. See Polling for the recommended loop, and Creatives for the cross-type list of everything that finished.
Last modified on September 30, 2026