Skip to main content

ContactSearchArguments

Search criteria for finding contacts with advanced filtering, pagination, and sorting capabilities. Supports filtering by personal information, contact details, dates, and business relationships.

Validation Rules:

  • Maximum 100 items per page for performance
  • Contact IDs must be unique within the array
  • Email addresses must be valid format
  • Date ranges must be in ISO 8601 format
  • Source searches require both source name and source ID
input ContactSearchArguments {
contactIds: [Int!]
firstName: String
middleName: String
lastName: String
email: String
gender: Gender
debtorIds: [String!]
page: Int!
offset: Int!
sort: [ContactSortInput!]
lastModifiedAt: DateSearchInput
createdAt: DateSearchInput
sources: [SourceSearchInput!]
}

Fields

ContactSearchArguments.contactIds ● [Int!] list scalar

Array of internal contact IDs for direct lookup and bulk operations. Maximum 50 IDs per request for performance optimization.

ContactSearchArguments.firstName ● String scalar

Contact's first name for personal identification and communication. Maximum length: 30 characters.

ContactSearchArguments.middleName ● String scalar

Contact's middle name or initial for complete personal identification. Maximum length: 20 characters.

ContactSearchArguments.lastName ● String scalar

Contact's last name for personal identification and formal communication. Maximum length: 50 characters.

ContactSearchArguments.email ● String scalar

Primary email address for business communication and notifications. Must be a valid email format.

ContactSearchArguments.gender ● Gender enum

Contact gender

ContactSearchArguments.debtorIds ● [String!] list scalar

List of debtor IDs to search for

ContactSearchArguments.page ● Int! non-null scalar

Page number for pagination (default: 1)

ContactSearchArguments.offset ● Int! non-null scalar

Number of items per page (default: 12, max: 100)

ContactSearchArguments.sort ● [ContactSortInput!] list input

Array of sorting criteria for organizing search results by various attributes

ContactSearchArguments.lastModifiedAt ● DateSearchInput input

Date range filter for entities modified within a specific time period

ContactSearchArguments.createdAt ● DateSearchInput input

Date range filter for entities created within a specific time period

ContactSearchArguments.sources ● [SourceSearchInput!] list input

Member Of

contacts query