---
title: "List post-processor log entries with optional filters (admin only)"
method: GET
path: "/api/v1/admin/post-processor-logs"
tags: ["Post-Processor Logs", "Admin"]
---

# List post-processor log entries with optional filters (admin only)

`GET /api/v1/admin/post-processor-logs`

List post-processor log entries with optional filters (admin only)

## Query parameters

- `page` integer — Page number (1-based)
- `limit` integer — Number of items per page (max 100)
- `sort` string — Sort field and direction (e.g., "created_at:desc", "amount:asc")
- `merchant_id` string, uuid — Filter by merchant ID
- `action` union — Type of post-processor action
  - 'FEE_TRANSFER'
  - 'CURRENCY_CONVERSION'
  - 'PAYOUT'
  - 'REFUND_RETENTION'
  - 'MANUAL'
- `status` union — Status of the post-processor log entry
  - 'INITIATED'
  - 'COMPLETED'
  - 'FAILED'
- `from_date` string, date-time — Filter logs created after this date
- `to_date` string, date-time — Filter logs created before this date

## Response `200`

Success

- AdminPostProcessorLogListResponse — Paginated response with metadata
  - `success` boolean, required — Indicates if the request was successful
  - `data` object[], required
    - `id` string, uuid, required — Log entry ID
    - `transaction_id` string, uuid, nullable, required — Associated transaction ID
    - `merchant_id` string, uuid, required — Merchant ID
    - `action` union, required — Type of post-processor action
      - 'FEE_TRANSFER'
      - 'CURRENCY_CONVERSION'
      - 'PAYOUT'
      - 'REFUND_RETENTION'
      - 'MANUAL'
    - `status` union, required — Status of the post-processor log entry
      - 'INITIATED'
      - 'COMPLETED'
      - 'FAILED'
    - `from_currency` string, required — Source currency code
    - `to_currency` string, nullable, required — Destination currency code
    - `amount` string, required — Transfer amount
    - `converted_amount` string, nullable, required — Converted amount after FX
    - `exchange_rate` string, nullable, required — Exchange rate applied
    - `tm_transaction_id` string, nullable, required — TransferMate transaction ID
    - `reference` string, nullable, required — Payment reference
    - `error_message` string, nullable, required — Error message if failed
    - `source_account_id` string, uuid, nullable, required — Source account ID
    - `source_account_type` union, required — Type of source account
      - 'MERCHANT_BANK_ACCOUNT'
      - 'FEE_ACCOUNT'
    - `destination_account_id` string, uuid, nullable, required — Destination account ID
    - `destination_account_type` union, required — Type of destination account
      - 'MERCHANT_BANK_ACCOUNT'
      - 'FEE_ACCOUNT'
      - 'CUSTOMER_BANK_ACCOUNT'
    - `reason` string, nullable, required — Reason for manual transfer
    - `performed_by_user_id` string, uuid, nullable, required — User who performed the manual transfer
    - `created_at` string, date-time, required — When the log entry was created
  - `pagination` object, required — Metadata for paginated responses
    - `total` integer, required — Total number of items
    - `page` integer, required — Current page number
    - `limit` integer, required — Number of items per page
    - `totalPages` integer, required — Total number of pages
    - `hasNextPage` boolean, required — Whether there is a next page
    - `hasPreviousPage` boolean, required — Whether there is a previous page

## Other responses

- `401` — Unauthorized
- `403` — Forbidden

---

[API](https://skmtc.net/banqzinc/apis/quidkey-api.md) · [All operations](https://skmtc.net/banqzinc/apis/quidkey-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/banqzinc/quidkey-api/versions/f86d2bdbcb08/schema)