> ## Documentation Index > Fetch the complete documentation index at: https://polar.sh/docs/llms.txt > Use this file to discover all available pages before exploring further. # Get Webhook Endpoint > Get a webhook endpoint by ID. **Scopes**: `webhooks:read` `webhooks:write` ## OpenAPI ````yaml /openapi.json get /v1/webhooks/endpoints/{id} openapi: 3.1.0 info: title: Polar API summary: Polar HTTP and Webhooks API description: Read the docs at https://polar.sh/docs/api-reference version: 2026-04 servers: - url: https://api.polar.sh description: Production environment x-speakeasy-server-id: production x-polar-environment: production - url: https://sandbox-api.polar.sh description: Sandbox environment x-speakeasy-server-id: sandbox x-polar-environment: sandbox security: [] tags: - name: public description: >- Endpoints shown and documented in the Polar API documentation and available in our SDKs. - name: private description: >- Endpoints that should appear in the schema only in development to generate our internal JS SDK. paths: /v1/webhooks/endpoints/{id}: get: tags: - webhooks - public summary: Get Webhook Endpoint description: |- Get a webhook endpoint by ID. **Scopes**: `webhooks:read` `webhooks:write` operationId: webhooks:get_webhook_endpoint parameters: - name: id in: path required: true schema: type: string format: uuid4 description: The webhook endpoint ID. title: Id description: The webhook endpoint ID. responses: '200': description: Successful Response content: application/json: schema: $ref: '#/components/schemas/WebhookEndpoint' '404': description: Webhook endpoint not found. content: application/json: schema: $ref: '#/components/schemas/ResourceNotFound' '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' security: - oidc: - webhooks:read - webhooks:write - pat: - webhooks:read - webhooks:write - oat: - webhooks:read - webhooks:write x-codeSamples: - lang: Python (New SDK) source: | from polar.v2026_04 import Polar polar = Polar("polar_oat_xxx") response = polar.webhooks.get_webhook_endpoint( '00000000-0000-4000-8000-000000000000', ) print(response) - lang: TypeScript (New SDK) source: | import { createPolar } from "@polar-sh/sdk/2026-04"; const polar = createPolar({ accessToken: "polar_oat_xxx", }); const response = await polar.webhooks.getWebhookEndpoint( "00000000-0000-4000-8000-000000000000", ); console.log(response); components: schemas: WebhookEndpoint: properties: created_at: type: string format: date-time title: Created At description: Creation timestamp of the object. modified_at: anyOf: - type: string format: date-time - type: 'null' title: Modified At description: Last modification timestamp of the object. id: type: string format: uuid4 title: Id description: The ID of the object. url: type: string title: Url description: The URL where the webhook events will be sent. examples: - https://webhook.site/cb791d80-f26e-4f8c-be88-6e56054192b0 name: anyOf: - type: string - type: 'null' title: Name description: >- An optional name for the webhook endpoint to help organize and identify it. format: $ref: '#/components/schemas/WebhookFormat' description: The format of the webhook payload. secret: type: string title: Secret description: The secret used to sign the webhook events. examples: - whsec_ovyN6cPrTv56AApvzCaJno08SSmGJmgbWilb33N2JuK organization_id: type: string format: uuid4 title: Organization Id description: The organization ID associated with the webhook endpoint. events: items: $ref: '#/components/schemas/WebhookEventType' type: array title: Events description: The events that will trigger the webhook. enabled: type: boolean title: Enabled description: Whether the webhook endpoint is enabled and will receive events. type: object required: - created_at - modified_at - id - url - format - secret - organization_id - events - enabled title: WebhookEndpoint description: A webhook endpoint. ResourceNotFound: properties: error: type: string const: ResourceNotFound title: Error examples: - ResourceNotFound detail: type: string title: Detail type: object required: - error - detail title: ResourceNotFound HTTPValidationError: properties: detail: items: $ref: '#/components/schemas/ValidationError' type: array title: Detail type: object title: HTTPValidationError WebhookFormat: type: string enum: - raw - discord - slack title: WebhookFormat WebhookEventType: type: string enum: - checkout.created - checkout.updated - checkout.expired - customer.created - customer.updated - customer.deleted - customer.state_changed - customer_seat.assigned - customer_seat.claimed - customer_seat.revoked - member.created - member.updated - member.deleted - order.created - order.updated - order.paid - order.refunded - subscription.created - subscription.updated - subscription.active - subscription.canceled - subscription.uncanceled - subscription.revoked - subscription.past_due - subscription.paused - subscription.resumed - refund.created - refund.updated - product.created - product.updated - benefit.created - benefit.updated - benefit_grant.created - benefit_grant.cycled - benefit_grant.updated - benefit_grant.revoked - organization.updated title: WebhookEventType ValidationError: properties: loc: items: anyOf: - type: string - type: integer type: array title: Location msg: type: string title: Message type: type: string title: Error Type input: title: Input ctx: type: object title: Context type: object required: - loc - msg - type title: ValidationError securitySchemes: oidc: type: openIdConnect openIdConnectUrl: /.well-known/openid-configuration pat: type: http description: >- You can generate a **Personal Access Token** from your [settings](https://polar.sh/settings). scheme: bearer oat: type: http description: >- You can generate an **Organization Access Token** from your organization's settings. scheme: bearer ````