---
title: "Get Objective"
method: GET
path: "/v2/objectives/{objectives_id}"
tags: ["Objectives"]
---

# Get Objective

`GET /v2/objectives/{objectives_id}`

This endpoint returns a single objective by its unique identifier.

## Path parameters

- `objectives_id` string, required

## Response `200`

Successfully retrieved objective

- object
  - `data` object
    - `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
    - `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

## Other responses

- `400` — Bad Request
- `401` — UNAUTHORIZED
- `404` — Not Found

---

[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)