Get company mapping

Retrieve one Account Mapping record with enriched employee profiles for a partner workspace.

Retrieves one company mapping and all enriched employee profiles attached to it for the target partner workspace.

Use the top-level id returned by List company mappings as mapping_id. IDs are numeric integers and are specific to your environment.

Route

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

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.
mapping_id	integer	Id of the mapping returned by the list endpoint. Must be greater than or equal to 1.

Example request

curl "https://api.getsillage.com/api/v2/partner/workspaces/ws_123/company-mappings/123" \
  -H "Authorization: Bearer $SILLAGE_API_KEY"

Success response

Status: 200 OK

{
  "id": 123,
  "request_date": "2026-06-15T10:00:00Z",
  "version": 2,
  "status": "complete",
  "company": {
    "id": 456,
    "name": "Acme",
    "domain": "acme.com"
  },
  "persona_id": null,
  "profiles": [
    {
      "id": 789,
      "linkedin_url": "https://www.linkedin.com/in/jane-doe",
      "avatar_url": "https://example.com/avatar.jpg",
      "linkedin_about": "Sales leader focused on enterprise growth.",
      "position": "Head of Sales",
      "first_name": "Jane",
      "last_name": "Doe",
      "email": "jane@acme.com",
      "phone_number": "+331****6789",
      "linkedin_headline": "Head of Sales at Acme",
      "location": {
        "city": "Paris",
        "region": "Île-de-France",
        "country": "France"
      }
    }
  ]
}

Response headers

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

Response fields

Field	Type	Description
id	integer	Id of the mapping.
request_date	string or null	Materialization date.
version	integer or null	Mapping version, incremented on each rematerialization.
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.
company	object or null	Company attached to the mapping.
persona_id	integer or null	Id of the persona this mapping is attributed to. `null` means it applies to every persona.
profiles	array	Enriched employee profiles attached to the mapping.
profiles[].id	integer	Id of the profile.
profiles[].linkedin_url	string or null	LinkedIn profile URL.
profiles[].avatar_url	string or null	Avatar URL.
profiles[].linkedin_about	string or null	LinkedIn about section.
profiles[].position	string or null	Current position.
profiles[].first_name	string or null	First name.
profiles[].last_name	string or null	Last name.
profiles[].email	string or null	Email address.
profiles[].phone_number	string or null	Phone number.
profiles[].linkedin_headline	string or null	LinkedIn headline.
profiles[].location	object or null	Location object.

Errors

Status	Meaning
401	The API key is missing or invalid.
403	Account Mapping is not enabled for the workspace.
404	The mapping was not found or is not visible to the key.
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/123"
}

Get company mapping

On this page