--- title: "List Webhook Deliveries" method: GET path: "/api/webhooks/{webhook_id}/deliveries" tags: ["Webhooks"] --- # List Webhook Deliveries `GET /api/webhooks/{webhook_id}/deliveries` ## Request - Base URL: `https://app.onlyfansapi.com` - URL: `https://app.onlyfansapi.com/api/webhooks/{webhook_id}/deliveries` - Auth: HTTP bearer Retrieve the delivery history for a webhook — one record per delivery **attempt**, newest first. Every attempt made against your endpoint is recorded, including intermediate retries, so a delivery that succeeded on its third try appears as three records sharing one `delivery_uuid`. If your API key is restricted to specific accounts, only deliveries for those accounts are returned. Events that are not account-specific (such as data exports) are always included. ## Query parameters - `date_start` string: Only return deliveries recorded at or after this time (ISO 8601 or date string). Must be a valid date. - `date_end` string: Only return deliveries recorded at or before this time (ISO 8601 or date string). Must be a valid date. - `event` 'messages.received' | 'messages.sent' | 'messages.ppv.unlocked' | 'messages.deleted' | 'messages.liked' | 'messages.unliked' | 'chat_queue.updated' | 'chat_queue.finished' | 'subscriptions.new' | 'subscriptions.renewed' | 'subscriptions.expired' | 'users.typing' | 'users.online' | 'users.offline' | 'posts.liked' | 'tips.received' | 'transactions.new' | 'notifications.new' | 'messages.unread_count_updated' | 'messages.priority_count_updated' | 'messages.unread_tips_count_updated' | 'calls.count_request_updated' | 'notifications.count_updated' | 'accounts.connected' | 'accounts.reconnected' | 'accounts.disconnected' | 'accounts.session_expired' | 'accounts.authentication_failed' | 'accounts.otp_code_required' | 'accounts.face_otp_required' | 'data_exports.calculating_credits' | 'data_exports.calculating_credits_failed' | 'data_exports.calculating_credits_completed' | 'data_exports.in_progress' | 'data_exports.completed' | 'data_exports.failed' | 'data_exports.cancelled' | 'fan_summary.completed' | 'media_uploads.completed' | 'media_uploads.failed' | 'fansly.messages.received' | 'fansly.messages.sent' | 'fansly.messages.deleted' | 'fansly.users.typing' | 'fansly.messages.read' | 'fansly.subscriptions.new' | 'fansly.tips.received' | 'fansly.transactions.new' | 'fansly.accounts.connected' | 'fansly.accounts.disconnected' | 'fansly.accounts.authentication_failed' | 'fansly.accounts.otp_code_required' | 'fansly.followers.new' | 'fansly.followers.removed' | 'fansly.subscriptions.expired' | 'fansly.posts.liked' | 'fansly.media.liked' | 'fansly.media.purchased' | 'fansly.payouts.created' | 'fansly.payouts.updated' | 'fansly.messages.reaction_added' | 'fansly.messages.reaction_removed' | 'fansly.posts.created' | 'fansly.posts.updated' | 'fansly.posts.deleted' | 'fansly.posts.pinned' | 'fansly.stories.purchased' | 'fansly.subscriptions.renewed' | 'fansly.accounts.alert' | 'fansly.fans.ignore_updated' | 'fansly.wallets.updated' | 'fansly.posts.expired' | 'fansly.chats.visibility_updated' | 'fansly.profiles.updated' | 'fansly.payouts.debited' | 'fansly.streams.updated' | 'fansly.accounts.updated' | 'fansly.posts.commented' | 'fanvue.subscription.activated' | 'fanvue.payment.succeeded' | 'fanvue.message.received' | 'fanvue.follow.created' | 'fanvue.subscription.renewed' | 'fanvue.subscription.deactivated' | 'fanvue.subscription.cancel_at_period_end_changed' | 'fanvue.reward.created' | 'fanvue.reward.reversed' | 'fanvue.refund.created' | 'fanvue.dispute.flagged' | 'fanvue.dispute.created' | 'fanvue.message.sent' | 'fanvue.message.mass_sent' | 'fanvue.message.read' | 'fanvue.message.read_by_fan' | 'fanvue.message.deleted' | 'fanvue.message.reaction' | 'fanvue.chat.marked_unread' | 'fanvue.post.liked' | 'fanvue.post.commented' | 'fanvue.fan.status_changed' | 'fanvue.fan.presence_changed' | 'fanvue.account.connected' | 'fanvue.account.disconnected' | 'fanvue.account.needs_reauth' | 'test-event': Only return deliveries for this event type. See the **List Available Events** endpoint for all values. - `succeeded` boolean: Filter by outcome: `true` for delivered attempts, `false` for failed ones. - `limit` integer: Rows per page (max `100`). Default `25`. Must be at least 1. Must not be greater than 100. - `offset` integer: Pagination offset. Default `0`. Must be at least 0. ## Response `200` - object - `data` object[] - `id` integer - `delivery_uuid` string - `event` string - `attempt` integer - `succeeded` boolean - `status_code` integer - `error_type` string, nullable - `error_message` string, nullable - `idempotency_key` string - `url` string - `payload` object - `event` string - `account_id` string - `payload` object - `id` integer - `user` object - `id` integer - `name` string - `username` string - `price` number - `redelivered_from` string, nullable - `created_at` string - `_pagination` object - `next_page` string, nullable - `_meta` object - `_credits` object - `used` integer - `balance` integer - `note` string - `_cache` object - `is_cached` boolean - `note` string - `_rate_limits` object - `limit_minute` integer - `limit_day` integer - `remaining_minute` integer - `remaining_day` integer ## Changes - **2026-10-25** `11e906c7aedb`: 5 info - added the new enum value `calls.count_request_updated` to the `query` request parameter `event` - added the new enum value `messages.priority_count_updated` to the `query` request parameter `event` - added the new enum value `messages.unread_count_updated` to the `query` request parameter `event` - added the new enum value `messages.unread_tips_count_updated` to the `query` request parameter `event` - …1 more - **2026-10-17** `b3968f1bc1f0`: 1 info - endpoint added [Operation history](https://skmtc.dev/onlyfansapi/apis/onlyfans-api/changes/api/webhooks/:webhook_id/deliveries/get.md) --- [API](https://skmtc.dev/onlyfansapi/apis/onlyfans-api.md) - [All operations](https://skmtc.dev/onlyfansapi/apis/onlyfans-api/llms.txt) - [OpenAPI document](https://skmtc.dev/onlyfansapi/apis/onlyfans-api/revisions/122c36386896?raw)