Skip to main content
Aria Knowledge Central

get_cc_velocity_info_m Sample Call and Response

This example shows a client retrieving velocity information for a credit card number, based on the get_cc_velocity_info_m method defined in plsql_m_r73.yml. The method returns collection attempts, authorizations, and primary or backup payment method changes associated with that card, which supports fraud and risk analysis across the accounts that use the card.

The example scopes the search to a specific date range using start_date and end_date. It does not cover an open-ended search that omits both dates, which would return velocity data across the full history of the card.

Sample call

{
  "rest_call": "get_cc_velocity_info_m",
  "output_format": "json",
  "client_no": 4009,
  "auth_key": "a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6",
  "cc_num": "4111111111111111",
  "start_date": "2026-06-01",
  "end_date": "2026-07-24"
}

The cc_num field is required and carries masked logging, so Aria does not write the raw digits to call logs even though the caller supplies the full card number here. The start_date and end_date fields are optional and, in this example, narrow the search to actions that occurred on or after June 1, 2026, and on or before July 24, 2026, both dates inclusive, in the required yyyy-mm-dd format. The rest_call and output_format fields are added by the REST layer.

Sample response

{
  "error_code": 0,
  "error_msg": "",
  "velocity_data": [
    {
      "acct_no": 3300145,
      "action": "Authorization",
      "date": "2026-06-04 09:12:33"
    },
    {
      "acct_no": 3300145,
      "action": "Collection",
      "date": "2026-06-05 02:00:11"
    },
    {
      "acct_no": 3312890,
      "action": "Added to account",
      "date": "2026-07-02 15:47:56"
    }
  ]
}

An error_code value of zero together with an empty error_msg indicates that Aria found and returned the card's velocity data successfully. The velocity_data field is an array because a single card number can be associated with activity across more than one account; this example shows three representative entries, but a card with heavier use over the requested date range would return many more. The action field is one of five allowable values: Collection, Authorization, Added as primary and Added as backup (both Aria6 only), and Added to account (Aria Crescendo only); this example shows Authorization, Collection, and Added to account, the value that applies when the card is newly saved to an account in the current platform. This example omits the error_details field.

TOP
  • Was this article helpful?