---
title: "Get fraud alerts"
method: GET
path: "/fraud-alert"
tags: ["Fraud Alerts"]
---

# Get fraud alerts

`GET /fraud-alert`

Retrieve fraud alerts with optional filtering by status and charge ID. Supports pagination.

## Query parameters

- `status` 'PENDING' | 'CONFIRMED' | 'DECLINED' — Filter by fraud alert status
- `transactionId` string — Filter by transaction ID
- `page` number, float — The page number to retrieve in a paginated response
- `limit` number, float — A limit on the number of objects to be returned
- `fromDate` string, date-time — Filter fraud alerts created from this date (inclusive)
- `toDate` string, date-time — Filter fraud alerts created up to this date (inclusive)

## Headers

- `Accept-Version` string, required — Specifies the API version to use for this request.

## Response `200`

Fraud alerts retrieved successfully

- object
  - `items` object[]
    - `fraudAlertId` string, uuid, required — Unique identifier for the fraud alert
    - `transactionId` string, required — Associated transaction ID
    - `status` 'PENDING' | 'CONFIRMED' | 'DECLINED', required — Current status of the fraud alert
    - `cardId` string, uuid, required — Associated card ID
    - `merchantInfo` object, required — Information about the merchant involved in the transaction
      - `name` string — Name of the merchant
      - `location` string — Location of the merchant
    - `transactionInfo` object, required — Details about the transaction
      - `amount` string, required — Transaction amount
      - `currency` string, required — Transaction currency
      - `timestamp` string, date-time, required — Transaction timestamp
  - `meta` object — Pagination metadata for the response.
    - `itemCount` number, float, required — The number of items returned on the current page.
    - `totalItems` number, float, required — The total number of items across all pages.
    - `itemsPerPage` number, float, required — The maximum number of items that can be returned per page.
    - `totalPages` number, float, required — The total number of pages available based on the **itemsPerPage** and **totalItems**.
    - `currentPage` number, float, required — The current page number in the paginated response.

---

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