---
title: "Get Tasks by Status"
method: GET
path: "/ai/embeddings"
tags: ["Embeddings"]
---

# Get Tasks by Status

`GET /ai/embeddings`

Retrieve tasks for the user that are either `queued`, `processing`, `failed`, `success` or `partial_success` based on the query string. Defaults to `queued` and `processing`.

## Query parameters

- `status` string[] — List of task statuses i.e. `status=queued&status=processing`

## Response `200`

Successful Response

- BackgroundTasksQueryResponseData
  - `data` BackgroundTasksQueryResponse[], required
    - `user_id` string, required
    - `task_id` string, required
    - `task_name` string, required
    - `status` 'queued' | 'processing' | 'success' | 'failure' | 'partial_success', required — Status of an embeddings task.
    - `created_at` string, date-time, required
    - `finished_at` string, date-time
    - `bucket` string

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/team-telnyx/apis/telnyx-api-2.md) · [All operations](https://skmtc.net/team-telnyx/apis/telnyx-api-2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/team-telnyx/telnyx-api-2/versions/8f5f4e537994/schema)