---
title: "Get Objectives"
method: GET
path: "/v2/objectives"
tags: ["Objectives"]
---

# Get Objectives

`GET /v2/objectives`

This endpoint returns a list of all objectives.

## Query parameters

- `limit` integer
- `page` integer

## Response `200`

Successfully retrieved objectives

- object
  - `data` object[] — Objectives for the current page; use `total_count` for the full count.
    - `objectives_id` string — Unique identifier for the objective
    - `objective_name` string — Name of the objective
    - `objective_prompt` string — The detailed prompt that defines what the objective should accomplish
    - `confirmation_mode` string — How the objective completion should be confirmed
    - `output_variables` string[] — List of variables that should be extracted or collected during the objective
    - `modality` string — The communication modality for the objective
    - `next_conditional_objectives` object — Mapping of objective names to conditions that must be satisfied for that objective to be activated. Use this to write multiple conditional objectives
    - `next_required_objective` string — The name of the next required objective that will be activated once the current objective is completed. Use this to write a single next required objective without conditions
    - `callback_url` string — URL that will receive notifications when the objective is completed
    - `created_at` string — ISO 8601 timestamp of when the objective was created
    - `updated_at` string — ISO 8601 timestamp of when the objective was last updated
  - `total_count` integer — The total number of objectives

## Other responses

- `401` — UNAUTHORIZED

---

[API](https://skmtc.dev/tavus/apis/tavus-developer-api-collection.md) · [All operations](https://skmtc.dev/tavus/apis/tavus-developer-api-collection/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/tavus/tavus-developer-api-collection/revisions/c878e2f6508d/schema)