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

# POST /v1/research_company

`POST /v1/research_company`

## Request

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

## Headers

- `Idempotency-Key` string, required

## Request body

- object
  - `company_domain` string, required: Company website domain or URL, e.g. acme.com or https://www.acme.com/about
  - `audience` string: Optional goal for ranking facts. Always accepted; when checks are off or unavailable, extraction order and the date rule apply, disclosed by ranking. Charges are unchanged.
  - `depth` 'standard' | 'deep'
  - `budget_credits` number
  - `dry_run` boolean

## Response `200`

Successful outcome

- object
  - `result` union, required
    - object
      - `operation_id` string, required
      - `state` 'queued' | 'running' | 'succeeded' | 'partially_succeeded' | 'failed' | 'unknown', required
      - `cached` boolean, required
      - `credits_reserved` string, required
      - `result` object
        - `next` object[]
          - `reason` 'check_funding' | 'check_news' | 'research_strongest' | 'research_deeper' | 'find_people' | 'find_profile', required
          - `text` string, required
          - `verb` 'find_intent' | 'research_company' | 'find_leads' | 'enrich', required
          - `params` object, required
          - `max_credits` string, required
        - `outcome` 'hit' | 'miss' | 'partial', required
        - `company_domain` string, required
        - `depth` 'standard' | 'deep', required
        - `company_name` string, nullable, required
        - `aliases` string[], required
        - `claims` object[], required
          - `kind` 'funding' | 'hiring' | 'product' | 'partnership' | 'leadership' | 'customers' | 'expansion' | 'news' | 'identity' | 'other', required
          - `text` string, required
          - `source_url` string, uri, required
          - `excerpt` string, required
          - `published_at` string, nullable, required
          - `observed_at` string, required
          - `confidence` number, required
          - `source_content_hash` string, required
          - `extraction_version` string, required
          - `entailment` 'supported', required
        - `ranking` object
          - `by` 'goal' | 'recency', required
          - `judged` integer, required
          - `unsure` integer
          - `version` string, required
          - `why_now_judged` integer
          - `companies` string[]
        - `why_now` object[], required
          - `kind` 'funding' | 'hiring' | 'product' | 'partnership' | 'leadership' | 'customers' | 'expansion' | 'news' | 'identity' | 'other', required
          - `text` string, required
          - `source_url` string, uri, required
          - `excerpt` string, required
          - `published_at` string, nullable, required
          - `observed_at` string, required
          - `confidence` number, required
          - `source_content_hash` string, required
          - `extraction_version` string, required
          - `entailment` 'supported', required
        - `sources` object[], required
          - `url` string, uri, required
          - `title` string, nullable, required
          - `published_at` string, nullable, required
          - `origin` 'news_search' | 'identity_search' | 'company_page', required
          - `used` boolean, required
        - `skipped` object[], required
          - `component` string, required
          - `reason` string, required
        - `cost_breakdown` object, required
          - `research_credits` string, required
          - `page_credits` string, required
          - `pages_read` integer, required
          - `total_credits` string, required
          - `maximum_credits` string, required
        - `research_version` string, required
        - `observed_at` string, required
    - object
      - `dry_run` true, required
      - `advisory` true, required
      - `evaluated_at` string, required
      - `plan` object, required
        - `verb` 'research_company', required
        - `plan_version` 3, required
        - `input_version` string, required
        - `credits_estimate` string, required
        - `would_exceed` string[], required
        - `warnings` string[], required
        - `would` object, required
          - `depth` 'standard' | 'deep', required
          - `cache` 'fresh' | 'miss', required
          - `searches` integer, required
          - `pages_max` integer, required
          - `maximum_credits` string, required
          - `budget_credits` string, nullable, required
          - `skipped` object[], required
            - `component` string, required
            - `reason` string, required
  - `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)