SOCRadar icon

SOCRadar

Comprehensive SOCRadar API integration
Join our community

Actions21

Overview

This node integrates with the SOCRadar API to retrieve fraud protection data related to a specified company. It is designed to fetch detailed fraud-related information such as alarms, notifications, and record statuses for a company identified by its ID. This node is useful in scenarios where organizations want to monitor and analyze potential fraudulent activities associated with their business entities.

Practical examples include:

  • Fetching fraud alerts and alarm details for a company to assess risk.
  • Filtering fraud records by status, country code, or CVV to focus on specific cases.
  • Including historical fraud data to analyze trends over time.
  • Paginating results when dealing with large datasets of fraud records.

Properties

Name Meaning
Company ID The unique identifier of the company for which fraud protection data is requested.
Additional Fields Optional filters and parameters to refine the fraud protection query:
- Search String Text string to filter fraud records by matching content.
- Record Status Filter results based on the status of the fraud record (e.g., active, resolved).
- Record Status Reason Filter by the reason associated with the record's status.
- Alarm Status Filter fraud alarms by their current status.
- CVV Filter records by Card Verification Value (CVV) used in transactions.
- Country Code Filter fraud records by the country code associated with the transaction or entity.
- Expired Boolean flag to filter records that are expired or not.
- Alarm ID Filter by a specific alarm identifier.
- Notification ID Filter by a specific notification identifier.
- Include History Boolean flag indicating whether to include historical fraud data in the response.
- Start Date Start date to filter records from a specific point in time.
- End Date End date to filter records up to a specific point in time.
- Page Page number for paginated results.
- Limit Number of results to return per page.
- Order Direction Direction to order the results, typically ascending or descending.

Output

The node outputs JSON data containing the fraud protection information retrieved from the SOCRadar API. The structure includes details about fraud alarms, notifications, record statuses, and optionally historical data depending on the input parameters.

If binary data were involved (not indicated here), it would represent files or attachments related to fraud cases, but this node focuses on JSON structured data.

Dependencies

  • Requires an API key credential for authenticating requests to the SOCRadar API.
  • Needs network access to the SOCRadar service endpoint.
  • The node expects configuration of the API base URL and API key through n8n credentials.

Troubleshooting

  • Common issues:

    • Invalid or missing API key will cause authentication failures.
    • Incorrect company ID may result in empty or error responses.
    • Using unsupported filter values can lead to no results or API errors.
    • Pagination parameters out of range might cause unexpected results.

  • Error messages:

    • Errors returned from the API are captured and included in the output under an error field with additional details if available.
    • Common error messages include authentication errors, invalid parameter errors, or rate limiting notices.

  • Resolution tips:

    • Verify the API key and ensure it has proper permissions.
    • Double-check the company ID and filter parameters for correctness.
    • Use pagination parameters within valid ranges.
    • Enable "Continue On Fail" option in the node settings to handle errors gracefully without stopping workflow execution.

Links and References

Discussion