Get company mapping

Retrieves one company mapping and all enriched employee profiles attached to it.

Use the top-level id returned by List company mappings as mapping_id. IDs are numeric SQL identifiers and are not portable across environments.

Route

GET/api/v2/company-mappings/{mapping_id}

Access modes

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

Authorization: Bearer sk_live_...

Path parameters

Parameter	Type	Description
mapping_id	integer	Numeric SQL ID of the top-level mapping returned by the list endpoint. Must be greater than or equal to 1.

Example request

curl "https://api.getsillage.com/api/v2/company-mappings/123" \
  -H "Authorization: Bearer sk_live_..."

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"
  },
  "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",
      "position_start_date": "2023-01-01",
      "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	Numeric SQL 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.
profiles	array	Enriched employee profiles attached to the mapping.
profiles[].id	integer	Numeric SQL 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[].position_start_date	string or null	Date the person started their current role, ISO 8601 (YYYY-MM-DD). Null when not available.
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.
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/123"
}

Get company mapping

On this page