---
title: "Fetch Deflection Logs"
method: GET
path: "/api/v3/deflections/logs"
tags: ["Deflections"]
---

# Fetch Deflection Logs

`GET /api/v3/deflections/logs`

Get a list of all look up requests.

## Query parameters

- `page` integer, nullable
- `per` integer, nullable

## Headers

- `X-API-Key` string, required

## Request body

- ClarityLogBody
  - `filter` ClarityLogBodyClarityLogFilter
    - `endDate` string, nullable — The end date of the logs to fetch in ISO8601 format, e.g. '2025-12-03T23:59:59Z'.
    - `gateway` string, nullable — The gateway that the matched transaction is on (only supported for orchestrators or multi-gateway PSPs such as Braintree).
    - `startDate` string, nullable — The start date of the logs to fetch in ISO8601 format, e.g. '2025-01-01T00:00:00Z'.
    - `status` string, nullable

## Response `200`

OK

- ClarityLogResponse
  - `logs` ClarityLog[], required
    - `request` ClarityLogRequest, required — The request payload for a deflection lookup.
      - `arn` string, nullable — The Acquirer Reference Number (ARN) of the transaction.
      - `descriptor` string, nullable — The billing descriptor associated with the transaction.
      - `transactionDate` string, nullable — The date of the transaction.
      - `amount` number, double, nullable — The transaction amount.
      - `currency` string, nullable — The 3-character ISO currency code (e.g., USD, EUR).
      - `bin` string, nullable — The first 6 digits of the card number (Bank Identification Number).
      - `last4` string, nullable — The last 4 digits of the card number.
      - `type` 'OI' | 'Clarity' — The type of deflection request.
    - `response` ClarityLogResponseData, required — The response from a deflection lookup.
      - `status` 'Matched' | 'Unmatched' | 'Error', required — The status of a deflection lookup.
      - `hasDeflectElements` boolean, nullable — Indicates whether the transaction has all of the required deflection elements available (e.g. IP address, customer.email, etc.). If false, deflectElementsMissing will be populated with the missing elements.
      - `deflectElementsMissing` string, nullable — Description of which deflection elements are missing, if any.
      - `chargeId` string, nullable — The matched charge ID from your system.
      - `gateway` string, nullable — The payment gateway associated with the matched transaction.
  - `total` integer, required
  - `page` integer, required
  - `per` integer, required

---

[API](https://skmtc.net/chargeblast/apis/chargeblast-api.md) · [All operations](https://skmtc.net/chargeblast/apis/chargeblast-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/chargeblast/chargeblast-api/revisions/9cc519753b33/schema)