---
title: "List Goals"
method: GET
path: "/v1/goals"
tags: ["Goals"]
---

# List Goals

`GET /v1/goals`

## Request

- Base URL: `https://api.oviond.com`
- URL: `https://api.oviond.com/v1/goals`
- Auth: one of:
  - HTTP bearer
  - HTTP bearer

List all goals for the current account, optionally filtered by client_id

## Query parameters

- `client_id` string

## Response `200`

Goals list

- ListGoalsResponse
  - `success` true, required
  - `data` Goal[], required
    - `id` string, required
    - `account_id` string, required
    - `client_id` string, nullable
    - `name` string, required
    - `description` string, nullable
    - `target_value` number, required
    - `operator` '>=' | '=' | '<=', required
    - `goal_type` 'static' | 'change', required
    - `symbol` string, nullable
    - `query` GoalQuery
      - `datasource_id` 'advanced-web-ranking' | 'ac' | 'adroll' | 'ahrefs' | 'basecamp' | 'brightlocal' | 'call-rail' | 'drip' | 'keywords' | 'sendin-blue' | 'sendgrid' | 'moosend' | 'mailer-lite' | 'pingdom' | 'uptime-robot' | 'piwik-pro' | 'wordpress' | 'pabbly-connect' | 'ment' | 'twilio' | 'switchy' | 'vimeo' | 'pinterest' | 'pinterest-ads' | 'gtres' | 'paypal' | 'gps' | 'gs' | 'CUSTOM_IMPORT' | 'CUSTOM_DATA' | 'CALCULATION' | 'GOALS' | 'str' | 'wistia' | 'ca-mon' | 'convertkit' | 'woocommerce' | 'xero' | 'matomo' | 'go-high-level' | 'wcs' | 'bing-webmaster-tools' | 'pipedrive' | 'salesforce' | 'tiktok' | 'tiktok-ads' | 'twr' | 'twr-ads' | 'spf' | 'ytbe' | 'google-local-services-ads' | 'klaviyo' | 'gsh' | 'ga4' | 'lkdin-ads' | 'lkdin-pg' | 'mlchmp' | 'inst-ads' | 'inst' | 'fb-ads' | 'fb-pg' | 'gmb' | 'serpstat' | 'hubspot' | 'gadw' | 'sem-rush' | 'se-ranking' | 'microsoft-ads' | 'plausible' | 'snapchat-ads' | 'microsoft-clarity' | 'serp-watch' | 'vbout' | 'moz' | 'chatgpt-ads' | 'omnisend' | 'airtable' | 'nozzle' | 'surnex' | 'jira' | 'clickup' | 'make' | 'freshdesk' | 'chart-mogul' | 'amplitude' | 'harvest' | 'zoho-crm' | 'clockify' | 'adtraction' | 'shopify' | 'copper' | 'help-scout-docs' | 'close-crm' | 'simplesat' | 'help-scout-mailbox' | 'demo'
      - `data_view` string
      - `metrics` MetricSelection[]
        - `value` string, required
        - `label` string
        - `data_view` string
      - `dimensions` DimensionSelection[]
        - `value` string, required
        - `label` string
        - `data_view` string
      - `filters` WidgetFilter[]
        - `id` union
          - number
          - string
        - `field` string
        - `operator` string: Canonical: equals, not_equals, contains, not_contains, starts_with, ends_with, greater_than, less_than, greater_than_or_equal, less_than_or_equal (vendor tokens also accepted).
        - `value` union
          - string
          - number
          - boolean
          - unknown[]
            - unknown
        - `logicalOperator` 'and' | 'or'
      - `advanced` object
      - `date_range` object, nullable
        - `current_start` string, nullable
        - `current_end` string, nullable
        - `previous_start` string, nullable
        - `previous_end` string, nullable
      - `show_custom_date_range` boolean, nullable
    - `created_at` unknown
    - `updated_at` unknown

## Changes

- **2026-10-20** `4cb0a07daf41`: 1 info
  - removed the `amazon-advertising` enum value from the `data/items/query/datasource_id` response property for the response status `200`

[Operation history](https://skmtc.dev/oviond/apis/oviond-backend-api/changes/v1/goals/get.md)

---

[API](https://skmtc.dev/oviond/apis/oviond-backend-api.md) · [All operations](https://skmtc.dev/oviond/apis/oviond-backend-api/llms.txt) · [OpenAPI document](https://skmtc.dev/oviond/apis/oviond-backend-api/revisions/4cb0a07daf41?raw)