> ## 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.

The `GET` endpoint is on v1 and v2; the `POST` list-membership endpoint is v2 only. Public API v2 is in beta: v2 endpoints return `403` (`noFeatureAccess`) until Seamless enables v2 for your organization.

## 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](https://docs.seamless.ai/authentication/oauth.md). Create a key under [Settings → Public API](https://docs.seamless.ai/authentication/api-keys.md).

## 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"
```

```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"}'
```

For Python, JavaScript, and other languages, see [Get Org Companies](https://docs.seamless.ai/api-reference/v1/org-companies/get-org-companies.md) in the API reference.

## Reference

### `GET /companies`

| Parameter | Type | Required | Description |
| - | - | - | - |
| `page` | integer | No | The page number to retrieve. Default `1`. |
| `limit` | integer | No | The number of results per page. Default `500`. |
| `startDate` | string | Yes | An ISO8601 date time string that defines the start date of the lookback period to return results from. |
| `endDate` | string | Yes | An ISO8601 date time string that defines the end date of the lookback period to return results from. |

### `POST /companies` (v2)

| Parameter | Type | Required | Description |
| - | - | - | - |
| `companyIds` | integer\[] | Yes | IDs of the saved companies to update. Up to 500 values. |
| `listIds` | integer\[] | No | IDs of the lists to apply. The lists must already belong to you; an unknown ID fails the request. May be empty only with `listAction` `replace`, which clears every list off the companies. Up to 50 values. |
| `listAction` | string | No | How `listIds` is applied. `add` keeps the lists the companies are already in, `remove` drops only the supplied lists, and `replace` makes the supplied lists their complete set of lists. Default `add`. |

**Allowed values for `listAction`:** `add`, `remove`, `replace`

## Response

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

## Errors

| Status | Meaning |
| - | - |
| `401` | Missing or invalid API key |
| `422` | `missingApiAccess`: no active Public API license |
| `429` | Rate limit reached |

## Related

* [My Contact Data](https://docs.seamless.ai/api-catalog/my-contact-data.md)
* [API reference: Get org companies](https://docs.seamless.ai/api-reference/v1/org-companies/get-org-companies.md)


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