---
title: "Get a placement profile"
method: GET
path: "/v2/projects/{projectId}/placement-profiles/{id}"
tags: ["PlacementProfileService"]
---

# Get a placement profile

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

## Request

- Base URL: `https://api.together.ai`
- URL: `https://api.together.ai/v2/projects/{projectId}/placement-profiles/{id}`
- Auth: HTTP bearer

Retrieves a reusable placement profile and its ordered region preferences.

## Path parameters

- `projectId` string, required: Project identifier.
- `id` string, required: Placement profile identifier.

## Response `200`

OK

- DEPlacementProfile: Reusable ordered region preferences for scheduling a project's deployments.
  - `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.

## Other responses

- `default`: Default error response

## Changes

- **2026-10-22** `bb5257b3173a`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/together/apis/together-apis/changes/v2/projects/:projectId/placement-profiles/:id/get.md)

---

[API](https://skmtc.dev/together/apis/together-apis.md) - [All operations](https://skmtc.dev/together/apis/together-apis/llms.txt) - [OpenAPI document](https://skmtc.dev/together/apis/together-apis/revisions/93438ddac711?raw)