> ## Documentation Index > Fetch the complete documentation index at: https://docs.fitsociety.io/llms.txt > Use this file to discover all available pages before exploring further. # Get a webhook delivery > Requires `webhook_deliveries:read`. Returns delivery status, retry metadata, response status, redacted response preview, and error summary. ## OpenAPI ````yaml /openapi/public-v1.json get /public/v1/webhooks/deliveries/{id} openapi: 3.1.0 info: title: FITsociety Public API v1 version: 1.0.0 description: >- Developer Public API endpoints under `/public/v1`. This reference is filtered to OAuth/Bearer Public API resources and excludes provider callback receivers, storefront routes, public widgets, wishlist routes, and access-device validation endpoints. contact: name: FITsociety Engineering servers: - url: https://api.fitsociety.io description: Production security: [] tags: - name: OAuth description: Public API OAuth endpoints for server-to-server client credentials. - name: Health description: Public API token health checks. - name: Platform description: >- Inspect Public API client context, capabilities, scopes, and redacted audit logs. - name: Company Catalog description: Read and manage company profile metadata and locations. - name: Clients description: >- Create and manage clients through the Public API using Bearer access tokens. - name: Coaches description: Retrieve coaches for the authenticated company via integrations. - name: Calendar Events description: Read Public API calendar events. - name: Calendar Templates description: >- Read and manage event types and event templates used by calendar availability and bookings. - name: Calendar Extensions description: >- Read recurring bookings, booking requests, calendar tasks, and availability closure metadata. - name: Availability description: Read bookable availability slots and signed availability tokens. - name: Availability Management description: >- Manage coach and location availability templates used to derive bookable slots. - name: Bookings description: Read and manage Public API bookings. - name: Finance description: >- Read invoices, payments, products, subscriptions, memberships, and credits with guarded finance writes. - name: Webhooks description: >- Manage outbound webhook subscriptions and inspect delivery attempts through Public API Bearer endpoints. - name: Measurements description: Read and write client measurement entries. - name: Progress Photos description: Read client progress photo metadata and short-lived signed media URLs. - name: Forms description: Read form metadata and submissions, and assign forms. - name: Documents description: Read document and folder metadata only. - name: Habits description: Read habits and habit entries. - name: Goals description: Read client goal summaries. - name: Messaging description: Read client chat and message metadata. - name: Reports description: Read aggregate attendance, revenue, and retention summaries. paths: /public/v1/webhooks/deliveries/{id}: get: tags: - Webhooks summary: Get a webhook delivery description: >- Requires `webhook_deliveries:read`. Returns delivery status, retry metadata, response status, redacted response preview, and error summary. operationId: getPublicV1WebhooksDeliveriesById parameters: - name: id in: path required: true schema: type: string example: 66f7b8b1e13c8d25f4d3d91a description: Webhook delivery id. responses: '200': description: Webhook delivery fetched content: application/json: schema: allOf: - $ref: '#/components/schemas/PublicApiSuccessResponse' - type: object properties: data: type: object properties: delivery: $ref: '#/components/schemas/PublicWebhookDelivery' examples: success: summary: Successful response value: data: delivery: id: 66f7b8b1e13c8d25f4d3d91a subscriptionId: 66f7b8b1e13c8d25f4d3d90a eventId: 66f7b8b1e13c8d25f4d3d92a eventType: client.created status: delivered attemptCount: 1 maxAttempts: 3 target: type: url url: https://example.com/fitsociety/webhooks responseStatusCode: 200 responseBodyPreview: '{"ok":true}' errorMessage: '' nextAttemptAt: '2026-07-14T10:00:00.000Z' deliveredAt: '2026-07-14T10:00:00.000Z' lastAttemptAt: '2026-07-14T10:00:00.000Z' createdAt: '2026-07-14T10:00:00.000Z' updatedAt: '2026-07-14T10:00:00.000Z' meta: requestId: 4f849d7d-f4f1-45cc-b4b7-3984a3d17f83 rateLimit: limit: 10 remaining: 9 resetSeconds: 1 '400': description: Invalid webhook request content: application/json: schema: $ref: '#/components/schemas/PublicApiError' examples: invalidRequest: summary: Invalid request value: error: code: 400 key: request.invalid message: The request is invalid. meta: requestId: 4f849d7d-f4f1-45cc-b4b7-3984a3d17f83 rateLimit: limit: 10 remaining: 9 resetSeconds: 1 '401': description: Missing or invalid Public API Bearer token content: application/json: schema: $ref: '#/components/schemas/PublicApiError' examples: missingBearer: summary: Missing Bearer token value: error: code: 401 key: auth.missing_bearer message: Authorization Bearer token is required. meta: requestId: 4f849d7d-f4f1-45cc-b4b7-3984a3d17f83 rateLimit: limit: 10 remaining: 9 resetSeconds: 1 invalidToken: summary: Invalid or expired token value: error: code: 401 key: auth.invalid_token message: The access token is invalid or expired. meta: requestId: 4f849d7d-f4f1-45cc-b4b7-3984a3d17f83 rateLimit: limit: 10 remaining: 9 resetSeconds: 1 invalidClient: summary: Inactive or revoked client value: error: code: 401 key: auth.invalid_client message: The Public API client is inactive or revoked. meta: requestId: 4f849d7d-f4f1-45cc-b4b7-3984a3d17f83 rateLimit: limit: 10 remaining: 9 resetSeconds: 1 '403': description: Bearer token does not include the required scope content: application/json: schema: $ref: '#/components/schemas/PublicApiError' examples: insufficientScopes: summary: Missing required scope value: error: code: 403 key: scopes.insufficient message: The access token does not include the required scope. details: requiredScopes: - webhook_deliveries:read meta: requestId: 4f849d7d-f4f1-45cc-b4b7-3984a3d17f83 rateLimit: limit: 10 remaining: 9 resetSeconds: 1 '404': description: Webhook delivery not found content: application/json: schema: $ref: '#/components/schemas/PublicApiError' examples: notFound: summary: Resource not found value: error: code: 404 key: resource.not_found message: The requested Public API resource was not found. meta: requestId: 4f849d7d-f4f1-45cc-b4b7-3984a3d17f83 rateLimit: limit: 10 remaining: 9 resetSeconds: 1 '429': description: Public API rate limit exceeded content: application/json: schema: $ref: '#/components/schemas/PublicApiError' examples: rateLimitExceeded: summary: Rate limit exceeded value: error: code: 429 key: rate_limit.exceeded message: Too many Public API requests. Retry later. meta: requestId: 4f849d7d-f4f1-45cc-b4b7-3984a3d17f83 rateLimit: limit: 10 remaining: 0 resetSeconds: 1 retryAfterSeconds: 1 '500': description: >- Server error. The request could not be completed because of an unexpected Public API server failure. content: application/json: schema: $ref: '#/components/schemas/PublicApiError' examples: serverInternalError: summary: Unexpected server error value: error: code: 500 key: server.internal_error message: An unexpected Public API server error occurred. meta: requestId: 4f849d7d-f4f1-45cc-b4b7-3984a3d17f83 rateLimit: limit: 10 remaining: 9 resetSeconds: 1 security: - PublicBearerAuth: [] x-codeSamples: - lang: cURL label: cURL source: >- curl -X GET "https://api.fitsociety.io/public/v1/webhooks/deliveries/66f7b8b1e13c8d25f4d3d91a" \ -H "Authorization: Bearer " components: schemas: PublicApiSuccessResponse: type: object additionalProperties: false required: - data - meta properties: data: type: object meta: $ref: '#/components/schemas/PublicApiMeta' PublicWebhookDelivery: type: object properties: id: type: string example: 66f7b8b1e13c8d25f4d3d91a subscriptionId: type: string example: 66f7b8b1e13c8d25f4d3d90a eventId: type: string example: 66f7b8b1e13c8d25f4d3d92a eventType: $ref: '#/components/schemas/PublicWebhookEventType' status: $ref: '#/components/schemas/PublicWebhookDeliveryStatus' attemptCount: type: integer example: 1 maxAttempts: type: integer example: 3 target: $ref: '#/components/schemas/PublicWebhookTarget' responseStatusCode: type: - integer - 'null' example: 200 responseBodyPreview: type: string description: >- Redacted response body preview from the target, capped by the delivery processor. example: '{"ok":true}' errorMessage: type: string example: '' nextAttemptAt: type: - string - 'null' format: date-time deliveredAt: type: - string - 'null' format: date-time lastAttemptAt: type: - string - 'null' format: date-time createdAt: type: - string - 'null' format: date-time updatedAt: type: - string - 'null' format: date-time PublicApiError: type: object additionalProperties: false required: - error - meta properties: error: type: object additionalProperties: false required: - code - key - message properties: code: type: integer example: 401 key: type: string example: auth.invalid_token message: type: string example: The access token is invalid. details: type: object additionalProperties: true meta: $ref: '#/components/schemas/PublicApiMeta' PublicApiMeta: type: object additionalProperties: false required: - requestId properties: requestId: type: string description: Stable request correlation id. Mirrors `X-Request-Id` when supplied. example: 4f849d7d-f4f1-45cc-b4b7-3984a3d17f83 rateLimit: $ref: '#/components/schemas/PublicApiRateLimitMeta' PublicWebhookEventType: type: string enum: - subscription.test - client.created - client.updated - client.archived - client.invited - client.portal_access.changed - client.relationship.approved - client.relationship.rejected - client.note.created - client.note.updated - client.note.deleted - booking.created - booking.updated - booking.cancelled - booking_request.created - booking_request.approved - booking_request.rejected - recurring_booking.changed - calendar_task.created - calendar_task.updated - calendar_task.cancelled - invoice.created - invoice.sent - invoice.overdue - invoice.cancelled - invoice.paid - payment.succeeded - payment.failed - payment.request.created - payment.request.cancelled - chargeback.created - subscription.changed - subscription.cancelled - client_product.assigned - client_product.revoked - credit.assigned - credit.adjusted - credit.revoked - membership.assigned - form.assigned - form.submitted - intake.submitted - checkup.assigned - checkup.submitted - measurement.created - measurement.updated - progress_photo.created - goal.updated - habit_entry.created - document.linked - document.updated - document.archived example: client.created PublicWebhookDeliveryStatus: type: string enum: - pending - delivering - delivered - failed - exhausted example: delivered PublicWebhookTarget: type: object required: - type - url properties: type: type: string enum: - url example: url url: type: string format: uri example: https://example.com/fitsociety/webhooks PublicApiRateLimitMeta: type: object additionalProperties: false properties: limit: type: integer example: 10 remaining: type: integer example: 9 resetSeconds: type: integer description: Seconds until the current rate limit window resets. example: 1 retryAfterSeconds: type: integer description: Present when the request was rate limited. example: 1 securitySchemes: PublicBearerAuth: type: http scheme: bearer bearerFormat: Opaque description: >- Public API access token issued by `/public/v1/oauth/token`. Example: `Authorization: Bearer fspt_...`. ````