Explore with Postman

Postman is the fastest way to explore the REST API without writing a script. Import the same OpenAPI document that powers the API Reference tab.

Prerequisites

A Seamless account with Public API access
An API key
Postman installed

Import the collection

Get the OpenAPI URL

Use the production OpenAPI spec:

https://docs.seamless.ai/openapi.json

Import into Postman

In Postman, click Import → Link, paste the OpenAPI URL, and confirm.

Set the API key

Open the collection Variables (or each request) and set:

Variable	Value
`baseUrl`	`https://api.seamless.ai/api/client/v1`
`apiKey`	Your API key from Settings → Public API

For each request, add header: Token: {{apiKey}}.

OAuth apps should use the Get an access token request, then set Authorization: Bearer {{accessToken}} on other requests instead of the Token header.

Runnable flow in Postman

Run these requests in order. Copy IDs from each response into the next request.

Search contacts

POST /search/contacts

{
  "jobTitle": ["Chief Technology Officer"],
  "companyName": ["Acme Corp"],
  "limit": 5
}

Copy data[0].searchResultId from the response.

Research contacts

POST /contacts/research

{
  "searchResultIds": ["PASTE_SEARCH_RESULT_ID"]
}

Copy requestIds[0] from the response.

Poll until done

GET /contacts/research/poll?requestIds=PASTE_REQUEST_IDSend every 3–5 seconds until data[0].status is done, error, missing, or (contacts only) duplicate.

Environment template

Create a Postman environment with these variables:

{
  "baseUrl": "https://api.seamless.ai/api/client/v1",
  "apiKey": "",
  "searchResultId": "",
  "requestId": ""
}

Use Postman’s Tests tab on the search request to auto-save IDs:

const body = pm.response.json();
if (body.data && body.data[0]) {
  pm.environment.set("searchResultId", body.data[0].searchResultId);
}

On the research request:

const body = pm.response.json();
if (body.requestIds && body.requestIds[0]) {
  pm.environment.set("requestId", body.requestIds[0]);
}

Next steps

First API request — same flow in curl, Python, and Node.js
Webhooks — replace polling with push delivery
MCP quickstart — use Seamless from Cursor or Claude without REST setup

Get Started

Core concepts

Use cases

Workflows

Guides

Troubleshooting

Explore with Postman

Prerequisites

Import the collection

Runnable flow in Postman

Environment template

Next steps

​Prerequisites

​Import the collection

​Runnable flow in Postman

​Environment template

​Next steps

Prerequisites

Import the collection

Runnable flow in Postman

Environment template

Next steps