---
title: "Get Subscription [Single]"
method: GET
path: "/apiHub/webhooks/v1/subscriptions/{id}"
tags: ["Subscriptions"]
---

# Get Subscription \[Single\]

`GET /apiHub/webhooks/v1/subscriptions/{id}`

## Request

- Base URL: `dc1demogwext.paylocity.com` (relative, and the document’s source URL is not known)
- URL: `dc1demogwext.paylocity.com/apiHub/webhooks/v1/subscriptions/{id}`
- Auth: HTTP bearer

> 🚧 Early Access API Version
> This endpoint version is currently in Early Access and available only to approved early adoption (EA) participants. Do not rely on this version for production workloads unless explicitly authorized. If you have any feedback, please share with your designated Early Adoption program representative.

**Summary Description**

 Retrieves the details of a specific webhook subscription using its unique `id`. This endpoint allows API users to view the configuration of a single subscription, including the target URL, event types, authentication settings, and delivery preferences.

Use this endpoint to:

- Inspect a specific webhook subscription
- Validate configuration for a known subscription
- Support debugging or audit use cases involving webhook delivery

This is useful for clients managing multiple webhook subscriptions and needing granular visibility into individual configurations.

## Path parameters

- `id` string, uuid, required

## Headers

- `Authorization` string, required

## Response `200`

OK

- ReadSubscriptionV1Model
  - `id` string, uuid: The unique identifier of the webhook subscription.
  - `clientId` string, uuid: The ID of the API credentials that own the subscription.
  - `applicationId` string, uuid: The ID of the application associated with the API credentials.
  - `name` string, nullable: The name of the webhook subscription.
  - `status` string, nullable: The current status of the webhook subscription. Allowable Values: ACTIVE, DISABLED, DEACTIVATED, UNREACHABLE, PENDING_VERIFICATION.
  - `eventTypes` string[], nullable: List of event types the subscription receives (e.g. `employee.person.v1`, `employee.assignment.v1`).
  - `url` string, nullable: The URL where webhook events are delivered.
  - `auth` ReadAuthV1Model: ### Authentication Configuration (Response) The API returns exactly one authentication object depending on the configured type: - **HMAC authentication** – the `hmac` object will be populated.
    - `type` string, required: The authentication type configured for the subscription. Allowable Values: HMAC.
    - `hmac` ReadHmacAuthV1Model
      - `key1` ReadHmacKeyV1Model, required
        - `keyId` string, uuid, required: The unique identifier of the HMAC key.
        - `issuedAt` string, date-time, required: The date and time the HMAC key was issued.
        - `expirationAt` string, date-time, required: The date and time the HMAC key expires.
      - `key2` ReadHmacKeyV1Model
        - `keyId` string, uuid, required: The unique identifier of the HMAC key.
        - `issuedAt` string, date-time, required: The date and time the HMAC key was issued.
        - `expirationAt` string, date-time, required: The date and time the HMAC key expires.
  - `createdAt` string, date-time, nullable: The date and time the subscription was created.

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not Found
- `500`: Internal Server Error

---

[API](https://skmtc.dev/paylocity/apis/webhooks-api.md) - [All operations](https://skmtc.dev/paylocity/apis/webhooks-api/llms.txt) - [OpenAPI document](https://skmtc.dev/paylocity/apis/webhooks-api/revisions/4206e9534cc6?raw)