JUjustt
Pre-chargeback Alerts

Get alerts by search criteria

Retrieving an array of pre-chargeback alerts matching the given criteria. In addition to this endpoint, we also support push notifications that share alerts with you in real-time. Contact your account manager to set up for immediate alert notifications.

get/pre-chargeback-alerts/alerts

Request

  • Base URL
    https://api.justt.ai/v1
  • URL
    https://api.justt.ai/v1/pre-chargeback-alerts/alerts
  • Auth
    HTTP bearer

Query parameters

limitnumber

The number of items to return between 10 to 100

pagenumber

The offset of the first item to return

alertStartDatestring date-time

Alert creation start date. for date range filtering (ISO 8601 in UTC)

alertEndDatestring date-time

Alert creation end date. for date range filtering (ISO 8601 in UTC)

startDatestring date-time

Start date for filtering alerts by creation date in Justt systems (ISO 8601 in UTC)

endDatestring date-time

End date for filtering alerts by creation date in Justt systems (ISO 8601 in UTC)

providerAlertIdstring

A unique alert Identifier set by the provider

alertType'customerdispute_alert' | 'issuer_alert'

The type of the alert

provider'ethoca' | 'verifi'

The name of the provider that generated the alert

transactionIdstring

The transaction ID associated with the alert

Headers

reference-account-idstring

If your account encompasses multiple merchants, you should use this header to specify the account you are working on (https://developers.justt.ai/docs/reference-accounts)

Response

Returns the alerts data

status100 | 101 | 102 | 103 | 200 | 201 | 202 | 203 | 204 | 205 | 206 | 300 | 301 | 302 | 303 | 304 | 307 | 308 | 400 | 401 | 402 | 403 | 404 | 405 | 406 | 407 | 408 | 409 | 410 | 411 | 412 | 413 | 414 | 415 | 416 | 417 | 418 | 421 | 422 | 424 | 428 | 429 | 500 | 501 | 502 | 503 | 504 | 505 required

The status of the response

messagestring required

The message of the response

hasMoreboolean required

An indicator if there are more items to return

Example response

{
  "status": 200,
  "message": "success",
  "hasMore": true,
  "data": [
    {
      "internalAlertId": "04318fb0-e4ff-4712-972e-4db99b3fb23c",
      "merchantUuid": "123e4567-e89b-12d3-a456-426614174111",
      "merchantName": "Example Merchant",
      "arn": "Example ARN",
      "authorizationCode": "Example Authorization Code",
      "merchantOrderID": "Example Merchant Order Id",
      "provider": "ethoca",
      "providerAlertId": "123e4567-e89b-12d3-a456-426614174000",
      "alertTimestamp": "2023-09-15T14:22:31Z",
      "transaction": {
        "id": "TX8901234567",
        "timestamp": "2023-09-10T09:15:00Z",
        "amount": 149.99,
        "currency": "USD",
        "card": {
          "last4": "1234",
          "bin": "411111"
        }
      },
      "alertType": "customerdispute_alert",
      "metadata": {
        "reason": "Cardholder does not recognize the transaction",
        "issuerName": "Example Bank",
        "responseDeadline": "2023-09-17T23:59:59Z"
      }
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.