---
title: "List face detection jobs"
method: GET
path: "/face-detect"
tags: ["Face Detection"]
---

# List face detection jobs

`GET /face-detect`

## Request

- Base URL: `https://api.cloudglue.dev/v1`
- URL: `https://api.cloudglue.dev/v1/face-detect`
- Auth: HTTP bearer

List all face detection jobs

## Query parameters

- `limit` integer
- `offset` integer
- `created_before` string, date
- `created_after` string, date
- `status` 'pending' | 'processing' | 'completed' | 'failed'

## Response `200`

Face detection jobs retrieved successfully

- FaceDetectionListResponse
  - `object` 'list', required: Object type, always 'list'
  - `total` integer, required: The total number of items
  - `limit` integer, required: The number of items per page
  - `offset` integer, required: The offset of the items
  - `data` object[]
    - `job_id` string, uuid, required: Unique identifier for the face detection job
    - `frame_extraction_id` string, uuid: ID of the frame extraction used
    - `file_id` string, uuid: ID of the target file
    - `status` 'pending' | 'processing' | 'completed' | 'failed', required: Status of the face detection job
    - `created_at` number, required: Unix timestamp in milliseconds when the job was created
    - `total_faces` integer: Total number of faces detected

## Changes

- **2026-03-11** `1d5d6115c0d0`: 2 breaking
  - for the `query` request parameter `limit`, default value `50` was removed
  - for the `query` request parameter `offset`, default value `0` was removed
- **2026-01-02** `9d805815496c`: 3 info
  - added the new optional `query` request parameter `created_after`
  - added the new optional `query` request parameter `created_before`
  - added the new optional `query` request parameter `status`
- **2025-12-22** `fd6b2376db4d`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/cloudglue/apis/cloudglue-api/changes/face-detect/get.md)

---

[API](https://skmtc.dev/cloudglue/apis/cloudglue-api.md) - [All operations](https://skmtc.dev/cloudglue/apis/cloudglue-api/llms.txt) - [OpenAPI document](https://skmtc.dev/cloudglue/apis/cloudglue-api/revisions/23d3f240819f?raw)