---
title: "Get Profile Ids"
method: GET
path: "/v2/phota/profiles/ids"
tags: ["Profiles"]
---

# Get Profile Ids

`GET /v2/phota/profiles/ids`

## Request

- Base URL: `https://api.photalabs.com`
- URL: `https://api.photalabs.com/v2/phota/profiles/ids`
- Auth: API key in header `X-API-Key`

List all profiles for the authenticated user, optionally filtered by tag.

## Query parameters

- `tag` string, nullable: Filter profiles by tag. Omit to return all profiles.

## Response `200`

Successful Response

- ProfileIdsResponse: Response containing all profiles owned by the authenticated user.
  - `profiles` ProfileInfo[], required: List of profile summaries. Empty if the user has no profiles.
    - `profile_id` string, required: The profile identifier.
    - `status` 'VALIDATING' | 'QUEUING' | 'IN_PROGRESS' | 'READY' | 'ERROR' | 'INACTIVE', required: Status of a profile.
    - `tag` string, nullable: Tag associated with this profile, if any.

## Other responses

- `401`: Invalid API key in the X-API-Key header.
- `402`: Insufficient prepaid credit balance.
- `403`: Missing X-API-Key header (no API key provided).
- `404`: Resource not found.
- `422`: Validation Error
- `500`: Internal error.

---

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