---
title: "Get Priority Opportunities Data"
method: GET
path: "/opportunities/priority"
tags: ["OPPORTUNITIES"]
---

# Get Priority Opportunities Data

`GET /opportunities/priority`

Top-N curated priority opportunities for the tenant (read-only).

AI-7715: honors the same Discover chip vocabulary as GET /opportunities/
(all params optional; dates accepted-but-ignored per Q1 Option A).

## Query parameters

- `navigationSource` string, nullable
- `effort` string[]
- `resource_name` string[]
- `resource_type` string[]
- `owner` integer[]
- `user` string[]
- `status` string[] — Opportunity statuses (multi-value: repeat the param, ?status=active&status=closed). Accepted, case-insensitive: active, implemented, closed, dismissed (legacy alias: discarded). Omitted → the listing defaults to ['active'] when omitted; pass the param explicitly to include other statuses. A selection that matches no known status returns no rows.
- `opportunity_name` string[]
- `secondary_resource` string[]
- `warehouse` string[]
- `start_date` string, date-time, nullable — Accepted for Discover URL parity but NOT applied to the curated list — enforcing the FE's 28-day default window would change the tab's default no-chip view (AI-7715 Q1 Option A).
- `end_date` string, date-time, nullable — Accepted for Discover URL parity but NOT applied to the curated list — see start_date (AI-7715 Q1 Option A).
- `workspace_id` string[] — Databricks workspace IDs (multi-value). Sourced from the More-Filters Workspace chip; ignored on non-Databricks tenants.

## Headers

- `x-tenant` string, required

## Response `200`

Successful Response

- PriorityOpportunityResponse[]
  - `opportunity_id` string, required
  - `instance_id` integer, required
  - `resource_name` string, required
  - `resource_type` 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12 | 13 | 14 | 15 | 16 | 17 | 18 | 19 | 20 | 21 | 22 | 23 | 24 | 25 | 26 | 27 | 28 | 29 | 30, required
  - `resource_uri` string, required
  - `opportunity_name` string, required
  - `description` string, nullable
  - `last_seen` string, date-time, required
  - `first_seen` string, date-time, required
  - `count` integer, required
  - `total_count` integer, nullable
  - `resources` AppSchemasOpportunitiesResource[], required
    - `resource_name` string, required
    - `resource_uri` string, required
    - `resource_type` 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12 | 13 | 14 | 15 | 16 | 17 | 18 | 19 | 20 | 21 | 22 | 23 | 24 | 25 | 26 | 27 | 28 | 29 | 30, required
  - `money_savings` object, required
  - `time_savings` string, required
  - `effort` 1 | 2 | 3, required
  - `owner` string, nullable
  - `status` 1 | 2 | 3 | 4, required
  - `from_state` string, nullable
  - `target_state` string, nullable
  - `era_key` string, nullable
  - `redirect_url` string, nullable
  - `savings_attribution` SavingsAttributionResponse
    - `id` string, nullable
    - `opportunity_id` string, nullable
    - `instance_id` string, nullable
    - `owner` integer, nullable
    - `attribution_type` string, nullable
    - `altimate_estimated_cost_saving` number, nullable
    - `altimate_estimated_time_saving` number, nullable
    - `user_estimated_cost_saving` number, nullable
    - `user_estimated_time_saving` number, nullable
    - `user_savings_updated_by` integer, nullable
    - `savings_metadata` unknown
    - `start_date` string, date-time, nullable
    - `end_date` string, date-time, nullable
    - `created_at` string, date-time, nullable
    - `updated_at` string, date-time, nullable
    - `created_by` integer, nullable
    - `last_modified_by` integer, nullable
    - `target_state` string, nullable
  - `priority_rank` integer, nullable
  - `priority_se_notes` string, nullable

## Other responses

- `400` — Not supported for public user
- `403` — Not supported for public user
- `422` — Validation Error

## Changes

- **2026-09-15** `8a08bdb37cfa` — 1 info
  - added the optional property `items/savings_attribution` to the response with the `200` status
- **2026-09-11** `70e0a3e5cb0d` — 2 warning, 3 info
  - added the new `30.00` enum value to the `items/resource_type` response property for the response status `200`
  - added the new `30.00` enum value to the `items/resources/items/resource_type` response property for the response status `200`
  - added the optional property `items/era_key` to the response with the `200` status
  - added the optional property `items/from_state` to the response with the `200` status
  - …1 more
- **2026-09-02** `fcb62c79da95` — 2 warning
  - added the new `29.00` enum value to the `items/resource_type` response property for the response status `200`
  - added the new `29.00` enum value to the `items/resources/items/resource_type` response property for the response status `200`
- **2026-08-25** `64fc5b1ea2a2` — 8 warning
  - added the new `25.00` enum value to the `items/resource_type` response property for the response status `200`
  - added the new `25.00` enum value to the `items/resources/items/resource_type` response property for the response status `200`
  - added the new `26.00` enum value to the `items/resource_type` response property for the response status `200`
  - added the new `26.00` enum value to the `items/resources/items/resource_type` response property for the response status `200`
  - …4 more
- …earlier changes not shown

[Full history](https://skmtc.dev/myaltimate/apis/fastapi/changes/opportunities/priority/get.md)

---

[API](https://skmtc.dev/myaltimate/apis/fastapi.md) · [All operations](https://skmtc.dev/myaltimate/apis/fastapi/llms.txt) · [OpenAPI document](https://skmtc.dev/myaltimate/apis/fastapi/revisions/4dfe86ff412c?raw)