---
title: "List webhook consumers"
method: GET
path: "/webhooks"
tags: ["Webhooks"]
---

# List webhook consumers

`GET /webhooks`

Use the *List webhook consumers* endpoint to return a list of all webhook consumers that currently exist for your client.

[Webhook consumer](https://docs.codat.io/platform-api#/schemas/WebhookConsumer) is an HTTP endpoint that you configure to subscribe to specific events. See our documentation for more details on [Codat's webhook service](https://docs.codat.io/using-the-api/webhooks/overview).

## Response `200`

OK

- WebhookConsumers — unresolved $ref

## Other responses

- `400` — The request made is not valid.
- `401` — Your API request was not properly authorized.
- `402` — An account limit has been exceeded. The type of limit is described in the error property: - You have exceeded the 50-company limit that applies to a Free plan. Delete any companies you no longer need and retry the request. - The requested sync schedule is not allowed. You requested an hourly sync schedule but this functionality is not included in the Free plan. - Your Free account is older than 365 days and has expired. Contact support@codat.io.
- `403` — You are using an outdated API key or a key not associated with that resource.
- `429` — Too many requests were made in a given amount of time. Wait a short period and then try again.
- `500` — There is a problem with our server. Please try again later.
- `503` — The Codat API is temporarily offline for maintenance. Please try again later.

## Changes

> 52 revisions in range; 1 could not be searched.

- **2025-01-23** `e711c7acf8df` — 1 breaking, 1 warning
  - the response property `results/items/companyTags` became nullable for the status `200`
  - removed the optional property `results/items/companyId` from the response with the `200` status
- **2024-10-07** `9da67c91c872` — 2 info
  - added the optional property `results/items/companyTags` to the response with the `200` status
  - response property `results/items/companyId` deprecated

[Change history](https://skmtc.dev/codatio/apis/platform-api/changes/webhooks/get.md)

---

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