---
title: "Get user's subscriptions"
method: GET
path: "/subscriptions"
tags: ["Subscriptions"]
---

# Get user's subscriptions

`GET /subscriptions`

## Request

- Base URL: `https://artifacthub.io/api/v1`
- URL: `https://artifacthub.io/api/v1/subscriptions`
- Auth: API key in header `X-API-KEY-ID` and API key in header `X-API-KEY-SECRET`
- TypeScript: <https://skmtc.dev/artifacthub/apis/artifact-hub/docs/subscriptions/get.ts> (a function with typed inputs; its response is checked against the schema)

Get user's subscriptions

## Query parameters

- `offset` integer
- `limit` integer

## Response `200`

- object[]
  - `package_id` string, uuid, required
  - `name` string, required
  - `normalized_name` string, required
  - `logo_image_id` string
  - `repository` RepositorySummary, required
    - `repository_id` string, uuid, required
    - `kind` 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12 | 13 | 14 | 15 | 16 | 17 | 18 | 19 | 20 | 21 | 22 | 23 | 24 | 25 | 26 | 27, required: Repository kind: * `0` - Helm charts * `1` - Falco rules * `2` - OPA policies * `3` - OLM operators * `4` - Tinkerbell actions * `5` - Krew kubectl plugins * `6` - Helm plugins * `7` - Tekton tasks * `8` - KEDA scalers * `9` - Core DNS plugins * `10` - Keptn integrations * `11` - Tekton pipelines * `12` - Container images * `13` - Kubewarden policies * `14` - Gatekeeper policies * `15` - Kyverno policies * `16` - Knative client plugins * `17` - Backstage plugins * `18` - Argo templates * `19` - KubeArmor templates * `20` - KCL packages * `21` - Headlamp plugins * `22` - Inspektor gadgets * `23` - Tekton stepactions * `24` - Meshery designs * `25` - Opencost plugins * `26` - Radius recipes * `27` - Bootable containers * `28` - Kagent agents
    - `name` string, required
    - `display_name` string
    - `url` string, uri, required
    - `verified_publisher` boolean, required
    - `official` boolean, required
    - `cncf` boolean, nullable
    - `private` boolean
    - `scanner_disabled` boolean, required
    - `user_alias` string
    - `organization_name` string
    - `organization_display_name` string
  - `event_kinds` EventKindId[], required

## Other responses

- `401`: Valid authentication credentials not provided
- `429`: The user has sent too many requests in a given amount of time
- `500`: The server encountered an unexpected condition that prevented it from fulfilling the request

## Changes

- **2025-02-01** `081ff21a6f42`: 6 warning
  - added the new `22.00` enum value to the `items/repository/kind` response property for the response status `200`
  - added the new `23.00` enum value to the `items/repository/kind` response property for the response status `200`
  - added the new `24.00` enum value to the `items/repository/kind` response property for the response status `200`
  - added the new `25.00` enum value to the `items/repository/kind` response property for the response status `200`
  - …2 more

[Operation history](https://skmtc.dev/artifacthub/apis/artifact-hub/changes/subscriptions/get.md)

---

[API](https://skmtc.dev/artifacthub/apis/artifact-hub.md) - [All operations](https://skmtc.dev/artifacthub/apis/artifact-hub/llms.txt) - [OpenAPI document](https://skmtc.dev/artifacthub/apis/artifact-hub/revisions/d2e9234264b1?raw)
