Poll task status

GET

/v1/tasks/{task_id}

Poll every 5-10 seconds. This endpoint allows up to 120 requests per minute per API key.

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Path Params

Responses

🟢200

application/json

Task status

Bodyapplication/json

🟠404

🟠401Unauthorized

🟠429RateLimited

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://api.beatapi.io/v1/tasks/task_8K2qA' \
--header 'Authorization: Bearer <token>'

Response Example

200 - Accepted and waiting

{
    "data": {
        "id": "task_8K2qA",
        "object": "task",
        "workflow": "music-video",
        "status": "queued",
        "stage": "queued",
        "storyboard": {
            "shots": []
        },
        "created_at": 1782210000,
        "updated_at": 1782210000,
        "completed_at": null,
        "output": null,
        "usage": {
            "credits_reserved": 75,
            "credits_charged": 75,
            "billable_duration_seconds": 15,
            "credits_settled": 0,
            "credits_refunded": 0
        },
        "request_id": "req_abc123",
        "error_code": null,
        "error_message": null
    }
}

Modified at 2026-07-31 15:10:04

List launch workflows

Get account usage and concurrency