---
title: "Usage by Feed"
method: GET
path: "/v1/usage/by-feed"
tags: ["Usage"]
---

# Usage by Feed

`GET /v1/usage/by-feed`

## Request

- Base URL: `https://api.racehooks.io`
- URL: `https://api.racehooks.io/v1/usage/by-feed`
- Auth: API key in header `Authorization`

Get webhook delivery counts broken down by feed for the current period.

## Response `200`

Default Response

- object
  - `data` object
    - `period` string
    - `byFeed` object[]
      - `feedId` string
      - `deliveryCount` integer: Live and test-ping deliveries to this feed this period - the deliveries that count toward the monthly bucket. Replay deliveries are NOT included (see replayCount).
      - `replayCount` integer: Simulate replay deliveries to this feed this period. Replays are not billed and do not count toward the monthly bucket.
      - `failureCount` integer: Live and test deliveries whose final outcome was not a 2xx (a retried delivery that eventually succeeded is not a failure).
      - `retryCount` integer: Total retry attempts across live and test deliveries (a delivery retried twice adds 2).

## Other responses

- `401`: Missing or invalid Bearer token

---

[API](https://skmtc.dev/racehooks/apis/racehooks-api.md) · [All operations](https://skmtc.dev/racehooks/apis/racehooks-api/llms.txt) · [OpenAPI document](https://skmtc.dev/racehooks/apis/racehooks-api/revisions/2335b73f46e4?raw)