> ## Documentation Index
> Fetch the complete documentation index at: https://docs.onlyfansapi.com/llms.txt
> Use this file to discover all available pages before exploring further.
# List Webhook Deliveries (/api-reference/webhooks/list-webhook-deliveries)
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.
## OpenAPI
````yaml https://app.onlyfansapi.com/scribe-docs/openapi.yaml get /api/webhooks/{webhook_id}/deliveries
openapi: 3.0.3
info:
title: OnlyFans API
description: ""
version: 1.0.0
servers:
- url: https://app.onlyfansapi.com
security:
- default: []
tags:
- name: API Keys
description: ""
- name: Account
description: Endpoints for your linked accounts
- name: Analytics - Financial
description: APIs for retrieving financial analytics data
- name: Analytics - Summary
description: APIs for retrieving summary analytics data
- name: Banking
description: Operations related to user banking details, payout methods, legal
and tax information, and account country settings.
- name: Banned Words
description: Reference list of OnlyFans banned words used by the
`blockBannedWords` screening parameter
- name: Blocked / Restricted Users
description: APIs for listing the users an account has blocked or restricted
- name: Chargebacks
description: ""
- name: Chat Messages
description: ""
- name: Chats
description: ""
- name: Client Sessions
description: ""
- name: Connect OnlyFans Account
description: ""
- name: Data Exports
description: APIs for managing data exports
- name: Engagement / Messages
description: ""
- name: Fans
description: APIs for managing OnlyFans fans (subscribers)
- name: Fans - AI Summary
description: APIs for generating and retrieving AI-powered fan profile summaries
- name: Following
description: APIs for managing OnlyFans followings (people you're subscribed to)
- name: Free Trial Links
description: APIs for managing Free Trial Links
- name: Giphy
description: ""
- name: Link Tags
description: APIs for managing tags on free trial links, tracking links, and Smart Links
- name: Mass Messaging
description: ""
- name: Media
description: ""
- name: Media Vault
description: ""
- name: Media Vault Lists
description: ""
- name: Notifications
description: Endpoints for managingr account notifications
- name: Payouts
description: ""
- name: Post Comments
description: ""
- name: Post Labels
description: APIs for managing your post labels
- name: Posts
description: APIs for managing OnlyFans posts
- name: Promotions
description: ""
- name: Public Profiles
description: ""
- name: Queue
description: ""
- name: Release Forms
description: APIs for managing OnlyFans release forms
- name: Saved For Later (Messages)
description: ""
- name: Saved For Later (Posts)
description: ""
- name: Settings
description: ""
- name: Shared Free Trial Links
description: APIs for Free Trial Links that other OF creators have shared with
this account. Revenue, cost, and spender data are not available for shared
links.
- name: Shared Tracking Links
description: APIs for Tracking Links (campaigns) that other OF creators have
shared with this account. Revenue, cost, and spender data are not
available for shared campaigns.
- name: Smart Link Postbacks
description: APIs for managing Smart Link postback destinations
- name: Smart Links
description: APIs for managing Smart Links (Free Trial Links and Tracking Links
with pooled inventory)
- name: Statistics
description: ""
- name: Stored Free Trial Links
description: Instant APIs for retrieving stored free trial links from the
OnlyFansAPI Cache (free, no credits used)
- name: Stored Shared Free Trial Links
description: Instant APIs for retrieving stored shared Free Trial Links from the
OnlyFansAPI Cache (free, no credits used)
- name: Stored Shared Tracking Links
description: Instant APIs for retrieving stored shared Tracking Links
(campaigns) from the OnlyFansAPI Cache (free, no credits used)
- name: Stored Tracking Links
description: Instant APIs for retrieving stored tracking links from the
OnlyFansAPI Cache (free, no credits used)
- name: Stories
description: APIs for managing OnlyFans stories
- name: Story Highlights
description: APIs for managing OnlyFans story highlights
- name: Subscription Bundles
description: ""
- name: Tracking Links
description: APIs for managing tracking links
- name: Transactions
description: APIs for managing OnlyFans transactions
- name: Usage
description: Credit usage reporting for your team
- name: User List Collections
description: ""
- name: Users
description: APIs for fetching OnlyFans users
- name: Webhooks
description: ""
paths:
/api/webhooks/{webhook_id}/deliveries:
parameters:
- in: path
name: webhook_id
description: The ID of the webhook
example: wh_abc123
required: true
schema:
type: string
get:
summary: List Webhook Deliveries
operationId: listWebhookDeliveries
description: >-
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.
parameters:
- in: query
name: date_start
description: Only return deliveries recorded at or after this time (ISO 8601 or
date string). Must be a valid date.
example: 2026-01-01T00:00:00Z
required: false
schema:
type: string
description: Only return deliveries recorded at or after this time (ISO 8601 or
date string). Must be a valid date.
example: 2026-01-01T00:00:00Z
- in: query
name: date_end
description: Only return deliveries recorded at or before this time (ISO 8601 or
date string). Must be a valid date.
example: 2026-01-07T23:59:59Z
required: false
schema:
type: string
description: Only return deliveries recorded at or before this time (ISO 8601 or
date string). Must be a valid date.
example: 2026-01-07T23:59:59Z
- in: query
name: event
description: Only return deliveries for this event type. See the **List
Available Events** endpoint for all values.
example: subscriptions.new
required: false
schema:
type: string
description: Only return deliveries for this event type. See the **List
Available Events** endpoint for all values.
example: subscriptions.new
enum:
- messages.received
- messages.sent
- messages.ppv.unlocked
- messages.deleted
- chat_queue.updated
- chat_queue.finished
- subscriptions.new
- subscriptions.renewed
- users.typing
- users.online
- users.offline
- posts.liked
- tips.received
- transactions.new
- 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.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
- test-event
- in: query
name: succeeded
description: "Filter by outcome: `true` for delivered attempts, `false` for
failed ones."
example: false
required: false
schema:
type: boolean
description: "Filter by outcome: `true` for delivered attempts, `false` for
failed ones."
example: false
- in: query
name: limit
description: Rows per page (max `100`). Default `25`. Must be at least 1. Must
not be greater than 100.
example: 25
required: false
schema:
type: integer
description: Rows per page (max `100`). Default `25`. Must be at least 1. Must
not be greater than 100.
example: 25
- in: query
name: offset
description: Pagination offset. Default `0`. Must be at least 0.
example: 0
required: false
schema:
type: integer
description: Pagination offset. Default `0`. Must be at least 0.
example: 0
responses:
"200":
description: ""
content:
application/json:
schema:
type: object
example:
data:
- id: 918274
delivery_uuid: 9f1e2c4a-7b3d-4c1e-9a52-0f6b8d2e1a34
event: subscriptions.new
attempt: 2
succeeded: true
status_code: 200
error_type: null
error_message: null
idempotency_key: evt_9c1f0a4b2d7e6f3a8b5c1d9e0f2a3b4c5d6e7f80
url: https://example.com/webhooks
payload:
event: subscriptions.new
account_id: acct_abc123
payload:
id: 1234567
user:
id: 7654321
name: Jane Doe
username: janedoe
price: 9.99
redelivered_from: null
created_at: 2026-01-07T12:04:21.000000Z
- id: 918273
delivery_uuid: 9f1e2c4a-7b3d-4c1e-9a52-0f6b8d2e1a34
event: subscriptions.new
attempt: 1
succeeded: false
status_code: 503
error_type: GuzzleHttp\Exception\ServerException
error_message: "Server error: `POST https://example.com/webhooks` resulted in a
`503 Service Unavailable` response"
idempotency_key: evt_9c1f0a4b2d7e6f3a8b5c1d9e0f2a3b4c5d6e7f80
url: https://example.com/webhooks
payload:
event: subscriptions.new
account_id: acct_abc123
payload:
id: 1234567
user:
id: 7654321
name: Jane Doe
username: janedoe
price: 9.99
redelivered_from: null
created_at: 2026-01-07T12:04:11.000000Z
_pagination:
next_page: null
_meta:
_credits:
used: 0
balance: 1000000016
note: Always
_cache:
is_cached: false
note: Cache disabled for this endpoint
_rate_limits:
limit_minute: 1000
limit_day: 50000
remaining_minute: 998
remaining_day: 49996
properties:
data:
type: array
example:
- id: 918274
delivery_uuid: 9f1e2c4a-7b3d-4c1e-9a52-0f6b8d2e1a34
event: subscriptions.new
attempt: 2
succeeded: true
status_code: 200
error_type: null
error_message: null
idempotency_key: evt_9c1f0a4b2d7e6f3a8b5c1d9e0f2a3b4c5d6e7f80
url: https://example.com/webhooks
payload:
event: subscriptions.new
account_id: acct_abc123
payload:
id: 1234567
user:
id: 7654321
name: Jane Doe
username: janedoe
price: 9.99
redelivered_from: null
created_at: 2026-01-07T12:04:21.000000Z
- id: 918273
delivery_uuid: 9f1e2c4a-7b3d-4c1e-9a52-0f6b8d2e1a34
event: subscriptions.new
attempt: 1
succeeded: false
status_code: 503
error_type: GuzzleHttp\Exception\ServerException
error_message: "Server error: `POST https://example.com/webhooks` resulted in a
`503 Service Unavailable` response"
idempotency_key: evt_9c1f0a4b2d7e6f3a8b5c1d9e0f2a3b4c5d6e7f80
url: https://example.com/webhooks
payload:
event: subscriptions.new
account_id: acct_abc123
payload:
id: 1234567
user:
id: 7654321
name: Jane Doe
username: janedoe
price: 9.99
redelivered_from: null
created_at: 2026-01-07T12:04:11.000000Z
items:
type: object
properties:
id:
type: integer
example: 918274
delivery_uuid:
type: string
example: 9f1e2c4a-7b3d-4c1e-9a52-0f6b8d2e1a34
event:
type: string
example: subscriptions.new
attempt:
type: integer
example: 2
succeeded:
type: boolean
example: true
status_code:
type: integer
example: 200
error_type:
type: string
example: null
nullable: true
error_message:
type: string
example: null
nullable: true
idempotency_key:
type: string
example: evt_9c1f0a4b2d7e6f3a8b5c1d9e0f2a3b4c5d6e7f80
url:
type: string
example: https://example.com/webhooks
payload:
type: object
properties:
event:
type: string
example: subscriptions.new
account_id:
type: string
example: acct_abc123
payload:
type: object
properties:
id:
type: integer
example: 1234567
user:
type: object
properties:
id:
type: integer
example: 7654321
name:
type: string
example: Jane Doe
username:
type: string
example: janedoe
price:
type: number
example: 9.99
redelivered_from:
type: string
example: null
nullable: true
created_at:
type: string
example: 2026-01-07T12:04:21.000000Z
_pagination:
type: object
properties:
next_page:
type: string
example: null
nullable: true
_meta:
type: object
properties:
_credits:
type: object
properties:
used:
type: integer
example: 0
balance:
type: integer
example: 1000000016
note:
type: string
example: Always
_cache:
type: object
properties:
is_cached:
type: boolean
example: false
note:
type: string
example: Cache disabled for this endpoint
_rate_limits:
type: object
properties:
limit_minute:
type: integer
example: 1000
limit_day:
type: integer
example: 50000
remaining_minute:
type: integer
example: 998
remaining_day:
type: integer
example: 49996
tags:
- Webhooks
components:
securitySchemes:
default:
type: http
scheme: bearer
description: Get your API Key from OnlyFansAPI Console -
https://app.onlyfansapi.com/api-keys
````