List company mappings

Lists company mappings for the authenticated workspace. This endpoint does not include employee profiles. Use Get company mapping to retrieve profiles for one mapping.

A company can have more than one mapping per day now: one per persona (business unit) that requested it, plus at most one unattributed mapping. persona_id tells them apart — null means the mapping isn't tied to a specific persona and applies to every persona, for example one created before your workspace tracked personas separately.

Route

GET/api/v2/company-mappings

Access modes

Use a workspace API key. The workspace is inferred from the key.

Authorization: Bearer sk_live_...

Query parameters

Parameter	Type	Default	Description
page	integer	1	Page number. Must be greater than or equal to 1.
page_size	integer	25	Number of items per page. Must be between 1 and 100.

Example request

curl "https://api.getsillage.com/api/v2/company-mappings?page=1&page_size=25" \
  -H "Authorization: Bearer sk_live_..."

Success response

Status: 200 OK

{
  "data": [
    {
      "id": 123,
      "request_date": "2026-06-15T10:00:00Z",
      "version": 2,
      "status": "complete",
      "company": {
        "id": 456,
        "name": "Acme",
        "domain": "acme.com"
      },
      "persona_id": null
    }
  ],
  "meta": {
    "pagination": {
      "page": 1,
      "page_size": 25,
      "page_count": 1,
      "total": 12
    }
  }
}

Response headers

Header	Description
X-Request-Id	Request UUID for debugging and support.
X-Response-Time	Server response time.

Response fields

Field	Type	Description
data[].id	integer	Numeric SQL ID of the mapping. Use this as mapping_id for the GET unit endpoint.
data[].request_date	string or null	Materialization date.
data[].version	integer or null	Mapping version, incremented on each rematerialization.
data[].status	string or null	Enrichment status of the mapping. `in_progress` while employee profiles are still being resolved, `complete` once all profiles have been found.
data[].company	object or null	Company attached to the mapping.
data[].company.id	integer	Numeric SQL ID of the company.
data[].company.name	string or null	Company name.
data[].company.domain	string or null	Company domain.
data[].persona_id	integer or null	Id of the persona this mapping is attributed to. `null` means it applies to every persona.
meta.pagination	object	Pagination metadata.

Errors

Status	Meaning
401	The API key is missing or invalid.
403	Account Mapping is not enabled for the workspace.
500	An unexpected server error occurred.

Error responses use RFC 9457 problem documents with Content-Type: application/problem+json:

{
  "type": "https://docs.getsillage.com/errors/forbidden",
  "title": "Forbidden",
  "status": 403,
  "detail": "Account Mapping is not enabled for this workspace.",
  "instance": "/api/v2/company-mappings"
}

List company mappings

On this page