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

# POST /v1/prospect_picture

`POST /v1/prospect_picture`

## Request

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

## Headers

- `Idempotency-Key` string, required

## Request body

- object
  - `audience` string
  - `person` object
    - `full_name` string
    - `first_name` string
    - `last_name` string
    - `email` string
    - `linkedin_url` string, uri
    - `company_name` string
    - `company_domain` string: Company website domain or URL, e.g. acme.com or https://www.acme.com/about
    - `title` string
  - `company_domain` string: Company website domain or URL, e.g. acme.com or https://www.acme.com/about
  - `depth` 'quick' | '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
      - `credits_reserved` string, required
      - `components` object[], required
        - `component` 'identity' | 'company' | 'intent' | 'social' | 'research' | 'network', required
        - `state` 'pending' | 'running' | 'succeeded' | 'failed' | 'skipped' | 'unknown', required
        - `reason` string, nullable, required
        - `max_credits` string, required
      - `result` object
        - `outcome` 'hit' | 'partial' | 'miss', required
        - `depth` 'quick' | 'standard' | 'deep', required
        - `subject` object, required
          - `company_domain` string, nullable, required
          - `person_provided` boolean, required
        - `datapoints` union[], required
          - union
            - object
              - …
            - object
              - …
            - object
              - …
            - object
              - …
            - object
              - …
        - `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
        - `facts` object[]
          - `kind` 'funding_round' | 'product_launch' | 'partnership' | 'customer_win' | 'expansion' | 'news_coverage', required
          - `text` string, required
          - `source_url` string, uri, required
          - `published_at` string, nullable, required
          - `observed_at` string, required
        - `why_now` object[], required
          - `kind` 'intent_signal' | 'research_claim' | 'social_post' | 'pooled_fact', required
          - `text` string, required
          - `observed_at` string, required
          - `source_url` string, nullable, required
        - `ranking` object
          - `by` 'goal' | 'recency', required
          - `judged` integer, required
          - `unsure` integer
          - `version` string, required
          - `why_now_judged` integer
          - `companies` string[]
        - `components` object[], required
          - `component` 'identity' | 'company' | 'intent' | 'social' | 'research' | 'network', required
          - `status` 'hit' | 'miss' | 'skipped' | 'failed' | 'unknown', required
          - `reason` string, nullable, required
          - `credits` string, required
          - `max_credits` string, required
          - `from_cache` boolean, required
          - `from_pool` boolean, required
        - `cost_breakdown` object, required
          - `component_credits` string, required
          - `assembly_credits` string, required
          - `total_credits` string, required
          - `maximum_credits` string, required
          - `budget_credits` string, nullable, required
        - `picture_version` string, required
        - `observed_at` string, required
    - object
      - `dry_run` true, required
      - `advisory` true, required
      - `evaluated_at` string, required
      - `plan` object, required
        - `verb` 'prospect_picture', required
        - `plan_version` 3, required
        - `input_version` string, required
        - `credits_estimate` string, required
        - `would_exceed` string[], required
        - `warnings` string[], required
        - `would` object, required
          - `depth` 'quick' | 'standard' | 'deep', required
          - `components` object[], required
            - `component` 'identity' | 'company' | 'intent' | 'social' | 'research' | 'network', required
            - `planned` boolean, required
            - `reason` string, nullable, required
            - `max_credits` string, required
            - `cache` 'fresh' | 'miss' | 'n/a', required
          - `assembly_credits` string, required
          - `maximum_credits` string, required
          - `budget_credits` string, nullable, 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)