v1

latestOpenAPI 3.0.0Proprietary2026-07-26130282259.8 KB
contacts

Search Contacts

Use this endpoint to get a list of contacts matching the given search criteria. Contacts are returned if they include a given first name, last name, company name, and contact type. it will filter by range of dates, using the CreationDate of the contact. The size of the return is controlled with the pageSize query parameter which defaults to 25 and must be > 0 and <= 25. Set pageIndex > 0 to access contacts past the first page when more than pageSize contacts meet the search criteria. Sort criteria, startDate and endDate are required. The search returns includes like phone numbers, email addresses and location address.

post/contacts/search

Query parameters

pageSizeinteger

Controls how many items are returned per page in paginated responses.

  • Default: 25 items per page if not specified
  • Minimum: 1 item per page
  • Use with pageStartIndex for navigating through large result sets
pageStartIndexinteger

The index of the page to return

Request body

contactTypesstring[]
searchTermstring

It could be the first name, last name, company name of the contact.

startDatestring date-time required

An ISO 8601 string of the startDate to search. It will search by CreationDate. https://en.wikipedia.org/wiki/ISO_8601

endDatestring date-time required

An ISO 8601 string of the endDate to search It will search by CreationDate. https://en.wikipedia.org/wiki/ISO_8601

Example request

{
  "contactTypes": [
    "Customer"
  ],
  "searchTerm": "John Smith",
  "startDate": "2023-01-01T00:00:00Z",
  "endDate": "2023-06-30T23:59:59Z"
}

Response

OK

countinteger

The total number of items available across all pages. Use this to calculate the total number of pages available.

pageSizeinteger

The number of items per page in this response. This reflects either your requested page size or the default value.

pageStartIndexinteger

The starting index of this page of results. Use with pageSize to track your position in the overall result set.