--- title: "List Contact . emails" method: GET path: "/Contact/{id}/emails" tags: ["Contact"] --- # List Contact . emails `GET /Contact/{id}/emails` List 'Email' records related through the 'emails' link. ## Query parameters - `offset` integer - `maxSize` integer - `orderBy` string - `order` 'asc' | 'desc' - `textFilter` string - `attributeSelect` string[] - `whereGroup` WhereItem[] - `type` 'and' | 'or' | 'not' | 'subQueryNotIn' | 'subQueryIn' | 'expression' | 'in' | 'notIn' | 'equals' | 'notEquals' | 'on' | 'notOn' | 'like' | 'notLike' | 'startsWith' | 'endsWith' | 'contains' | 'notContains' | 'greaterThan' | 'lessThan' | 'greaterThanOrEquals' | 'lessThanOrEquals' | 'after' | 'before' | 'between' | 'ever' | 'any' | 'none' | 'isNull' | 'isNotNull' | 'isTrue' | 'isFalse' | 'today' | 'past' | 'future' | 'lastSevenDays' | 'lastXDays' | 'nextXDays' | 'olderThanXDays' | 'afterXDays' | 'currentMonth' | 'nextMonth' | 'lastMonth' | 'currentQuarter' | 'lastQuarter' | 'currentYear' | 'lastYear' | 'currentFiscalYear' | 'lastFiscalYear' | 'currentFiscalQuarter' | 'lastFiscalQuarter' | 'arrayAnyOf' | 'arrayNoneOf' | 'arrayAllOf' | 'arrayIsEmpty' | 'arrayIsNotEmpty' | 'linkedWith' | 'notLinkedWith' | 'linkedWithAll' | 'isLinked' | 'isNotLinked', required — An operator. - `attribute` string — An attribute or field. - `value` union — A value. A scalar, or an array of strings. - WhereItem[] - string[] - `dateTime` boolean — Set true for date-time fields. - `timeZone` string — A time zone. For date-time fields. ## Response `200` Success. - object - `list` Email[] — Records. - `id` string — An ID. - `name` string — A one-line string. - `subject` string — A one-line string. - `fromName` string, nullable — A one-line string. - `fromAddress` string, nullable — A one-line string. - `fromString` string, nullable — A one-line string. - `replyToString` string, nullable — A one-line string. - `replyToName` string, nullable — A one-line string. - `replyToAddress` string, nullable — A one-line string. - `from` string — A one-line string. - `to` string — A one-line string. - `cc` string, nullable — A one-line string. - `bcc` string, nullable — A one-line string. - `replyTo` string, nullable — A one-line string. - `personStringData` string, nullable — A one-line string. - `isRead` boolean - `isNotRead` boolean - `isReplied` boolean - `isNotReplied` boolean - `isImportant` boolean - `inTrash` boolean - `inArchive` boolean - `folderId` string, nullable - `isUsers` boolean - `folderName` string, nullable — A foreign record name. - `folderStringId` string, nullable - `folderStringName` string, nullable — A foreign record name. - `messageId` string, nullable — A one-line string. - `messageIdInternal` string, nullable — A one-line string. - `emailAddress` string, nullable — A one-line string. - `fromEmailAddressId` string, nullable — An ID of the record of the EmailAddress type. - `fromEmailAddressName` string, nullable — A foreign record name. - `toEmailAddressesIds` string[], nullable — IDs of records of the EmailAddress type. - `toEmailAddressesNames` object, nullable — An {ID => record name} map. - `ccEmailAddressesIds` string[], nullable — IDs of records of the EmailAddress type. - `ccEmailAddressesNames` object, nullable — An {ID => record name} map. - `bccEmailAddressesIds` string[], nullable — IDs of records of the EmailAddress type. - `bccEmailAddressesNames` object, nullable — An {ID => record name} map. - `replyToEmailAddressesIds` string[], nullable — IDs of records of the EmailAddress type. - `replyToEmailAddressesNames` object, nullable — An {ID => record name} map. - `bodyPlain` string, nullable — A multi-line text. - `body` string, nullable — A multi-line text. - `isHtml` boolean - `status` 'Draft' | 'Sending' | 'Sent' | 'Archived' | 'Failed' - `hasAttachment` boolean - `parentId` string, nullable — A foreign record ID. - `parentType` 'Account' | 'Lead' | 'Contact' | 'Opportunity' | 'Case' | 'CCompany', nullable — An entity type. - `parentName` string, nullable — A foreign record name. - `dateSent` string, nullable — A timestamp in UTC. - `deliveryDate` string, nullable — A timestamp in UTC. - `sendAt` string, nullable — A timestamp in UTC. - `isAutoReply` boolean - `createdAt` string, nullable — A timestamp in UTC. - `modifiedAt` string, nullable — A timestamp in UTC. - `createdById` string, nullable — An ID of the record of the User type. - `createdByName` string, nullable — A foreign record name. - `sentById` string, nullable — An ID of the record of the User type. - `sentByName` string, nullable — A foreign record name. - `modifiedById` string, nullable — An ID of the record of the User type. - `modifiedByName` string, nullable — A foreign record name. - `assignedUserId` string, nullable — An ID of the record of the User type. - `assignedUserName` string, nullable — A foreign record name. - `repliedId` string, nullable — An ID of the record of the Email type. - `repliedName` string, nullable — A foreign record name. - `repliesIds` string[], nullable — IDs of records of the Email type. - `repliesNames` object, nullable — An {ID => record name} map. - `repliesColumns` object, nullable — An {ID => object} map. Relationship column values. - `isSystem` boolean - `teamsIds` string[], nullable — IDs of records of the Team type. - `teamsNames` object, nullable — An {ID => record name} map. - `usersIds` string[], nullable — IDs of records of the User type. - `usersNames` object, nullable — An {ID => record name} map. - `usersColumns` object, nullable — An {ID => object} map. Relationship column values. - `assignedUsersIds` string[], nullable — IDs of records of the User type. - `assignedUsersNames` object, nullable — An {ID => record name} map. - `inboundEmailsIds` string[], nullable — IDs of records of the InboundEmail type. - `inboundEmailsNames` object, nullable — An {ID => record name} map. - `emailAccountsIds` string[], nullable — IDs of records of the EmailAccount type. - `emailAccountsNames` object, nullable — An {ID => record name} map. - `icsContents` string, nullable — A multi-line text. - `icsEventUid` string, nullable — A one-line string. - `icsEventDateStart` string, nullable — Specified if the 'icsEventDateStart' field is all-day. - `icsEventDateStartDate` string, date, nullable - `createdEventId` string, nullable — A foreign record ID. - `createdEventType` string, nullable — An entity type. - `createdEventName` string, nullable — A foreign record name. - `groupFolderId` string, nullable — An ID of the record of the GroupEmailFolder type. - `groupFolderName` string, nullable — A foreign record name. - `groupStatusFolder` 'Archive' | 'Trash', nullable - `accountId` string, nullable — An ID of the record of the Account type. - `accountName` string, nullable — A foreign record name. - `tasksIds` string[], nullable — IDs of records of the Task type. - `tasksNames` object, nullable — An {ID => record name} map. - `tasksColumns` object, nullable — An {ID => object} map. Relationship column values. - `total` number — The total number of records. If the total number is disabled, special values are returned: -1 – there are more records to paginate, -2 – there are no more records. ## Other responses - `400` — Bad request. Check logs for details. - `403` — Forbidden. Might be an access control error. Check logs for details. --- [API](https://skmtc.net/espocrm/apis/espocrm-api.md) · [All operations](https://skmtc.net/espocrm/apis/espocrm-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/espocrm/espocrm-api/versions/6622dabfccd3/schema)