> ## Documentation Index
> Fetch the complete documentation index at: https://docs.stabyl.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get a projected Partner webhook delivery

> Returns one owned delivery and completed logical attempts in ascending attempt order. Attempts expose only signing secret version numbers, never secrets or signature values. Unknown, cross-account, and domain-inaccessible identifiers return 404.



## OpenAPI

````yaml /openapi/openapi.json get /partner/webhook/deliveries/{delivery_id}
openapi: 3.1.0
info:
  title: Stabyl API
  description: >-
    REST API for approved Stabyl accounts to automate exchange, wallet, and
    non-production simulation workflows.
  contact:
    name: Stabyl Support
    email: support@stabyl.com
  license:
    name: Proprietary
  version: 1.0.0
servers:
  - url: https://api.stabyl.com/v1
    description: Production
  - url: https://api-staging.stabyl.com/v1
    description: Staging
security: []
tags:
  - name: Exchange
    description: Trading market data and order management for account automation.
  - name: Wallets
    description: >-
      Supported routes, deposit destinations, balances, transactions, and saved
      recipients.
  - name: Webhooks
    description: >-
      Outbound event delivery configuration and eventually consistent delivery
      history. Verify Standard Webhooks webhook-id, webhook-timestamp, and
      webhook-signature headers against the unchanged raw request body before
      parsing JSON.
  - name: Simulation
    description: Non-production endpoints for testing integration behavior.
paths:
  /partner/webhook/deliveries/{delivery_id}:
    get:
      tags:
        - Webhooks
      summary: Get a projected Partner webhook delivery
      description: >-
        Returns one owned delivery and completed logical attempts in ascending
        attempt order. Attempts expose only signing secret version numbers,
        never secrets or signature values. Unknown, cross-account, and
        domain-inaccessible identifiers return 404.
      operationId: get_partner_webhook_deliveries_delivery_id
      parameters:
        - name: delivery_id
          in: path
          description: Deterministic delivery identifier
          required: true
          schema:
            type: string
            format: uuid
      responses:
        '200':
          description: Delivery and attempt history
          content:
            application/json:
              schema:
                type: object
                required:
                  - status
                  - data
                properties:
                  data:
                    $ref: '#/components/schemas/PartnerWebhookDeliveryDetailResponse'
                  status:
                    type: string
                    enum:
                      - success
              example:
                data:
                  attempts:
                    - attempt_number: 1
                      attempted_at: '2026-07-12T11:05:01Z'
                      completed_at: '2026-07-12T11:05:01.083Z'
                      duration_ms: 83
                      error_code: null
                      http_status: 204
                      id: 9192a679-1f4a-5a38-9b32-a156589665d1
                      next_retry_at: null
                      outcome: delivered
                      signing_secret_versions:
                        - 2
                        - 1
                  delivery:
                    attempt_count: 1
                    cancelled_at: null
                    created_at: '2026-07-12T11:05:00Z'
                    delivered_at: '2026-07-12T11:05:01.083Z'
                    event_id: d1232fb7-a993-52ec-a8f0-0ec026397553
                    event_type: exchange.accepted
                    failed_at: null
                    id: 63422af5-8417-5ffc-8607-26c1dd2e5a4b
                    last_attempt_at: '2026-07-12T11:05:01Z'
                    last_error_code: null
                    last_http_status: 204
                    next_attempt_at: null
                    status: delivered
                    updated_at: '2026-07-12T11:05:01.083Z'
                    webhook_id: 01980d95-5537-76aa-88a8-ad59117632ef
                status: success
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                type: object
                required:
                  - status
                  - error
                properties:
                  error:
                    type: object
                    required:
                      - code
                      - message
                    properties:
                      code:
                        type: string
                        example: UNAUTHORIZED
                      message:
                        type: string
                        example: missing X-Api-Key header
                  status:
                    type: string
                    enum:
                      - error
              example:
                error:
                  code: UNAUTHORIZED
                  message: missing X-Api-Key header
                status: error
        '403':
          description: Missing `webhooks:view`
          content:
            application/json:
              schema:
                type: object
                required:
                  - status
                  - error
                properties:
                  error:
                    type: object
                    required:
                      - code
                      - message
                    properties:
                      code:
                        type: string
                        example: MISSING_SCOPE
                      message:
                        type: string
                        example: missing_scope
                  status:
                    type: string
                    enum:
                      - error
              example:
                error:
                  code: MISSING_SCOPE
                  message: missing_scope
                status: error
        '404':
          description: Delivery not found
          content:
            application/json:
              schema:
                type: object
                required:
                  - status
                  - error
                properties:
                  error:
                    type: object
                    required:
                      - code
                      - message
                    properties:
                      code:
                        type: string
                        example: NOT_FOUND
                      message:
                        type: string
                        example: resource not found
                  status:
                    type: string
                    enum:
                      - error
              example:
                error:
                  code: NOT_FOUND
                  message: resource not found
                status: error
      security:
        - api_key: []
components:
  schemas:
    PartnerWebhookDeliveryDetailResponse:
      type: object
      required:
        - delivery
        - attempts
      properties:
        attempts:
          type: array
          items:
            $ref: '#/components/schemas/PartnerWebhookDeliveryAttemptResponse'
        delivery:
          $ref: '#/components/schemas/PartnerWebhookDeliveryResponse'
    PartnerWebhookDeliveryAttemptResponse:
      type: object
      required:
        - id
        - attempt_number
        - outcome
        - signing_secret_versions
        - attempted_at
        - completed_at
      properties:
        attempt_number:
          type: integer
          format: int32
        attempted_at:
          type: string
          format: date-time
        completed_at:
          type: string
          format: date-time
        duration_ms:
          type:
            - integer
            - 'null'
          format: int32
        error_code:
          type:
            - string
            - 'null'
        http_status:
          type:
            - integer
            - 'null'
          format: int32
        id:
          type: string
          format: uuid
        next_retry_at:
          type:
            - string
            - 'null'
          format: date-time
        outcome:
          type: string
        signing_secret_versions:
          type: array
          items:
            type: integer
            format: int32
          description: Secret version numbers used, never signing material or signatures.
    PartnerWebhookDeliveryResponse:
      type: object
      required:
        - id
        - event_id
        - webhook_id
        - event_type
        - status
        - attempt_count
        - created_at
        - updated_at
      properties:
        attempt_count:
          type: integer
          format: int32
        cancelled_at:
          type:
            - string
            - 'null'
          format: date-time
        created_at:
          type: string
          format: date-time
        delivered_at:
          type:
            - string
            - 'null'
          format: date-time
        event_id:
          type: string
          format: uuid
        event_type:
          $ref: '#/components/schemas/PartnerWebhookEventType'
        failed_at:
          type:
            - string
            - 'null'
          format: date-time
        id:
          type: string
          format: uuid
        last_attempt_at:
          type:
            - string
            - 'null'
          format: date-time
        last_error_code:
          type:
            - string
            - 'null'
        last_http_status:
          type:
            - integer
            - 'null'
          format: int32
        next_attempt_at:
          type:
            - string
            - 'null'
          format: date-time
          description: >-
            Display-only projection; delivery scheduling remains authoritative
            in the broker.
        status:
          type: string
        updated_at:
          type: string
          format: date-time
        webhook_id:
          type: string
          format: uuid
    PartnerWebhookEventType:
      type: string
      description: Exact Partner webhook topics supported by the V1 public contract.
      enum:
        - deposit.action_required
        - deposit.success
        - deposit.failed
        - withdrawal.success
        - withdrawal.failed
        - exchange.accepted
        - exchange.filled
        - exchange.replaced
        - exchange.cancelled
        - exchange.rejected
  securitySchemes:
    api_key:
      type: apiKey
      in: header
      name: X-Api-Key
      description: >-
        API credential. Withdrawal quote and submit operations additionally
        require the documented Ed25519 timestamp, nonce, and signature headers.
      x-default: sb_test_your_key

````