List Company Profiles

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

GET /api/v1/company-profiles

cURL

curl "https://api.wordsmith.ai/api/v1/company-profiles" \
  -H "Authorization: Bearer sk-ws-api1-your_api_key_here"

Response

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

Preview. This endpoint is available to organisations in the Wordsmith MCP pilot. Other organisations receive 403 mcp_not_enabled. See the preview overview.

Lists the company profiles 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.

cURL

curl "https://api.wordsmith.ai/api/v1/company-profiles" \
  -H "Authorization: Bearer sk-ws-api1-your_api_key_here"

Response

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