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

# List Company Profiles

> List the company profiles agents use as context about your organisation.

> [!NOTE]
>
> **Preview.** This endpoint is available to organisations in the Wordsmith MCP pilot. Other organisations receive `403 mcp_not_enabled`. See the [preview overview](/preview).

Lists the [company profiles](/proposed/objects#organisation) the caller can read. Agents read a profile as context when they review, draft and answer questions: where you operate, what you do, how you are regulated and who signs for you.

Most organisations have one profile. A group can keep one per company, and share each with the people who work for it.

## Authentication

Requires an API key, or an OAuth token with `directory:read`.

## Query parameters

**cursor** `string`

The `cursor` from the previous page.

**limit** `integer` (default: 50)

Profiles per page, up to 200.

## Response

Returns `200` with a page of profile summaries (`id`, `name`, `jurisdictions`, `industry`), sorted by name. Read one in full with [Get Company Profile](/api-reference/organisation/get-company-profile).

```bash cURL theme={null}
curl "https://api.wordsmith.ai/api/v1/company-profiles" \
  -H "Authorization: Bearer sk-ws-api1-your_api_key_here"
```

```json Response theme={null}
{
  "items": [
    {
      "id": "3f9c2b71-8d4e-4a06-b5c3-91e7d0a2f648",
      "name": "Northwind Logistics Ltd",
      "jurisdictions": ["England & Wales"],
      "industry": ["Logistics"]
    }
  ],
  "cursor": null
}
```


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