---
title: "List ownership recommendations"
method: GET
path: "/api/v1/recommendations/ownership"
tags: ["Recommendations"]
---

# List ownership recommendations

`GET /api/v1/recommendations/ownership`

## Request

- Base URL: `https://api.getcortexapp.com`
- URL: `https://api.getcortexapp.com/api/v1/recommendations/ownership`
- Auth: HTTP bearer

Lists the team ownership recommendations you can see, strongest first. By default it lists open ones: not rejected, and the team does not already own the entity. Archived entities and teams never appear.

## Query parameters

- `entities` string[]
- `teams` string[]
- `confidence` 'HIGH' | 'LOW'
- `status` 'OPEN' | 'PENDING' | 'REJECTED'
- `unownedOnly` boolean
- `pageSize` integer, required
- `page` integer, required

## Response `200`

A page of ownership recommendations

- OwnershipRecommendations: A page of ownership recommendations
  - `page` integer, required: Current page number, 0-indexed
  - `recommendations` OwnershipRecommendation[], required: Ownership recommendations for the current page
    - `confidence` 'HIGH' | 'LOW': How sure the model is
    - `entity` RecommendationEntity, required: A catalog entity
      - `id` string, required: The entity's CID
      - `name` string, required: The entity's name
      - `tag` string, required: The entity's tag
      - `type` string, required: The entity's type
    - `id` string: The recommendation's id, stable for this entity and team. Null until the model's next run assigns it.
    - `rejectedAt` string, date-time: For a rejected one: when it was rejected
    - `rejectedBy` RecommendationActor: Who made a decision
      - `user` CortexUserSummary, required: The user who verified the entity. Null while the status is PENDING, and null when a global API key verified it.
        - `email` string, required
        - `name` string, required
    - `status` 'OPEN' | 'PENDING' | 'REJECTED', required: Whether it still needs a decision
    - `team` RecommendationTeam, required: A team
      - `id` string, required: The team's CID
      - `name` string, required: The team's name
      - `tag` string, required: The team's tag
  - `total` integer, required: Total number of results
  - `totalPages` integer, required: Total number of pages

## Other responses

- `400`: A parameter is not valid
- `404`: An entity or team in the filters does not exist
- `429`: The client has exceeded the rate limit by performing too many requests in a short period. Retry the request after a delay.

## Changes

- **2026-11-03** `a7b058663c95`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/cortex/apis/cortex-api/changes/api/v1/recommendations/ownership/get.md)

---

[API](https://skmtc.dev/cortex/apis/cortex-api.md) - [All operations](https://skmtc.dev/cortex/apis/cortex-api/llms.txt) - [OpenAPI document](https://skmtc.dev/cortex/apis/cortex-api/revisions/a7b058663c95?raw)