# Pipedrive (API v2) - Search records by query action
The Search records by query action searches Pipedrive and returns a list of records that match the criteria you specify.
# Input
Input field | Description |
---|---|
Object | Specify the type of object to retrieve from Pipedrive. |
Term | Enter a search term to query by. |
Fields to search | Select in which fields to compare the search Term and Pipedrive records. |
Exact match | Select whether to search for exact or partial matches. |
Limit | Enter the maximum number of records to return. |
Cursor | Provide the next_cursor value to retrieve the next page of results. Defaults to the first page if left blank. |
# Output
The Search records by query action's output fields vary based on your selected Object type. The following output table uses an Organization object as an example:
Output field | Description |
---|---|
Data | Contains information about the current state of the organization. |
Items | Contains records from Pipedrive that match the search criteria. |
Result score | Indicates whether the search was successful. |
Item | The organization returned by the search. |
ID | A unique identifier for the organization. |
Name | Name of the organization |
Type | Type of organization |
Address | The address of the organization. |
Visible to | The visibility rules set for this organization. |
Owner | Contains information about the owner of the organization. |
Custom fields | Contains additional information about the returned records. |
Notes | Notes from the returned organization. |
Next cursor | Cursor to use for pagination to fetch the next page. |
VARIABLE OUTPUT
The Search records by query action's output fields vary based on your selected Object type.
Last updated: 5/7/2025, 7:57:00 PM