---
title: "Get a subscribed profile"
description: "Returns a profile from an active subscription in the API key's workspace. Requires current workspace membership, including the viewer role. Private profiles must still belong to the selected workspace. Community and global profiles require an active workspace subscription. Missing, unsubscribed, and inaccessible profiles all return 404. Only stable public IDs are accepted."
canonical: https://y2.dev/docs/api/reference/profiles/getProfile/
---

Endpoint Reference[Profiles](https://y2.dev/docs/api/reference/profiles)

# Get a subscribed profile

Returns a profile from an active subscription in the API key's workspace. Requires current workspace membership, including the viewer role. Private profiles must still belong to the selected workspace. Community and global profiles require an active workspace subscription. Missing, unsubscribed, and inaccessible profiles all return 404. Only stable public IDs are accepted.

`GET https://api.y2.dev/api/v1/profiles/{profileId}`

- Operation ID: `getProfile`
- Required scopes: `profiles:read`
- Contract: https://y2.dev/openapi.json

## Parameters

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `profileId` | path | string | Yes | Stable public profile ID returned by listProfiles. |

## Responses

| Status | Description | Body |
| --- | --- | --- |
| 200 | Authorized profile details | `ProfileDetailResponse` |
| 400 | Invalid request parameters |  |
| 401 | Missing or invalid API key |  |
| 403 | Insufficient permissions or access denied |  |
| 404 | Resource not found |  |
| 429 | Rate limit exceeded (per-key or per-account aggregate) |  |
| 500 | Internal server error |  |

### 200 response fields

| Field | Type | Description |
| --- | --- | --- |
| `data` | `PublicProfile` |  |
| `data.id` | string |  |
| `data.type` | string |  |
| `data.name` | string |  |
| `data.topic` | string |  |
| `data.status` | `ProfileStatusEnum` | Profile status |
| `data.frequency` | `FrequencyEnum` or null |  |
| `data.schedule` | object |  |
| `data.visibility` | object |  |
| `data.tags[]` | array of string |  |
| `data.customInstructions` | string or null |  |
| `data.reportStructure` | string or null |  |
| `data.configuration` | `PublicProfileConfiguration` |  |
| `data.lastDeliveredAt` | string or null (date-time) |  |
| `data.createdAt` | string (date-time) |  |
| `data.links` | object |  |
| `meta` | object |  |
| `meta.asOf` | string (date-time) |  |
