GET
https://api.unifically.com
/
higgsfield
/
feed
/
{task_id}
Check Status
curl --request GET \
  --url https://api.unifically.com/higgsfield/feed/{task_id} \
  --header 'Authorization: Bearer <token>'
{
  "code": 200,
  "data": {
    "status": "completed",
    "task_id": "472c73ec-ef83-4fdf-83c8-42b00e96deff",
    "output": {
      "video_url": "https://cdn.higgsfield.ai/user_30zROwRpMuD54ShPBakpXT41R5f/a7e78a11-794c-4d73-b224-89c8d746ed07.mp4"
    },
    "error": {}
  }
}
Retrieve the status and results of your Higgsfield generation tasks.

Authentication

All endpoints require authentication using Bearer token authorization:
-H 'Authorization: Bearer YOUR_API_KEY'

Request

curl --request GET \
  --url https://api.unifically.com/higgsfield/feed/aca6c73e-aa4c-47bb-aa62-a100a0f7dd22 \
  --header 'Authorization: Bearer YOUR_API_KEY'
Replace aca6c73e-aa4c-47bb-aa62-a100a0f7dd22 with your actual task_id.

Response

{
  "code": 200,
  "data": {
    "status": "completed",
    "task_id": "472c73ec-ef83-4fdf-83c8-42b00e96deff",
    "output": {
      "video_url": "https://cdn.higgsfield.ai/user_30zROwRpMuD54ShPBakpXT41R5f/a7e78a11-794c-4d73-b224-89c8d746ed07.mp4"
    },
    "error": {}
  }
}

Response Fields

code
integer
default:"200"
HTTP status code (200 for success)
data
object
Task data
status
string
Task status: pending, processing, completed, failed
task_id
string
Unique identifier for the task
output
object
Generation results (available when status is completed)
video_url
string
URL to download the generated video
error
object
Error information (if status is failed)