> ## Documentation Index > Fetch the complete documentation index at: https://docs.nylon.dev/llms.txt > Use this file to discover all available pages before exploring further. # List deliveries > The delivery log for one endpoint, with payloads and responses. ## OpenAPI ````yaml /openapi.yaml get /v1/webhooks/{webhookId}/deliveries openapi: 3.1.0 info: title: Nylon API version: 1.0.0 description: | One API for publishing to twelve social networks. You address a post to connected profile ids; Nylon knows which network each one belongs to, what that network accepts, and how to get the media there. Character limits, media specs, upload protocols and threading rules are normalised before the request reaches a platform, and every failure comes back in one error taxonomy. ## Conventions - Request and response fields are `snake_case`. - Successful responses wrap the payload in `data`. List responses add `meta.pagination`. - Failures return `{ "error": { "code", "message", "details?" } }`. Branch on `code`; `message` is written for humans and may change. - Times are ISO 8601 with a `Z` offset. - Successful responses carry `RateLimit-Limit`, `RateLimit-Remaining` and `RateLimit-Reset`. A `429` carries those plus `Retry-After`. servers: - url: https://api.nylon.dev description: Production security: - bearerAuth: [] tags: - name: Posts description: Create, schedule, inspect, edit and retry posts. - name: Profiles description: Social profiles connected to the authenticated Nylon account. - name: Connections description: Start a connection and see which networks are available. - name: Networks description: What each network accepts, as data. - name: Validation description: Dry-run a post without publishing it. - name: Webhooks description: Endpoints Nylon calls when a post finishes or a profile stops working. paths: /v1/webhooks/{webhookId}/deliveries: parameters: - $ref: '#/components/parameters/WebhookId' get: tags: - Webhooks summary: List deliveries description: | What Nylon tried to send to this endpoint and what came back, newest first. Each row carries the event payload, the response status and the response body, which is what lets you tell a signature your receiver rejected from an event that was never queued. operationId: listWebhookDeliveries parameters: - $ref: '#/components/parameters/Limit' - $ref: '#/components/parameters/Offset' - name: status in: query description: Comma-separated delivery statuses to include. schema: type: string example: pending,failed - name: event in: query description: Comma-separated event types to include. schema: type: string example: post.failed responses: '200': description: The delivery log. content: application/json: schema: $ref: '#/components/schemas/WebhookDeliveryListResponse' '401': $ref: '#/components/responses/Unauthorized' '404': $ref: '#/components/responses/NotFound' '429': $ref: '#/components/responses/RateLimited' '500': $ref: '#/components/responses/InternalError' components: parameters: WebhookId: name: webhookId in: path required: true description: The Nylon id of the webhook endpoint. schema: type: string example: cly7w1a2b0001x8b3k9m2p0zz Limit: name: limit in: query description: Page size, 1–100. schema: type: integer minimum: 1 maximum: 100 default: 25 Offset: name: offset in: query description: Rows to skip. schema: type: integer minimum: 0 default: 0 schemas: WebhookDeliveryListResponse: type: object required: - data properties: data: type: array items: $ref: '#/components/schemas/WebhookDelivery' meta: type: object properties: pagination: $ref: '#/components/schemas/Pagination' WebhookDelivery: type: object required: - id - webhook_id - event - status - attempts - created_at properties: id: type: string description: >- Also the `id` in the payload and the `Nylon-Delivery` header — deduplicate on it. example: cly7w4c5d0002x8b3n1q3r0aa webhook_id: type: string event: type: string example: post.failed status: type: string enum: - pending - delivered - failed description: >- `pending` means a further attempt is due; `failed` means the attempts are exhausted. attempts: type: integer example: 1 next_attempt_at: type: - string - 'null' format: date-time description: When the next attempt is due. Null once the delivery is settled. response_status: type: - integer - 'null' example: 200 response_body: type: - string - 'null' description: The first 2000 characters of what your endpoint returned. error: type: - string - 'null' example: The endpoint returned 500. delivered_at: type: - string - 'null' format: date-time created_at: type: string format: date-time data: type: object description: The event payload, exactly as it was sent under `data`. additionalProperties: true Pagination: type: object required: - limit - offset - total - has_more properties: limit: type: integer example: 25 offset: type: integer example: 0 total: type: integer example: 132 has_more: type: boolean example: true ErrorResponse: type: object required: - error properties: error: $ref: '#/components/schemas/Error' Error: type: object required: - code - message properties: code: type: string description: The stable identifier to branch on. enum: - invalid_request - unauthorized - payment_required - forbidden - not_found - conflict - rate_limited - unsupported - publish_failed - internal_error example: unauthorized message: type: string description: Written for humans. Do not match on it. example: A valid Nylon API key is required. details: type: array description: Present when the failure has a per-field or per-network breakdown. items: $ref: '#/components/schemas/ErrorDetail' ErrorDetail: type: object required: - message properties: field: type: string description: The request field the problem is about. example: profile_ids network: type: string description: The network the problem is about. example: instagram code: type: string description: | Machine-readable identifier for this problem. On a per-network detail this is a publishing code: `invalid_request`, `unsupported`, `media_error`, `reauthentication_required`, `rejected_by_network`, `network_error`, `timeout`, `profile_unavailable` or `internal_error`. example: invalid_request message: type: string example: >- Instagram requires at least 1 media item — text-only posts are not supported. responses: Unauthorized: description: The bearer API key is missing, malformed or revoked. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' examples: missingKey: value: error: code: unauthorized message: A valid Nylon API key is required. NotFound: description: No such resource on this account. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' examples: missing: value: error: code: not_found message: Post could not be found. RateLimited: description: | Too many requests for this API key. Reads allow 120 requests a minute; publishing endpoints allow 30, because each one costs real upstream calls. The limit is per key, not per IP. headers: Retry-After: $ref: '#/components/headers/RetryAfter' RateLimit-Limit: $ref: '#/components/headers/RateLimitLimit' RateLimit-Remaining: $ref: '#/components/headers/RateLimitRemaining' RateLimit-Reset: $ref: '#/components/headers/RateLimitReset' content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' examples: throttled: value: error: code: rate_limited message: Too many requests. Retry after the window resets. InternalError: description: Nylon encountered an unexpected error. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' headers: RetryAfter: description: Seconds to wait before retrying. schema: type: integer example: 47 RateLimitLimit: description: Requests allowed in the current window. schema: type: integer example: 120 RateLimitRemaining: description: Requests left in the current window. schema: type: integer example: 119 RateLimitReset: description: Seconds until the window resets. schema: type: integer example: 47 securitySchemes: bearerAuth: type: http scheme: bearer bearerFormat: Nylon API key description: An API key beginning with `nylon_live_`. ````