Poll a background task
Poll every few seconds until status is completed, failed or cancelled.
GET
https://app.softsolz.uk/api/v1/services/seo/tasks/{task_id}Recent Requests
Kept only in this browserTimeStatusTook
Send a request with Try it to see it here.
Path Params
task_idstringrequiredHeaders
AuthorizationstringrequiredBearer token: Bearer sk_live_... (or sk_test_... for sandbox). A login token will not work here.
Response
Response Body
idstringBackground task id.kindstringseo.analysis.run, seo.metrics.sync, seo.links.verify or seo.crawl.run.statusstringPoll until completed, failed or cancelled.progressobjectCounters maintained while the task runs.errorstring | nullWhy the task failed, when it did.created_atstringWhen it was queued.started_atstring | nullWhen a worker picked it up.completed_atstring | nullWhen it reached a terminal state.Request
curl --request GET \ --url https://app.softsolz.uk/api/v1/services/seo/tasks/{task_id} \ --header 'Authorization: Bearer sk_live_your_key'Credentials
Sent as a Bearer token and used in the samples above and in Try it. Kept only in this browser tab until you close it. Use an sk_test_ key to stay in your sandbox.
Response · 200
{ "data": { "id": "3f2b9c44-8f4e-4d0a-9c1b-2a7d6e5f1a23", "kind": "seo.analysis.run", "status": "received", "progress": { "total": 1, "processed": 0, "failed": 0 }, "error": null, "created_at": "2026-09-01T09:00:00.000Z", "started_at": null, "completed_at": null }}