Get Requirement Statuses

GET/api/requirements/[id]/status

Retrieves a list of requirement statuses, showing the history and progress of a specific requirement.

Path Parameters

Parameter	Type	Required	Description
`id`	`string`	Yes	The ID of the requirement to fetch statuses for.

Query Parameters

Parameter	Type	Required	Description
`site_id`	`string`	No	Filter statuses for a specific site ID.
`instance_id`	`string`	No	Filter statuses generated by a specific instance ID.
`status`	`string`	No	Filter by a specific status string (e.g., ‘in-progress’, ‘completed’).
`limit`	`number`	No	The maximum number of statuses to return. Default: `50`, Max: `100`.
`offset`	`number`	No	The number of statuses to skip before returning results. Default: `0`.

Example Request


curl -X GET "https://api.makinari.com/api/requirements/req_123/status?limit=10" \
  -H "Authorization: Bearer YOUR_API_KEY"

Response

Returns a list of requirement statuses along with pagination information, ordered by creation date descending.


{
  "success": true,
  "data": {
    "statuses": [
      {
        "id": "stat_123",
        "site_id": "site_456",
        "instance_id": "inst_789",
        "asset_id": null,
        "requirement_id": "req_123",
        "repo_url": "https://github.com/...",
        "preview_url": "https://preview...",
        "status": "in-progress",
        "message": "Starting work on this feature",
        "created_at": "2023-10-25T10:00:00Z"
      }
    ],
    "pagination": {
      "total": 150,
      "count": 10,
      "has_more": true,
      "limit": 10,
      "offset": 0
    }
  }
}