---
title: "List subscribed profiles"
description: "Lists active subscriptions in the API key's workspace, with profile details and delivery preferences. Requires current workspace membership. Viewers can read. Private profiles must still belong to that workspace. Results are ordered by subscription creation time, newest first. Each request examines at most `limit` subscription rows. The optional text filter matches name, topic, or tags without regard to case and may return a sparse or empty page. Follow `meta.page.nextCursor` while `hasMore` is true, including when `data` is empty. Cursors are bound to the filter."
canonical: https://y2.dev/docs/api/reference/profiles/listProfiles/
---

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

# List subscribed profiles

Lists active subscriptions in the API key's workspace, with profile details and delivery preferences. Requires current workspace membership. Viewers can read. Private profiles must still belong to that workspace. Results are ordered by subscription creation time, newest first. Each request examines at most \`limit\` subscription rows. The optional text filter matches name, topic, or tags without regard to case and may return a sparse or empty page. Follow \`meta.page.nextCursor\` while \`hasMore\` is true, including when \`data\` is empty. Cursors are bound to the filter.

`GET https://api.y2.dev/api/v1/profiles`

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

## Parameters

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `limit` | query | integer | No | Maximum subscription rows examined in one page. |
| `cursor` | query | string | No | Opaque continuation token from the previous response. Bound to the original filters and ordering. |
| `q` | query | string | No | Case-insensitive substring in profile name, topic, or tags. |

## Responses

| Status | Description | Body |
| --- | --- | --- |
| 200 | List of subscribed profiles | `ProfileListResponse` |
| 400 | Invalid request parameters |  |
| 401 | Missing or invalid API key |  |
| 403 | Insufficient permissions or access denied |  |
| 429 | Rate limit exceeded (per-key or per-account aggregate) |  |
| 500 | Internal server error |  |

### 200 response fields

| Field | Type | Description |
| --- | --- | --- |
| `data[]` | array of `ProfileSubscription` |  |
| `data[].subscription` | `PublicSubscription` |  |
| `data[].profile` | `PublicProfile` or null |  |
| `meta` | `PublicListMeta` |  |
| `meta.count` | integer |  |
| `meta.pageCount` | integer |  |
| `meta.limit` | integer |  |
| `meta.isDone` | boolean |  |
| `meta.hasMore` | boolean |  |
| `meta.nextCursor` | string or null |  |
| `meta.asOf` | string (date-time) |  |
| `meta.page` | `PublicPageMeta` |  |
| `links` | `PublicCollectionLinks` |  |
| `links.self` | string |  |
| `links.next` | string or null |  |
