List company mappings

List materialized Account Mapping records for a partner workspace without employee profiles.

Lists company mappings for the target partner 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 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.

Route

GET/api/v2/partner/workspaces/{partner_workspace_id}/company-mappings

Authentication

Use a partner master key. The target workspace is scoped by the URL path.

Authorization: Bearer $SILLAGE_API_KEY

Path parameters

Parameter	Type	Description
partner_workspace_id	string	Opaque workspace identifier from the partner system.

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/partner/workspaces/ws_123/company-mappings?page=1&page_size=25" \
  -H "Authorization: Bearer $SILLAGE_API_KEY"

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	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	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.
429	Too many requests.
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/partner/workspaces/ws_123/company-mappings"
}

List company mappings

On this page