Timezone → Contacts

POST /search/contacts · Credits charged per results returned · v1, v2 · Part of the Contact Search API

Introduction

Find contacts in the timezones your reps cover, so calls land during business hours. Combine it with any other filter in the same request (AND logic).

AI agent prompt

Read https://docs.seamless.ai/api-catalog/contact-filters/timezone. Using SEAMLESS_API_KEY, call POST https://api.seamless.ai/api/client/v1/search/contacts with the `timezones` filter to find contacts matching: <your target>. Page with nextToken and keep each searchResultId.

Example

curl -X POST https://api.seamless.ai/api/client/v1/search/contacts \
  -H "Token: $SEAMLESS_API_KEY" -H "Content-Type: application/json" \
  -d '{"timezones": ["Eastern (EST)", "Central (CST)"], "limit": 25}'

import os, requests
rows = requests.post("https://api.seamless.ai/api/client/v1/search/contacts",
    headers={"Token": os.environ["SEAMLESS_API_KEY"]},
    json={"timezones": ["Eastern (EST)", "Central (CST)"], "limit": 25}).json()["data"]

Reference

Parameter	Type	Required	Description
`timezones`	string[]	Yes	Filter by timezone. Up to 10 timezones can be specified. Behavior depends on the `timezoneType` parameter.
`timezoneType`	string	No	Determines how the `timezones` filter is applied, using the same semantics as `locationType`. Ignored unless `timezones` is provided. Default `"bothOR"`.
`limit`	integer	No	Results per page, up to 500. Default `50`.
`nextToken`	string	No	Cursor from `supplementalData.nextToken` to fetch the next page.

All 30 allowed values for timezones

Eastern (EST), Central (CST), Mountain (MST), Pacific (PST), Alaska (AKST), Hawaii (HST), New Zealand (NST), Solomon (SST), Australia Eastern (AET), Australia Central (ACT), Japan (JST), China Taiwan (CTT), Vietnam (VST), Bangladesh (BST), India (IST), Indiana Eastern (IET), Pakistan Lahore (PLT), Near East (NET), Middle East (MET), Eastern African (EAT), (Arabic) Egypt (ART), Eastern European (EET), European Central (ECT), Greenwich Mean (GMT), Central African (CAT), Argentina (AGT), Brazil Eastern (BET), Canada Newfoundland (CNT), Puerto Rico and US Virgin Islands (PRT), Midway Islands (MIT)

Allowed values for timezoneType: bothOR, bothAND, company, contact

Response

Rows are contact previews with searchResultId, name, title, seniority, company, location, and LinkedIn URL, but no emails or phones. Send searchResultId to Contact Research to get them. Fields: Contact Search. Auth: Token header (API keys) · Errors: status codes · Billing: rate limits and credits

Catalog

Identity resolution

Search

Contact Search filters

Company Search filters

Research

My data

Platform

Coming soon

Timezone → Contacts

Introduction

AI agent prompt

Example

Reference

Response

​Introduction

​AI agent prompt

​Example

​Reference

​Response

Introduction

AI agent prompt

Example

Reference

Response