> ## Documentation Index
> Fetch the complete documentation index at: https://docs.seamless.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# My Company Data API

> Export every company your organization has researched, for CRM and warehouse sync, and manage their list membership. Free.

> [!NOTE]
>
> **Endpoints** `GET /companies` · `POST /companies` (v2) · **Credits** free · **Versions** v1, v2

## Introduction

Every company your organization researches is saved to your org. The My Company Data API reads those records back, with firmographics, phones, technologies, and funding, without spending credits. Use it to keep CRM accounts and warehouse tables in sync, and to manage which lists each company belongs to.

## AI agent prompt

```text theme={null}
Read https://docs.seamless.ai/api-catalog/my-company-data. Using SEAMLESS_API_KEY, call
GET https://api.seamless.ai/api/client/v1/companies with startDate/endDate for the last 24 hours,
page through every result, and upsert each company into my CRM keyed on domain.
```

## Authentication

Send your API key in the `Token` header, or `Authorization: Bearer <token>` with [OAuth](/authentication/oauth). Create a key under [Settings → Public API](/authentication/api-keys).

## Example

```bash Export (incremental) theme={null}
curl "https://api.seamless.ai/api/client/v1/companies?startDate=2026-10-19T00:00:00Z&endDate=2026-10-20T00:00:00Z&page=1&limit=100" \
  -H "Token: $SEAMLESS_API_KEY"
```

```python Python theme={null}
import os, requests

H = {"Token": os.environ["SEAMLESS_API_KEY"]}
page = 1
while True:
    rows = requests.get("https://api.seamless.ai/api/client/v1/companies", headers=H,
                        params={"page": page, "limit": 100}).json()["data"]
    if not rows:
        break
    for co in rows:
        print(co.get("companyName"), co.get("domain"))
    page += 1
```

```bash Add to a list (v2) theme={null}
curl -X POST https://api.seamless.ai/api/client/v2/companies \
  -H "Token: $SEAMLESS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "companyIds": [9912345], "listIds": [123], "listAction": "add" }'
```

## Reference

### `GET /companies`

| Parameter | Type | Description |
| - | - | - |
| `page` | integer | Page number to retrieve |
| `limit` | integer | Results per page |
| `startDate` | string | ISO 8601 start of the lookback window |
| `endDate` | string | ISO 8601 end of the lookback window |

### `POST /companies` (v2)

| Parameter | Type | Description |
| - | - | - |
| `companyIds` | integer\[] | Saved companies to update |
| `listIds` | integer\[] | Lists to apply. They must already belong to you. |
| `listAction` | string | `add`, `remove`, or `replace` |

## Response

`data` is an array of company records with the same fields as [Company Research](/api-catalog/company-enrichment). See the [Data dictionary](/api-catalog/data-dictionary).

## Errors

| Status | Meaning |
| - | - |
| `401` | Missing or invalid API key |
| `429` | Rate limit reached |

## Related

* [My Contact Data](/api-catalog/my-contact-data)
* [API reference: Get org companies](/api-reference/v1/org-companies/get-org-companies)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.