Skip to main content
GET
/
v1
/
tasks
Get Task Status
curl --request GET \
  --url https://api.loova.ai/api/v1/tasks \
  --header 'Authorization: Bearer <token>'
{
  "code": 200,
  "trace_id": "45c30d76f06549b199a3775544515689",
  "message": null,
  "data": {
    "task_id": "record_id",
    "status": "succeeded",
    "model": "seedance_2_0",
    "created_at": "2024-01-01T12:00:00Z",
    "updated_at": "2024-01-01T12:00:05Z",
    "credits_cost": 12,
    "result": {
      "video_url": "https://example.com/video.mp4",
      "error_message": null,
      "finished_at": "2024-01-01T12:02:00Z"
    }
  }
}
Returns the current status of a task and the final result when available.

​
Authentication

Include your API key in the Authorization header: 
Authorization: Bearer <api_key>

​
Response Format

All responses follow the same envelope: 
{
  "code": 200,
  "trace_id": "xxxxxx",
  "message": null,
  "data": {}
}

​
Endpoint

GET https://api.loova.ai/v1/tasks?task_id=<record_id>

​
Query Parameters

ParameterTypeRequiredDescription
task_idstringYesThe task_id returned by the create task endpoint

​
Success Response

{
  "code": 200,
  "trace_id": "45c30d76f06549b199a3775544515689",
  "message": null,
  "data": {
    "task_id": "record_id",
    "status": "succeeded",
    "model": "seedance_2_0",
    "created_at": "2024-01-01T12:00:00Z",
    "updated_at": "2024-01-01T12:00:05Z",
    "credits_cost": 12.0,
    "result": {
      "video_url": "https://...",
      "error_message": null,
      "finished_at": "2024-01-01T12:02:00Z"
    }
  }
}

​
Response Fields

FieldTypeDescription
task_idstringUnique task identifier
statusstringCurrent task status
modelstringModel used for generation
created_atstringTask creation time in ISO 8601 format
updated_atstringLast task update time in ISO 8601 format
credits_costnumberCredits charged for this task
resultobject | nullFinal result payload. May be null while the task is still in progress

​
result Fields

FieldTypeDescription
video_urlstring | nullOutput video URL when the task succeeds
error_messagestring | nullError message when the task fails
finished_atstring | nullTask completion time in ISO 8601 format

​
Notes

  • result may be null while the task is still in progress
  • When the task succeeds, the generated video URL is returned in data.result.video_url
  • When the task fails, error details may be returned in data.result.error_message

​
cURL Example

curl -X GET "https://api.loova.ai/v1/tasks?task_id=<record_id>" \
  -H "Authorization: Bearer <api_key>"

​
Error Response

All failed requests follow the same response envelope structure: 
{
  "code": 400,
  "trace_id": "45c30d76f06549b199a3775544515689",
  "message": "Detailed error message",
  "data": null
}
  • code != 200 indicates the request failed
  • message contains the specific error reason, such as invalid parameters, authentication failure, or task lookup failure

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

​
task_id
string
required

The task_id returned by the create task endpoint

Response

Successful response

​
code
integer
​
trace_id
string
​
message
string | null
​
data
object