---
title: "Retrieve all registered webhooks"
method: GET
path: "/v2/webhooks"
tags: ["Webhooks"]
---

# Retrieve all registered webhooks

`GET /v2/webhooks`

Retrieve all webhooks registered for the organization, including basic configuration details. Sensitive information like oauth_configuration will be masked in the response.

## Headers

- `organization-id` string

## Response `200`

List of registered webhooks retrieved successfully

- WebhookResponseDto[]
  - `id` string, required — Unique identifier for the webhook registration
  - `organization_id` string, required — Unique identifier for the client organization
  - `url` string, required — Callback URL to which data should be posted
  - `event_types` string[], required — Credentialing event(s) that should trigger a post. Values: - IN_PROGRESS: Credentialing is in progress - PSV_COMPLETED: Primary source verification completed - CREDENTIALING_COMPLETED: Credentialing completed - PROVIDER_TERMINATED: Provider terminated - FACILITY_NOT_SENT_TO_CREDENTIALING: Facility not sent to credentialing - FACILITY_IN_PROGRESS: Facility credentialing in progress - FACILITY_DATA_MISSING: Facility data missing - FACILITY_OUTREACH_IN_PROGRESS: Facility outreach in progress - FACILITY_PSV_COMPLETE_BY_CERTIFYOS: Facility PSV complete by CertifyOS - FACILITY_CREDENTIALING_RESTARTED: Facility credentialing restarted - FACILITY_PSV_READY: Facility PSV ready - FACILITY_CRED_APPROVED: Facility credentialing approved - FACILITY_HOLD_FOR_CRED_COMM: Facility hold for credentialing committee - FACILITY_CRED_DENIED: Facility credentialing denied - FACILITY_TERMINATED: Facility terminated - FACILITY_RECREDENTIALING_IN_PROGRESS: Facility recredentialing in progress - FACILITY_TABLED: Facility tabled - FACILITY_WITHDRAWN_CANCELLED: Facility withdrawn or cancelled - FACILITY_NOT_STARTED: Facility credentialing not started - PROVIDER_NOT_SENT_TO_CREDENTIALING: Provider not sent to credentialing - PROVIDER_NOT_STARTED: Provider credentialing not started - PROVIDER_IN_PROGRESS: Provider credentialing in progress - PROVIDER_DATA_MISSING: Provider data missing - PROVIDER_OUTREACH_IN_PROGRESS: Provider outreach in progress - PROVIDER_PSV_COMPLETED: Provider PSV completed - PROVIDER_CREDENTIALING_RESTARTED: Provider credentialing restarted - PROVIDER_PSV_READY: Provider PSV ready - PROVIDER_CRED_APPROVED: Provider credentialing approved - PROVIDER_HOLD_FOR_CRED_COMM: Provider hold for credentialing committee - PROVIDER_CRED_DENIED: Provider credentialing denied - PROVIDER_RECREDENTIALING_IN_PROGRESS: Provider recredentialing in progress - PROVIDER_TABLED: Provider tabled - PROVIDER_WITHDRAWN_CANCELLED: Provider withdrawn or cancelled
  - `description` string — Title/description of the webhook being registered
  - `headers` object — Key-value pairs of custom static headers sent with the webhook requests (e.g., for API keys or tokens). These are masked in the response.
  - `oauth_configuration` ClientCredentialsConfigurationDto
    - `client_id` string, required — Client ID for OAuth token exchange
    - `client_secret` string, required — Client secret for OAuth token exchange
    - `token_url` string, required — URL for OAuth token exchange
    - `scope` string, nullable — Scope for OAuth token exchange
    - `headers` object, nullable — Key-value pairs of custom headers to send in the OAuth token exchange request to {token_url}.
  - `created_at` string, required — Timestamp when the webhook was created

## Other responses

- `401` — Authorization token is missing or invalid.
- `403` — User does not have permission to access this resource.

---

[API](https://skmtc.dev/certifyos/apis/certifyos-api.md) · [All operations](https://skmtc.dev/certifyos/apis/certifyos-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/certifyos/certifyos-api/revisions/6ef2fa526e0f/schema)