List Use Cases

List all use cases that have recorded vision events in your workspace. To learn how to create and manage use cases, see the Use Cases documentation.

Required scope: vision-events:read or device:read

List Use Cases

get

List all use cases that have recorded vision events in your workspace.

Authorizations

bearerAuth

AuthorizationstringRequired

Roboflow API key passed as a Bearer token.

Query parameters

statusstring · enumOptional

Filter by use case status. Defaults to active.

Default: activePossible values:

Responses

200

List of use cases.

application/json

lookbackDaysintegerOptional

403

Insufficient permissions for this resource.

application/json

get/vision-events/use-cases

HTTPcURLJavaScriptPython

GET /vision-events/use-cases HTTP/1.1
Host: api.roboflow.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "useCases": [
    {
      "id": "text",
      "name": "text",
      "status": "active",
      "workspaceId": "text",
      "createdAt": "2026-07-19T18:42:10.759Z",
      "updatedAt": "2026-07-19T18:42:10.759Z"
    }
  ],
  "lookbackDays": 1
}

Query Parameters

• status (string, optional): Filter by use case status. One of active or inactive. Defaults to active.

Example Request

curl "https://api.roboflow.com/vision-events/use-cases" \
  -H "Authorization: Bearer YOUR_API_KEY"

Example Response

200

{
  "useCases": [
    {
      "id": "a1b3c8e1",
      "name": "Manufacturing Line 1",
      "status": "active",
      "workspaceId": "my-workspace",
      "createdAt": "2024-01-10T08:00:00.000Z",
      "updatedAt": "2024-01-15T10:30:00.000Z"
    },
    {
      "id": "d4e5f6a7",
      "name": "Warehouse Inventory",
      "status": "active",
      "workspaceId": "my-workspace",
      "createdAt": "2024-01-12T14:00:00.000Z",
      "updatedAt": "2024-01-15T09:00:00.000Z"
    }
  ],
  "lookbackDays": 14
}

403