Get Task Status

Check the current status of an existing task.

GEThttps://api.flimpa.com/api/v1/tasks/:taskId

Request

Path Parameters

Name	Type	Description
taskId*	string	The unique identifier of the task.

Headers

Name	Type	Description
X-Task-Access-Token*	string	The `accessToken` returned when the task was created.

Example

RequestcURL

curl "https://api.flimpa.com/api/v1/tasks/550e8400-e29b-41d4-a716-446655440000" \
  -H "X-Task-Access-Token: YOUR_ACCESS_TOKEN" \
  -H "X-API-Key: flp_live_YOUR_API_KEY"

Response

Returns the current status of the task.

json

{
  "taskId": "550e8400-e29b-41d4-a716-446655440000",
  "status": "COMPLETED",
  "pollUrl": "/api/v1/tasks/550e8400-e29b-41d4-a716-446655440000",
  "accessToken": "1735689600000.a1b2c3d4e5f6..."
}

Possible statuses:

PENDING: Task is queued.
PROCESSING: Task is currently being processed.
COMPLETED: Task finished successfully. You can now download the result.
FAILED: Task failed. The response will include an error and code field.