---
title: "Get user's subscriptions for the given package"
method: GET
path: "/subscriptions/{packageID}"
tags: ["Subscriptions"]
---

# Get user's subscriptions for the given package

`GET /subscriptions/{packageID}`

## Request

- Base URL: `https://artifacthub.io/api/v1`
- URL: `https://artifacthub.io/api/v1/subscriptions/{packageID}`
- 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/:packageID/get.ts> (a function with typed inputs; its response is checked against the schema)

Get user's subscriptions for the given package

## Path parameters

- `packageID` string, uuid, required

## Response `200`

- object[]
  - `event_kind` 0 | 1 | 2 | 4, required: Event kind: * `0` - New package release * `1` - Security alerts * `2` - Repository tracking errors * `4` - Repository scanning errors

## 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

---

[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)