---
title: "List Targets"
method: GET
path: "/api/v2/targets"
tags: ["Targets"]
---

# List Targets

`GET /api/v2/targets`

#### Allowed For

* Agents

## Response `200`

Success response

- TargetsResponse
  - `targets` TargetObject[]
    - union
      - object
        - `active` boolean — Whether or not the target is activated
        - `created_at` string, date-time — The time the target was created
        - `id` integer — Automatically assigned when created
        - `title` string, required — A name for the target
        - `type` string, required — A pre-defined target, such as "basecamp_target". See the additional attributes for the type that follow
        - `message_id` string — Can be filled if it is a "message" resource
        - `password` string — The 37Signals password for the Basecamp account (only writable)
        - `project_id` string, required — The ID of the project in Basecamp where updates should be pushed
        - `resource` string, required — "todo" or "message"
        - `target_url` string, required — The URL of your Basecamp account, including protocol and path
        - `todo_list_id` string — Can be filled if it is a "todo" resource
        - `token` string, required — Get the API token from My info > Show your tokens > Token for feed readers or the Basecamp API in your Basecamp account
        - `username` string — The 37Signals username of the account you use to log in to Basecamp
      - object
        - `active` boolean — Whether or not the target is activated
        - `created_at` string, date-time — The time the target was created
        - `id` integer — Automatically assigned when created
        - `title` string, required — A name for the target
        - `type` string, required — A pre-defined target, such as "basecamp_target". See the additional attributes for the type that follow
        - `preserve_format` boolean
        - `room` string, required
        - `ssl` boolean
        - `subdomain` string, required
        - `token` string, required
      - object
        - `active` boolean — Whether or not the target is activated
        - `created_at` string, date-time — The time the target was created
        - `id` integer — Automatically assigned when created
        - `title` string, required — A name for the target
        - `type` string, required — A pre-defined target, such as "basecamp_target". See the additional attributes for the type that follow
        - `api_id` string, required
        - `attribute` string — Read-only
        - `from` string
        - `method` string — Read-only
        - `password` string, required — only writable
        - `target_url` string — Read-only
        - `to` string, required
        - `us_small_business_account` string
        - `username` string, required
      - object
        - `active` boolean — Whether or not the target is activated
        - `created_at` string, date-time — The time the target was created
        - `id` integer — Automatically assigned when created
        - `title` string, required — A name for the target
        - `type` string, required — A pre-defined target, such as "basecamp_target". See the additional attributes for the type that follow
        - `email` string, required
        - `subject` string, required
      - object
        - `active` boolean — Whether or not the target is activated
        - `created_at` string, date-time — The time the target was created
        - `id` integer — Automatically assigned when created
        - `title` string, required — A name for the target
        - `type` string, required — A pre-defined target, such as "basecamp_target". See the additional attributes for the type that follow
        - `api_token` string, required
      - object
        - `active` boolean — Whether or not the target is activated
        - `created_at` string, date-time — The time the target was created
        - `id` integer — Automatically assigned when created
        - `title` string, required — A name for the target
        - `type` string, required — A pre-defined target, such as "basecamp_target". See the additional attributes for the type that follow
        - `account_name` string, required
        - `email` string, required
        - `password` string, required — only writable
        - `target_url` string
      - object
        - `active` boolean — Whether or not the target is activated
        - `created_at` string, date-time — The time the target was created
        - `id` integer — Automatically assigned when created
        - `title` string, required — A name for the target
        - `type` string, required — A pre-defined target, such as "basecamp_target". See the additional attributes for the type that follow
        - `password` string, required — only writable
        - `target_url` string, required
        - `username` string, required
      - object
        - `active` boolean — Whether or not the target is activated
        - `created_at` string, date-time — The time the target was created
        - `id` integer — Automatically assigned when created
        - `title` string, required — A name for the target
        - `type` string, required — A pre-defined target, such as "basecamp_target". See the additional attributes for the type that follow
        - `owner_by` string
        - `project_id` string, required
        - `requested_by` string
        - `story_labels` string
        - `story_title` string, required
        - `story_type` string, required
        - `token` string, required
      - object
        - `active` boolean — Whether or not the target is activated
        - `created_at` string, date-time — The time the target was created
        - `id` integer — Automatically assigned when created
        - `title` string, required — A name for the target
        - `type` string, required — A pre-defined target, such as "basecamp_target". See the additional attributes for the type that follow
        - `secret` string — only writable
        - `token` string
      - object
        - `active` boolean — Whether or not the target is activated
        - `created_at` string, date-time — The time the target was created
        - `id` integer — Automatically assigned when created
        - `title` string, required — A name for the target
        - `type` string, required — A pre-defined target, such as "basecamp_target". See the additional attributes for the type that follow
        - `attribute` string, required
        - `method` string — "get"
        - `password` string — only writable
        - `target_url` string, required
        - `username` string
      - object
        - `active` boolean — Whether or not the target is activated
        - `created_at` string, date-time — The time the target was created
        - `id` integer — Automatically assigned when created
        - `title` string, required — A name for the target
        - `type` string, required — A pre-defined target, such as "basecamp_target". See the additional attributes for the type that follow
        - `content_type` string, required — "application/json", "application/xml", or "application/x-www-form-urlencoded"
        - `method` string, required — "get", "patch", "put", "post", or "delete"
        - `password` string — only writable
        - `target_url` string, required
        - `username` string
      - object
        - `active` boolean — Whether or not the target is activated
        - `created_at` string, date-time — The time the target was created
        - `id` integer — Automatically assigned when created
        - `title` string, required — A name for the target
        - `type` string, required — A pre-defined target, such as "basecamp_target". See the additional attributes for the type that follow
        - `group_id` string
        - `token` string

## Changes

> 29 revisions in range; 1 not diffed.

- **2025-06-12** `9eac011b0efd` — 1 breaking, 1 info
  - added `#/components/schemas/TargetBasecamp, #/components/schemas/TargetCampfire, #/components/schemas/TargetClickatell, #/components/schemas/TargetEmail, #/components/schemas/TargetFlowdock, #/components/schemas/TargetGetSatisfaction, #/components/schemas/TargetJira, #/components/schemas/TargetPivotal, #/components/schemas/TargetTwitter, #/components/schemas/TargetURL, #/components/schemas/TargetHTTP, #/components/schemas/TargetYammer` to the `targets/items/allOf[subschema #2]/` response property `oneOf` list for the response status `200`
  - removed `#/components/schemas/TargetBasecamp, #/components/schemas/TargetCampfire, #/components/schemas/TargetClickatell, #/components/schemas/TargetEmail, #/components/schemas/TargetFlowdock, #/components/schemas/TargetGetSatisfaction, #/components/schemas/TargetJira, #/components/schemas/TargetPivotal, #/components/schemas/TargetTwitter, #/components/schemas/TargetURL, #/components/schemas/TargetHTTP, #/components/schemas/TargetYammer` from the `targets/items/allOf[subschema #2]/` response property `anyOf` list for the response status `200`

[Change history](https://skmtc.dev/botbrains-io/apis/support-api/changes/api/v2/targets/get.md)

---

[API](https://skmtc.dev/botbrains-io/apis/support-api.md) · [All operations](https://skmtc.dev/botbrains-io/apis/support-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/botbrains-io/support-api/revisions/d53eac07ba68/schema)