---
title: "POST /v1/enrich_company"
method: POST
path: "/v1/enrich_company"
tags: ["GTM verbs"]
---

# POST /v1/enrich_company

`POST /v1/enrich_company`

## Request

- Base URL: `https://api.layrcake.dev`
- URL: `https://api.layrcake.dev/v1/enrich_company`
- Auth: HTTP bearer

## Headers

- `Idempotency-Key` string

## Request body

- object
  - `company_domain` string, required: Company website domain or URL, e.g. acme.com or https://www.acme.com/about
  - `want` string[]
  - `depth` 'fast' | 'deep'

## Response `200`

Successful outcome

- object
  - `result` object, required
    - `outcome` 'hit' | 'partial' | 'miss', required
    - `company_domain` string, required
    - `company` object, nullable, required
      - `company_name` string, nullable
      - `description` string, nullable
      - `headcount` integer, nullable
      - `industry` string, nullable
      - `country` string, nullable
      - `founded_year` integer, nullable
      - `linkedin_url` string, uri, nullable
      - `technologies` object[]
        - `name` string, required
        - `category` string, nullable
        - `observed_at` union, required
          - string, date
          - string, date-time
      - `funding` object[]
        - `date` union, required
          - string, date
          - string, date-time
        - `amount_usd` number, nullable, required
        - `type` string, nullable, required
        - `source_url` string, uri, nullable, required
      - `relationships` object[]
        - `company_domain` string, nullable, required
        - `company_name` string, nullable, required
        - `relationship_type` 'integration' | 'partner' | 'customer' | 'other', required
        - `source_url` string, uri, nullable, required
        - `first_seen_at` union, required
          - string, date
          - string, date-time
      - `brief` object
        - `summary` string, required
        - `products` string[], required
        - `target_customers` string, nullable
        - `pricing_notes` string, nullable
        - `hiring_notes` string, nullable
        - `recent_news` object[], required
          - `headline` string, required
          - `date` union, required
            - string, date
            - string, date-time
          - `url` string, uri, required
        - `sources` object[], required
          - `url` string, uri, required
          - `title` string, nullable
        - `observed_at` union, required
          - string, date
          - string, date-time
    - `dataset_status` object[], required
      - `dataset` 'profile' | 'technologies' | 'funding' | 'relationships' | 'brief', required
      - `status` 'hit' | 'empty' | 'unavailable', required
      - `from_cache` boolean, required
      - `observed_at` union, required
        - string, date
        - string, date-time
  - `layrcake` object, required
    - `request_id` string, uuid, required
    - `credits_charged` string, required
    - `credits_available` string, required
    - `replayed` boolean
    - `route` object
      - `used` 'balanced' | 'cheapest' | 'broadest' | 'fastest', required
      - `source` 'request' | 'key' | 'guess' | 'default', required

## Other responses

- `4XX`: Caller, scope, confirmation, or credit error
- `5XX`: Provider or service error

---

[API](https://skmtc.dev/layrcake/apis/layrcake-api.md) · [All operations](https://skmtc.dev/layrcake/apis/layrcake-api/llms.txt) · [OpenAPI document](https://skmtc.dev/layrcake/apis/layrcake-api/revisions/24c80e33c274?raw)