list-alerts

list-alerts

curl --request GET \
  --url https://api.trusto.one/api/v1/alerts \
  --header 'X-API-KEY: <api-key>'

const options = {method: 'GET', headers: {'X-API-KEY': '<api-key>'}};

fetch('https://api.trusto.one/api/v1/alerts', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "data": [{
    "id": "3114afe2-9996-48c9-88cb-3c9fc6a88414",
    "providerId": "5F2RE3960S9ASDC2F026BF16",
    "provider": "ETHOCA",
    "type": "ETHOCA_CONFIRMED_FRAUD",
    "alertTimeStamp": "2024-12-12T12:00:00.000Z",
    "transactionTimeStamp": "2024-12-11T10:30:00.000Z",
    "merchantDescriptor": "MERCHANT STORE 1",
    "amount": 100.12,
    "currency": "AED",
    "status": "OPEN",
    "expiredAt": null,
    "hasExternalTransaction": false,
    "outcome": null,
    "hoursLeft": 18
  }],
  "total": 1,
  "totalPages": 1,
  "page": 0,
  "size": 10
}

GET

api

alerts

list-alerts

curl --request GET \
  --url https://api.trusto.one/api/v1/alerts \
  --header 'X-API-KEY: <api-key>'

const options = {method: 'GET', headers: {'X-API-KEY': '<api-key>'}};

fetch('https://api.trusto.one/api/v1/alerts', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "data": [{
    "id": "3114afe2-9996-48c9-88cb-3c9fc6a88414",
    "providerId": "5F2RE3960S9ASDC2F026BF16",
    "provider": "ETHOCA",
    "type": "ETHOCA_CONFIRMED_FRAUD",
    "alertTimeStamp": "2024-12-12T12:00:00.000Z",
    "transactionTimeStamp": "2024-12-11T10:30:00.000Z",
    "merchantDescriptor": "MERCHANT STORE 1",
    "amount": 100.12,
    "currency": "AED",
    "status": "OPEN",
    "expiredAt": null,
    "hasExternalTransaction": false,
    "outcome": null,
    "hoursLeft": 18
  }],
  "total": 1,
  "totalPages": 1,
  "page": 0,
  "size": 10
}

Retrieve a paginated collection of alerts available to the organization associated with your API key. The sandbox environment is selected by default; use the server selector to switch environments. Array-valued filters accept comma-separated values.

integer

default:"0"

Zero-based page number.

integer

default:"10"

Number of alerts per page.

string

Search provider ID, merchant descriptor, card BIN, or card last four.

string

Minimum alert date in YYYY-MM-DD format.

string

Maximum alert date in YYYY-MM-DD format.

string

Minimum transaction date in YYYY-MM-DD format.

string

Maximum transaction date in YYYY-MM-DD format.

string

Comma-separated providers: ETHOCA, VERIFI, or CDRN.

string

Comma-separated statuses: OPEN, RESOLVED, REFUNDED, CHARGEBACK, EXPIRED, or INVALID.

boolean

Filter by whether the alert has expired.

integer

Return unresolved alerts expiring within this many hours.

string

Comma-separated stored outcome values.

string

Filter by merchant descriptor prefix.

string

Filter by an exact alert type.

string

Comma-separated company UUIDs.

string

Alert property used for sorting.

string

default:"ASC"

Sort direction: ASC or DESC.

Alert[]

required

Alerts for the current page, including outcome and hoursLeft.

integer

required

Total matching alerts.

integer

required

Total pages.

integer

required

Current zero-based page.

integer

required

Requested page size.

{
  "data": [{
    "id": "3114afe2-9996-48c9-88cb-3c9fc6a88414",
    "providerId": "5F2RE3960S9ASDC2F026BF16",
    "provider": "ETHOCA",
    "type": "ETHOCA_CONFIRMED_FRAUD",
    "alertTimeStamp": "2024-12-12T12:00:00.000Z",
    "transactionTimeStamp": "2024-12-11T10:30:00.000Z",
    "merchantDescriptor": "MERCHANT STORE 1",
    "amount": 100.12,
    "currency": "AED",
    "status": "OPEN",
    "expiredAt": null,
    "hasExternalTransaction": false,
    "outcome": null,
    "hoursLeft": 18
  }],
  "total": 1,
  "totalPages": 1,
  "page": 0,
  "size": 10
}

Resolve an alert

Submit a resolution for an unresolved alert.

API Reference

Sandbox

Resolve an alert