---
title: "Find goals"
method: GET
path: "/goals/find"
tags: ["Goals"]
---

# Find goals

`GET /goals/find`

Returns data about goals based on criteria. For searching, append `{searchField}={searchValue}` to the URL, where `searchField` can be any one of the lowest-level fields in dot-notation (e.g. `type.params.pipeline_id`; `title`). `searchValue` should be the value you are looking for on that field. Additionally, `is_active=<true|false>` can be provided to search for only active/inactive goals. When providing `period.start`, `period.end` must also be provided and vice versa.

## Query parameters

- `type.name` 'deals_won' | 'deals_progressed' | 'activities_completed' | 'activities_added' | 'deals_started'
- `title` string
- `is_active` boolean
- `assignee.id` integer
- `assignee.type` 'person' | 'company' | 'team'
- `expected_outcome.target` number
- `expected_outcome.tracking_metric` 'quantity' | 'sum'
- `expected_outcome.currency_id` integer
- `type.params.pipeline_id` integer[]
- `type.params.stage_id` integer
- `type.params.activity_type_id` integer[]
- `period.start` string, date
- `period.end` string, date

## Response `200`

Successful response containing payload in the `data.goal` object

- object
  - `success` boolean — If the request was successful or not
  - `data` object
    - `goals` object[]
      - `id` string — The ID of the goal
      - `owner_id` integer — The ID of the creator of the goal
      - `title` string — The title of the goal
      - `type` object — The type of the goal
        - `name` string — The name of the goal type
        - `params` object — The parameters that accompany the goal type
          - `pipeline_id` integer[] — The IDs of pipelines of the goal
          - `activity_type_id` integer[] — The IDs of activity types of the goal
      - `assignee` object — Who the goal is assigned to
        - `id` integer — The ID of the goal assignee
        - `type` string — The type of the assignee
      - `interval` string — The interval of the goal
      - `duration` object — The duration of the goal
        - `start` string — The start date of the goal
        - `end` string — The end date of the goal
      - `expected_outcome` object — The expected outcome of the goal
        - `target` integer — The numeric target of the goal
        - `tracking_metric` string — The tracking metric of the goal
      - `is_active` boolean — Whether the goal is currently active or not
      - `report_ids` string[] — The IDs of the reports that belong to the goal

---

[API](https://skmtc.net/pipedrive/apis/pipedrive-api-v1.md) · [All operations](https://skmtc.net/pipedrive/apis/pipedrive-api-v1/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/pipedrive/pipedrive-api-v1/revisions/bf863a979545/schema)