ADVBOX icon

ADVBOX

Consume Advbox API.

Actions17

Lawsuit → Get Many

AI-generated

Overview

This node operation retrieves multiple lawsuit records from the Advbox API based on various optional filters. It is useful for scenarios where you need to fetch a list of lawsuits matching specific criteria such as name, process number, customer ID, group, type, responsible person, stage, step, and supports pagination through limit and offset parameters. For example, a legal firm could use this to get all lawsuits assigned to a particular responsible person or within a certain stage for reporting or case management purposes.

Use Case Examples

  1. Fetch all lawsuits with a specific process number.
  2. Retrieve lawsuits filtered by a particular group or type.
  3. Get a paginated list of lawsuits starting from a certain offset.

Properties

Name Meaning
Name Lawsuit name or part of it, used to filter the lawsuits by name.
Process Number Process number of the lawsuit, used to filter lawsuits by their process number.
Protocol Number Protocol number of the lawsuit, used to filter lawsuits by protocol number.
Customer ID Customer ID associated with the lawsuit, used to filter lawsuits by customer.
Group Filter lawsuits by group, loaded dynamically from lawsuit groups.
Type Filter lawsuits by type, loaded dynamically from lawsuit types.
Responsible Filter lawsuits by responsible person, loaded dynamically from users.
Stage Filter lawsuits by stage, loaded dynamically from stages.
Step Filter lawsuits by step, with predefined options such as Marketing, Negotiation, Consulting, etc.
Limit Number of items in the response, between 1 and 100.
Offset Number of items to skip before starting the response (pagination).

Output

JSON

  • id - Unique identifier of the lawsuit.
  • name - Name of the lawsuit.
  • process_number - Process number associated with the lawsuit.
  • protocol_number - Protocol number associated with the lawsuit.
  • customer_id - ID of the customer related to the lawsuit.
  • group - Group classification of the lawsuit.
  • type - Type classification of the lawsuit.
  • responsible - ID of the responsible person for the lawsuit.
  • stage - Current stage of the lawsuit.
  • step - Current step of the lawsuit.
  • limit - Limit used for pagination in the response.
  • offset - Offset used for pagination in the response.

Dependencies

  • Advbox API key credential

Troubleshooting

  • Ensure the Advbox API credentials are correctly configured and have the necessary permissions to access lawsuit data.
  • Verify that the API URL is correctly set in the credentials and accessible from the n8n environment.
  • If the response is empty, check the filter parameters to ensure they match existing lawsuit records.
  • Common error messages may include authentication errors if the API key is invalid or missing, or validation errors if filter parameters are incorrectly formatted.

Discussion