> ## 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. # List execution logs > List delivery attempts for a subscription. ## OpenAPI ````yaml apis/fx-webhook/openapi.yml GET /v1/subscriptions/{subscriptionId}/executionLogs 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: get: tags: - Execution logs summary: List execution logs description: List delivery attempts for a subscription, most recent first. operationId: listExecutionLogs parameters: - $ref: '#/components/parameters/SubscriptionId' - $ref: '#/components/parameters/TraceVersion' - $ref: '#/components/parameters/PaginationLimit' - $ref: '#/components/parameters/PaginationCursor' - $ref: '#/components/parameters/PaginationDirection' - $ref: '#/components/parameters/PaginationSortOrder' - $ref: '#/components/parameters/Filters' responses: '200': description: Paginated list of execution logs. headers: X-Request-Id: $ref: '#/components/headers/RequestId' content: application/json: schema: $ref: '#/components/schemas/ExecutionLogList' '401': $ref: '#/components/responses/UnauthorizedError' '404': description: Subscription 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 TraceVersion: name: X-Trace-Version in: header required: false description: API version. Omit to use the default version. schema: type: string example: '1' PaginationLimit: name: limit in: query required: false description: Maximum number of items to return. Defaults to 10. schema: type: integer default: 10 minimum: 1 maximum: 100 PaginationCursor: name: cursor in: query required: false description: Opaque cursor for fetching the next or previous page. schema: type: string PaginationDirection: name: direction in: query required: false description: Direction of pagination relative to the cursor. schema: type: string enum: - NEXT - PREVIOUS PaginationSortOrder: name: sortOrder in: query required: false description: Sort order for results. Defaults to DESCENDING. schema: type: string enum: - ASCENDING - DESCENDING default: DESCENDING Filters: name: filters in: query required: false description: > Filter expression using LHS Brackets syntax (`field[operator]=value`). Combine multiple conditions with `and(...)`, `or(...)`, or `;` (implicit AND). See the [Filtering](/guides/principles/filtering) guide for the full operator catalog and examples. schema: type: string example: status[eq]=ACTIVE 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: ExecutionLogList: type: object properties: data: type: array items: $ref: '#/components/schemas/ExecutionLog' meta: $ref: '#/components/schemas/PageMetadata' required: - data - meta 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 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 PageMetadata: type: object description: Cursor-based pagination metadata. properties: previousCursor: type: - string - 'null' description: Cursor for the previous page. `null` on the first page. example: null nextCursor: type: - string - 'null' description: Cursor for the next page. `null` on the last page. example: eyJpZCI6ImFjY18wMDIifQ total: type: integer description: Number of items in the current page. example: 10 required: - previousCursor - nextCursor - total 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 `. See the [Authentication](/guides/authentication) guide for how to obtain one. ````