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

# Fetch Deflection Logs

`GET /api/v3/deflections/logs`

## Request

- Base URL: `https://api.chargeblast.com`
- URL: `https://api.chargeblast.com/api/v3/deflections/logs`
- Auth: none declared. Required headers: `X-API-Key`

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.dev/chargeblast/apis/chargeblast-api-2.md) · [All operations](https://skmtc.dev/chargeblast/apis/chargeblast-api-2/llms.txt) · [OpenAPI document](https://skmtc.dev/chargeblast/apis/chargeblast-api-2/revisions/882dd27a5692?raw)