> ## Documentation Index > Fetch the complete documentation index at: https://docs.revcenter.ai/llms.txt > Use this file to discover all available pages before exploring further. # Enrich a company > Returns a full company record. The path segment is treated as the LinkedIn universal name unless you pass `search`. Requires the `data:companies:read` scope. ## OpenAPI ````yaml /openapi.json get /v1/data/companies/{companyId} openapi: 3.1.0 info: title: Revcenter API description: >- Search, enrich, and activate people and companies. Two authentication surfaces share one host: the bearer-token API under `/v1` for server-to-server and agent use, and the workspace-session API under `/api` that the Revcenter app itself runs on. version: '2026-08-12' servers: - url: https://api.revcenter.ai description: Production security: - bearerAuth: [] tags: - name: Search description: Web search, search runs, results, exports, and shareable shortlists. - name: People description: Person search, profile enrichment, and the workspace contact pool. - name: Companies description: Company search, company enrichment, and org-chart people. - name: Campaigns description: Plan, publish, and launch outbound sequences on Smartlead and HeyReach. - name: Account description: Health, usage totals, and cost events. paths: /v1/data/companies/{companyId}: get: tags: - Companies summary: Enrich a company description: >- Returns a full company record. The path segment is treated as the LinkedIn universal name unless you pass `search`. Requires the `data:companies:read` scope. operationId: enrichCompany parameters: - name: companyId in: path required: true description: LinkedIn universal name, e.g. `merrill-lynch`. schema: type: string example: merrill-lynch - name: universal_name in: query required: false description: Explicit universal name. Overrides the path segment. schema: type: string - name: search in: query required: false description: >- Resolve the company by name search instead of by universal name. Takes precedence when present. schema: type: string - $ref: '#/components/parameters/IdempotencyKeyHeader' responses: '200': description: The enriched company. content: application/json: schema: allOf: - $ref: '#/components/schemas/MeteredEnvelope' - type: object properties: data: type: object properties: company: $ref: '#/components/schemas/CompanyProfile' '401': $ref: '#/components/responses/Unauthorized' '403': $ref: '#/components/responses/InsufficientScope' '424': $ref: '#/components/responses/ProviderUnavailable' '429': $ref: '#/components/responses/RateLimited' '502': $ref: '#/components/responses/ProviderError' security: - bearerAuth: [] components: parameters: IdempotencyKeyHeader: name: Idempotency-Key in: header required: false description: >- Deduplicates the billing event when a request is retried. Safe to send on every call. schema: type: string minLength: 8 maxLength: 160 schemas: MeteredEnvelope: type: object description: The standard success envelope for billed endpoints. properties: data: type: object meta: allOf: - $ref: '#/components/schemas/Meta' - type: object properties: usage: $ref: '#/components/schemas/Usage' CompanyProfile: type: object description: >- A full company record. Provider fields pass through, so expect more keys than are listed here. properties: name: type: - string - 'null' universalName: type: - string - 'null' description: type: - string - 'null' website: type: - string - 'null' format: uri employeeCountRange: type: - string - 'null' industries: type: array items: type: object additionalProperties: true locations: type: array items: type: object additionalProperties: true additionalProperties: true Meta: type: object properties: request_id: type: string format: uuid description: >- Echoes an inbound `X-Request-Id` when you send one, otherwise generated. Always returned in the `X-Request-Id` header too. Usage: type: object description: What this single call cost. properties: operation: type: string examples: - data.people.profile acquisition_units: type: integer examples: - 10000 billable_units: type: integer examples: - 10000 funding_source: $ref: '#/components/schemas/FundingSource' Error: type: object description: The error shape used by every `/v1` endpoint. properties: error: type: object properties: code: type: string examples: - insufficient_scope message: type: string details: type: object additionalProperties: true meta: $ref: '#/components/schemas/Meta' FundingSource: type: string enum: - platform - workspace_byok description: >- `platform` means Revcenter's own provider keys paid for the call and it counts as billable acquisition. `workspace_byok` means your workspace's own provider key did — the activity is recorded, but the vendor spend is yours, not billable overage. responses: Unauthorized: description: No key, or the key is invalid, expired, or revoked. content: application/json: schema: $ref: '#/components/schemas/Error' examples: missing: value: error: code: missing_api_key message: 'Send Authorization: Bearer rvc_live_...' meta: request_id: 6f1c2b7e-9a3d-4c5f-8e21-0b7d4a9c1e33 invalid: value: error: code: invalid_api_key message: API key is invalid, expired, or revoked. meta: request_id: 6f1c2b7e-9a3d-4c5f-8e21-0b7d4a9c1e33 InsufficientScope: description: The key authenticated but lacks the scope this endpoint requires. content: application/json: schema: $ref: '#/components/schemas/Error' examples: scope: value: error: code: insufficient_scope message: API key requires scope 'data:people:read'. meta: request_id: 6f1c2b7e-9a3d-4c5f-8e21-0b7d4a9c1e33 ProviderUnavailable: description: >- The workspace has no usable provider key for this capability — it is either unprovisioned or switched off. content: application/json: schema: $ref: '#/components/schemas/Error' examples: unavailable: value: error: code: provider_unavailable message: Web search is unavailable for this workspace. meta: request_id: 6f1c2b7e-9a3d-4c5f-8e21-0b7d4a9c1e33 RateLimited: description: >- The key exceeded its per-minute limit. Check `X-RateLimit-Reset` for when the window rolls over. content: application/json: schema: $ref: '#/components/schemas/Error' examples: limited: value: error: code: rate_limited message: API key rate limit exceeded. meta: request_id: 6f1c2b7e-9a3d-4c5f-8e21-0b7d4a9c1e33 ProviderError: description: The upstream data source failed. Nothing is billed. content: application/json: schema: $ref: '#/components/schemas/Error' examples: upstream: value: error: code: provider_error message: Harvest profile request failed meta: request_id: 6f1c2b7e-9a3d-4c5f-8e21-0b7d4a9c1e33 securitySchemes: bearerAuth: type: http scheme: bearer description: >- A Revcenter API key: `Authorization: Bearer rvc_live_...`. Keys are scoped, rate limited per key, and metered per workspace. ````