---
title: "Enrich Domain Endpoint"
method: POST
path: "/v1/onboarding/enrichment"
tags: ["onboarding"]
---

# Enrich Domain Endpoint

`POST /v1/onboarding/enrichment`

## Request

- Base URL: `https://api.4chems.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.4chems.com/v1/onboarding/enrichment`
- Auth: HTTP bearer

Fetch the caller's domain imprint and suggest legal-entity details (UC-057).

Empty body (domain comes from the token email claim only — NFR-006 pt 4).
Suggest-only: always 200, never errors the wizard. All-null on any failure.
Free-mail domains return all-null without any outbound fetch (AC4).
Per-principal rate limit: RATE_LIMIT_ENRICHMENT_PER_MINUTE (default 5/min).

## Response `200`

Successful Response

- EnrichmentOut: Response for POST /v1/onboarding/enrichment (UC-057). Suggest-only: all fields are nullable; confidence=0 means no suggestion. The UI must fall back to manual entry when confidence is low.
  - `legal_entity_name` string, nullable
  - `entity_type` string, nullable
  - `country` string, nullable
  - `confidence` number
  - `source_url` string, nullable

---

[API](https://skmtc.dev/4chems/apis/platform-api.md) · [All operations](https://skmtc.dev/4chems/apis/platform-api/llms.txt) · [OpenAPI document](https://skmtc.dev/4chems/apis/platform-api/revisions/65e4f7b4dba0?raw)