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

# Get an execution log

> Retrieve a single webhook delivery attempt.



## OpenAPI

````yaml apis/fx-webhook/openapi.yml GET /v1/subscriptions/{subscriptionId}/executionLogs/{executionLogId}
openapi: 3.1.1
info:
  title: Trace Finance Webhooks API
  version: 1.0.0
  description: >
    API for managing webhook subscriptions and inspecting webhook delivery
    history on the Trace Finance platform.
servers:
  - url: https://api.sandbox.tracefinance.com
    description: Sandbox
security:
  - bearerAuth: []
tags:
  - name: Subscriptions
    description: Create, list, update, and delete webhook subscriptions.
  - name: Execution logs
    description: Inspect webhook delivery attempts and resend failed deliveries.
  - name: References
    description: Look up the resources and event types available for subscription.
paths:
  /v1/subscriptions/{subscriptionId}/executionLogs/{executionLogId}:
    get:
      tags:
        - Execution logs
      summary: Get an execution log
      description: >-
        Retrieve a single delivery attempt, including the request payload and
        customer response status.
      operationId: getExecutionLog
      parameters:
        - $ref: '#/components/parameters/SubscriptionId'
        - $ref: '#/components/parameters/ExecutionLogId'
        - $ref: '#/components/parameters/TraceVersion'
      responses:
        '200':
          description: Execution log entry.
          headers:
            X-Request-Id:
              $ref: '#/components/headers/RequestId'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ExecutionLog'
        '401':
          $ref: '#/components/responses/UnauthorizedError'
        '404':
          description: Execution log not found.
          headers:
            X-Request-Id:
              $ref: '#/components/headers/RequestId'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
components:
  parameters:
    SubscriptionId:
      name: subscriptionId
      in: path
      required: true
      description: UUID of the subscription.
      schema:
        type: string
        format: uuid
    ExecutionLogId:
      name: executionLogId
      in: path
      required: true
      description: UUID of the execution log entry.
      schema:
        type: string
        format: uuid
    TraceVersion:
      name: X-Trace-Version
      in: header
      required: false
      description: API version. Omit to use the default version.
      schema:
        type: string
        example: '1'
  headers:
    RequestId:
      description: >-
        Unique request identifier emitted on every response. Reference it when
        contacting Trace Finance support so we can trace the request end-to-end.
        See [Errors](/guides/principles/errors).
      schema:
        type: string
        format: uuid
  schemas:
    ExecutionLog:
      type: object
      description: >-
        A record of a single webhook delivery attempt, including request
        payload, response status, and retry history.
      properties:
        id:
          type: string
          format: uuid
          example: 7c9b46e8-3f33-4edc-94e2-bd4b58e0c62f
          readOnly: true
        companyId:
          type: string
          description: Company identifier that owns the subscription.
          example: 11111111-1111-1111-1111-111111111111
        subscriptionId:
          type: string
          format: uuid
          example: 8a13c6a4-1a3d-4f49-ad62-9dca8c47e2c6
        messageId:
          type: string
          description: >-
            Unique identifier of the event delivery, also sent as the
            `X-Message-Id` header on the outbound request.
          example: 9f1d83b2-4d6c-49ad-9bb6-8cf4a3a25de0
        eventType:
          $ref: '#/components/schemas/EventType'
        url:
          type: string
          format: uri
          description: URL that was called.
          example: https://api.example.com/trace-webhooks
        payload:
          type: string
          description: The JSON body that was delivered, serialized as a string.
          example: >-
            {"id":"1f3a8c8d-2e1a-4b3a-9d2e-7c1a4b3a9d2e","customerId":"...","atTime":"2026-04-28T14:32:11Z"}
        httpStatus:
          type: integer
          description: >-
            HTTP status code returned by the customer endpoint. `0` if the
            request never received a response.
          example: 200
        error:
          type:
            - string
            - 'null'
          description: Error message captured when delivery failed. `null` on success.
          example: null
        status:
          $ref: '#/components/schemas/ExecutionLogStatus'
          readOnly: true
        retryAttempts:
          type: integer
          description: Number of retry attempts made after the initial delivery.
          example: 0
        createdAt:
          type: string
          format: date-time
          example: '2026-04-28T14:32:11Z'
          readOnly: true
        updatedAt:
          type: string
          format: date-time
          example: '2026-04-28T14:32:12Z'
          readOnly: true
      required:
        - id
        - companyId
        - subscriptionId
        - messageId
        - eventType
        - url
        - payload
        - httpStatus
        - status
        - retryAttempts
        - createdAt
        - updatedAt
    ErrorResponse:
      type: object
      description: >-
        Standard error response. See the [Errors](/guides/principles/errors)
        guide for the full code catalog.
      properties:
        code:
          type: string
          example: RESOURCE_NOT_FOUND
        message:
          type: string
          example: >-
            Subscription with id '8a13c6a4-1a3d-4f49-ad62-9dca8c47e2c6' was not
            found.
        details:
          type: object
          additionalProperties: true
      required:
        - code
        - message
    EventType:
      type: string
      description: >-
        The specific event type within a resource, sent as the `X-Event-Type`
        header on each delivery.
      enum:
        - ACCOUNT_CREATED
        - ACCOUNT_ACTION_REQUIRED
        - ACCOUNT_ASSET_ACTIVATED
        - ACCOUNT_ASSET_FAILED
        - BENEFICIARY_PAYMENT_INSTRUCTION_CREATED
        - BENEFICIARY_PAYMENT_INSTRUCTION_APPROVED
        - BENEFICIARY_PAYMENT_INSTRUCTION_REJECTED
        - OPERATION_REQUESTED
        - OPERATION_COMPLETED
        - OPERATION_FAILED
        - OPERATION_CUSTOMER_ACTION_REQUIRED
      example: OPERATION_REQUESTED
    ExecutionLogStatus:
      type: string
      enum:
        - SUCCESS
        - FAILED
      description: >-
        Outcome of a delivery attempt. `SUCCESS` indicates a 2xx response was
        received; `FAILED` indicates a non-2xx response or a network error.
      example: SUCCESS
  responses:
    UnauthorizedError:
      description: Missing or invalid authentication token.
      headers:
        X-Request-Id:
          $ref: '#/components/headers/RequestId'
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: >-
        JWT bearer token. Include as `Authorization: Bearer <token>`. See the
        [Authentication](/guides/authentication) guide for how to obtain one.

````