---
title: "List all Webhooks"
method: GET
path: "/2024-11/organizations/{organization_id}/webhooks"
tags: ["Webhooks"]
---

# List all Webhooks

`GET /2024-11/organizations/{organization_id}/webhooks`

## Request

- Base URL: `https://enterprise-api.easyship.com`
- URL: `https://enterprise-api.easyship.com/2024-11/organizations/{organization_id}/webhooks`
- Auth: OAuth 2
  - Client credentials
  - Token URL: `https://enterprise-api.easyship.com/oauth2/token` scopes: `enterprise.webhook`

List all webhooks which belong to specific organisation.

Required authorization scope: `enterprise.webhook:read`

## Path parameters

- `organization_id` string, uuid, required

## Query parameters

- `page` integer
- `per_page` integer

## Response `200`

webhook list

- WebhookList: List of Webhooks
  - `webhooks` Webhook[]
    - union
      - Webhook202301: v2023_01 Webhook
        - `id` Id (unresolved $ref)
        - `endpoint` Endpoint (unresolved $ref)
        - `configuration` WebhookConfiguration, nullable
          - `credit_balance_low` object, nullable
            - `credit_balance_limit` number, nullable: Required only when event_types include `credit_balance_low`. The webhook would be triggered if the credit balance is lower than this limit. Please note that the webhook will only be triggered once a day and it will reset at 00:00 UTC.
        - `event_types` string[]
        - `version` '2023-01': Webhook payload version. Refer to documentation for information regarding payload versioning.
        - `state` State (unresolved $ref)
        - `secret_token` SecretToken (unresolved $ref)
        - `updated_at` UpdatedAt (unresolved $ref)
        - `created_at` CreatedAt (unresolved $ref)
      - Webhook202409: v2024_09 Webhook
        - `id` Id (unresolved $ref)
        - `endpoint` Endpoint (unresolved $ref)
        - `configuration` WebhookConfiguration, nullable
          - `credit_balance_low` object, nullable
            - `credit_balance_limit` number, nullable: Required only when event_types include `credit_balance_low`. The webhook would be triggered if the credit balance is lower than this limit. Please note that the webhook will only be triggered once a day and it will reset at 00:00 UTC.
        - `event_types` string[]
        - `version` '2024-09': Webhook payload version. Refer to documentation for information regarding payload versioning.
        - `state` State (unresolved $ref)
        - `secret_token` SecretToken (unresolved $ref)
        - `updated_at` UpdatedAt (unresolved $ref)
        - `created_at` CreatedAt (unresolved $ref)
  - `meta` MetaWithPagination
    - `pagination` Pagination: Pagination
      - `next` integer, nullable
      - `count` integer, nullable: The total number of items. The `null` value is used with countless pagination (used for faster response on large datasets, like shipments).
      - `page` integer: Current page
    - `request_id` string: An unique ID represent the request.

---

[API](https://skmtc.dev/easyship/apis/easyship-enterprise-api.md) - [All operations](https://skmtc.dev/easyship/apis/easyship-enterprise-api/llms.txt) - [OpenAPI document](https://skmtc.dev/easyship/apis/easyship-enterprise-api/revisions/e22015413521?raw)