---
title: "Retrieve webhook subscriptions."
method: GET
path: "/subscriptions"
tags: ["subscriptions"]
---

# Retrieve webhook subscriptions.

`GET /subscriptions`

## Query parameters

- `page_id` string
- `limit` integer

## Response `200`

List of subscription details.

- Subscription[]
  - `id` string
  - `name` string, nullable
  - `description` string, nullable
  - `callbackUrl` string, https_url, required
  - `events` Event[], required
    - `name` 'job.created' | 'job.updated' | 'job.status.updated' | 'job.hiring-team.updated' | 'job.ad.created' | 'job.ad.updated' | 'job.ad.postings.updated' | 'position.created' | 'position.updated' | 'position.deleted' | 'application.created' | 'application.status.updated' | 'application.fields.updated' | 'application.onboarding-status.updated' | 'application.attachment.created' | 'application.source.updated' | 'candidate.created' | 'candidate.updated' | 'candidate.deleted' | 'offer.created' | 'offer.updated' | 'offer.approval.created' | 'offer.approval.approved' | 'offer.approval.rejected' | 'offer.approval.abandoned' | 'offer.approval.step.approved' | 'offer.approval.step.rejected' | 'offer.approver.skipped' | 'offer.approver.delegated' | 'offer.approval.comment.created' | 'job.approval.created' | 'job.approval.approved' | 'job.approval.rejected' | 'job.approval.abandoned' | 'job.approval.step.approved' | 'job.approval.step.rejected' | 'job.approver.skipped' | 'job.approver.delegated' | 'job.approval.comment.created' | 'review.created' | 'review.updated' | 'review.deleted' | 'application.screening-answers.created' | 'application.screening-answers.updated' | 'onboarding.process.started' | 'onboarding.assignments.high-priority.completed' | 'onboarding.assignments.completed' | 'onboarding.assignment.integration-relevant.completed' | 'onboarding.assignments.integration-relevant.completed' | 'interview.created' | 'interview.updated' | 'interview.canceled' | 'self-schedule.created' | 'winston.chat.visibility.changed'
    - `version` string
  - `status` 'inactive' | 'active'

## Other responses

- `401` — Unauthorized
- `403` — No permission to see subscriptions

---

[API](https://skmtc.net/smartrecruiters/apis/apply-api.md) · [All operations](https://skmtc.net/smartrecruiters/apis/apply-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/smartrecruiters/apply-api/revisions/449bdc2516c9/schema)