Skip to main content
GET
/
api
/
v1
/
alerts
Get all alerts
curl --request GET \
  --url https://api.trusto.one/api/v1/alerts \
  --header 'Authorization: Bearer <token>'
{
  "total": 100,
  "totalPages": 10,
  "page": 0,
  "size": 10,
  "data": [
    {
      "id": "3114afe2-9996-48c9-88cb-3c9fc6a88414",
      "providerId": "5F2RE3960S9ASDC2F026BF16",
      "provider": "ETHOCA",
      "type": "ETHOCA_CONFIRMED_FRAUD",
      "alertTimeStamp": "2024-12-12T12:00:00Z",
      "enrollmentId": "3114afe2-9996-48c9-88cb-3c9fc6a88414",
      "companyId": "ab14afe2-9996-48c9-88cb-3c9fc6a88414",
      "issuer": "HSBC",
      "cardBin": "483442",
      "cardLastFour": "1234",
      "cardExpirationDate": "12/25",
      "acquirerBin": "48344223",
      "status": "OPEN",
      "ruleType": "amount",
      "ruleName": "Above 10 AED",
      "installmentNumber": "1",
      "pricingTier": "Tier 2",
      "transactionTimeStamp": "2024-12-12T12:00:00Z",
      "merchantDescriptor": "MERCHANT STORE 1",
      "descriptorContact": "John Doe / 971582212233",
      "ethocaMergantId": "123456",
      "merchantId": "MERCHANTSTORE123",
      "merchantOrderId": "ORDER123",
      "merchantName": "Ecommerce Merchant LLC",
      "partnerId": "ABC123456",
      "partnerName": "Partner Merchant LLC",
      "clientName": "John Doe",
      "caid": "12345678",
      "mcc": "3901",
      "amount": 100.12,
      "currency": "AED",
      "transactionType": "eCommerce",
      "initiatedBy": "cardholder",
      "authCode": "123456",
      "source": "Portal",
      "reasonCode": "UAU123",
      "acquirerReferenceNumber": "123456",
      "transactionId": "TRANS123456789",
      "chargebackAmount": 100.12,
      "chargebackCurrency": "AED",
      "paymentType": "Credit Card",
      "createdAt": "2024-12-12T12:00:00Z",
      "updatedAt": "2024-12-12T12:00:00Z"
    }
  ]
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

​
outcome
enum<string>
required

Outcome of the transaction

Available options:
STOPPED,
PARTIALLY_STOPPED,
PREVIOUSLY_CANCELLED,
MISSED,
ACCOUNT_SUSPENDED,
IN_PROGRESS,
SHIPPER_CONTACTED,
OTHER,
RESOLVED,
PREVIOUSLY_REFUNDED,
UNRESOLVED_DISPUTE,
NOT_FOUND
​
expiresIn
number
required

Time to expiration in hours (1-24) - equal or less than

Example:

12

​
expired
boolean
required

Whether the alert is expired (true or false)

Example:

true

​
status
enum<string>
required

Alert status

Available options:
NEW,
OPEN,
RESOLVED,
REFUNDED,
PROCESSING,
NOT_FOUND,
CHARGEBACK,
OTHER,
EXPIRED
​
provider
enum<string>
required

Alert provider

Available options:
ETHOCA,
VERIFI
​
transactionEndDate
string
required

Transaction end date in YYYY-MM-DD format

Example:

"2024-01-31"

​
transactionStartDate
string
required

Transaction start date in YYYY-MM-DD format

Example:

"2024-01-01"

​
endDate
string
required

End date in YYYY-MM-DD format

Example:

"2024-01-31"

​
startDate
string
required

Start date in YYYY-MM-DD format

Example:

"2024-01-01"

​
size
number
required

Number of items per page

Example:

10

​
page
number
required

Page number

Example:

1

Response

​
total
number
required

The total number of items available

Example:

100

​
totalPages
number
required

The total number of pages available

Example:

10

​
page
number
required

The current page

Example:

0

​
size
number
required

The number of items per page

Example:

10

​
data
object[]