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!]
  term: String
  termFields: [ContactTermField!]
  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.term` ● `String` scalar

Free-text search term matched as a case-insensitive substring across the contact's own fields. The id field matches by exact id (numeric terms only). Restrict the searched fields with termFields. Multi-word terms must all match (AND). Each token must be at least 3 characters, or a numeric id.

`ContactSearchArguments.termFields` ● `[ContactTermField!]` list enum

Fields the term searches. Text fields match by case-insensitive substring; the ID field matches by exact id (numeric terms only). When omitted, contact text fields are searched.