---
title: "List placement profiles"
method: GET
path: "/projects/{projectId}/placement-profiles"
tags: ["PlacementProfileService"]
---

# List placement profiles

`GET /projects/{projectId}/placement-profiles`

Lists reusable, project-visible placement policies that control the regions where deployments may be scheduled.

## Path parameters

- `projectId` string, required — Project identifier.

## Query parameters

- `limit` integer — Maximum number of profiles to return. Max 500, defaults to 50.
- `after` string — Cursor from a previous placement profile list response.

## Response `200`

OK

- DEListPlacementProfilesResponse — Reusable deployment placement profiles visible to the project.
  - `data` DEPlacementProfile[], required — Placement profiles visible in the project.
    - `id` string, required — Unique placement profile identifier.
    - `projectId` string, required — Project that owns the placement profile.
    - `organizationId` string, required — Organization that owns the placement profile.
    - `name` string, required — Human-readable placement profile name.
    - `preferredRegions` string[], required — Preferred deployment regions in descending priority order.
  - `next_cursor` string — Cursor for the next page. Null if there are no more results.
  - `object` 'list', required — Object type. Always `list`.

## Other responses

- `default` — Default error response

---

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