Email Search

post

https://api.marketcircle.net/v1/emails/_search

Search for emails

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

See the search filtering documentation for details about the query syntax. The searchable attributes and the operators each one accepts are listed in the request body below.

Email-specific notes

This searches email attributes such as subject and date. To search the text of email bodies, use Email Body Search.
Linked records (appointments, contacts, companies, opportunities, projects, tasks, groups, notes, forms) take a search filter for that record type with any, using the linked record's reference:
{ "contacts": { "any": { "contact": { "equal": "/v1/contacts/1000" } } } }
category matches by name, e.g. { "category": { "equal": "Client" } }.
email_message and email_id match the email itself, by reference or by numeric ID.

Query Params

limit

int32

≤ 250

Defaults to 50

Maximum number of results per page (max 250). Defaults to 50, or 10 when full-records is true.

full-records

boolean

Return every attribute of each result instead of the short list form.

start

int32

Return results whose ID is greater than or equal to this value. Use the next URL from the previous page rather than building this yourself.

Body Params

subject

object

Example: Re: Proposal

message_id

object

The Message-ID header

date

object

When the email was sent

category

object

Category name, e.g. Client

keywords

object

Keyword names, e.g. {"any": ["Proposal"]}

appointments

object

Records linked to appointments. The operand is a search filter on appointments, for example {"any": {"appointment": {"equal": "/v1/appointments/1000"}}}.

contacts

object

Records linked to contacts. The operand is a search filter on contacts, for example {"any": {"contact": {"equal": "/v1/contacts/1000"}}}.

companies

object

Records linked to companies. The operand is a search filter on companies, for example {"any": {"company": {"equal": "/v1/companies/1000"}}}.

opportunities

object

Records linked to opportunities. The operand is a search filter on opportunities, for example {"any": {"opportunity": {"equal": "/v1/opportunities/1000"}}}.

projects

object

Records linked to projects. The operand is a search filter on projects, for example {"any": {"project": {"equal": "/v1/projects/1000"}}}.

tasks

object

Records linked to tasks. The operand is a search filter on tasks, for example {"any": {"task": {"equal": "/v1/tasks/1000"}}}.

groups

object

Records linked to groups. The operand is a search filter on groups, for example {"any": {"group": {"equal": "/v1/groups/1000"}}}.

notes

object

Records linked to notes. The operand is a search filter on notes, for example {"any": {"note": {"equal": "/v1/notes/1000"}}}.

forms

object

Records linked to forms. The operand is a search filter on forms, for example {"any": {"form": {"equal": "/v1/forms/1000"}}}.

email_message

object

The email itself, by reference, e.g. /v1/emails/1000

email_id

object

The email's numeric ID

owner

object

Owner reference, e.g. /v1/users/1000

creator

object

Creator reference, e.g. /v1/users/1000

create_date

object

Example: {"greater_than": "2025-03-04T17:45:57Z"}

modify_date

object

Example: {"greater_than": "2025-03-04T17:45:57Z"}

Responses

Email-specific notes

200200 OK

400400 Bad Request