---
title: "Get subscription"
method: GET
path: "/subscriptions/{subscriptionId}"
tags: ["subscriptions"]
---

# Get subscription

`GET /subscriptions/{subscriptionId}`

Retrieves detailed information about a specific subscription.

This endpoint returns comprehensive details about the requested subscription:
- Creation and last modification dates
- Consumer URL where webhook events are sent
- Technical contact information
- Current status (enabled/disabled)
- List of topics this subscription is listening for
- Integration type of the current subscription

Use this endpoint when you need to check the configuration of a specific subscription.

## Path parameters

- `subscriptionId` string, uuid, required

## Response `200`

The given subscription

- Subscription — Complete subscription details. Contains all information about a webhook subscription including its configuration and status.
  - `_link` string, uri — The full URI that can be used to access this subscription. This is a convenience to avoid having to construct the URL yourself.
  - `id` string, uuid — The unique identifier of the subscription. Use this ID in path parameters when working with specific subscriptions.
  - `consumerUrl` string — The URL where webhook events are sent for this subscription. All webhook events will be sent as POST requests to this URL.
  - `createdDate` string, date-time — The date and time when this subscription was created. Always provided in UTC format.
  - `modifiedDate` string, date-time — The date and time when this subscription was last modified. Always provided in UTC format. Updates when any subscription property changes.
  - `status` 'enabled' | 'disabled' — The current status of the subscription. - enabled: The subscription is active and will receive webhook events - disabled: The subscription is inactive and will not receive webhook events
  - `tech_contact` string, email — The technical contact email address for this subscription. AccuLynx will use this email to communicate important information about the subscription.
  - `topicNames` string[] — List of event topics this subscription is listening for. Only events matching these topic names will be sent to the consumer URL.
  - `integrationType` 'Api' | 'Zapier' — The current integration type of the subscription.

## Other responses

- `400` — Bad Request - The server cannot process the request due to a client error. Common causes: - Invalid request format - Missing required fields - Validation errors in the request data
- `401` — Unauthorized - Authentication is required or has failed. Common causes: - Missing API key - Invalid API key - Expired or deactivated API key
- `404` — Not Found - The requested resource does not exist. Common causes: - Invalid subscription ID - Subscription has been deleted - URL path contains typos or incorrect values

---

[API](https://skmtc.net/acculynx/apis/acculynx-api-v2.md) · [All operations](https://skmtc.net/acculynx/apis/acculynx-api-v2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/acculynx/acculynx-api-v2/versions/3a9e3886e400/schema)
