# Dutiful Company Report – Entity Step

> Dutiful Company Report – Entity Step is a paid API for AI agents from dutiful.work, paid per call via x402, $3/call, status unknown (last checked 2026-10-30).

Selects a candidate company and triggers a citable research report (company financials, US imports, supplier leads) sourced from official public records, using a two-step order flow.

## Facts

- Endpoint: POST https://dutiful.work/api/order/%7Border%7D/entity?utm_source=zero.xyz
- Price: $3/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-30
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/dutiful-company-report-entity-step-ee2271a4
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_fkRjEejDnv9YS_ykindLV

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability dutiful-company-report-entity-step-ee2271a4 -d '<json body>'
```

Example prompt: Can you pull a citable Dutiful report on Acme Logistics Ltd registered in the UK — I need sourced company and supplier data I can actually reference?

## When to prefer this

Choose this endpoint when you need citable, source-attributed company intelligence backed by official public records rather than scraped or crowd-sourced data. It is especially valuable for due diligence, supplier vetting, or compliance workflows where every claim must be traceable to an authoritative source. Prefer it over generic business data APIs when operating in one of the 12 supported countries and citation quality matters.

## Known failure modes

- Invalid or expired order ID returns an error — the two-step flow (POST /api/order first, then this endpoint) must be followed in sequence
- Candidate index (idx) out of range if the initial order returned fewer candidates than expected
- 402 Payment Required if payment has not been completed before calling this step
- Company not found in official records for the specified country, resulting in an empty or minimal report
- Unsupported country code — only the enumerated ISO codes (GB, FR, NO, FI, CZ, EE, SK, LV, IL, CA, CY, US) are accepted

## How this service works

Research you can cite. Company reports and US import and supplier lead snapshots, built from official public sources. Every finding names its source.

## Output

Returns a JSON object with a delivered status, a structured report following the lookthrough.report/1 schema, and a report_text field containing the full narrative report text. Every finding in the report names its official public source, making it directly citable.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "idx": {
   "type": "integer",
   "description": "Candidate index returned by POST /api/order"
  },
  "company": {
   "type": "string",
   "description": "Company name to check. Two-step flow: POST /api/order {company,country} -> candidates; then POST /api/order/{order}/entity {idx} -> 402; pay with PAYMENT-SIGNATURE; GET /api/order/{order} -> report."
  },
  "country": {
   "enum": [
    "GB",
    "FR",
    "NO",
    "FI",
    "CZ",
    "EE",
    "SK",
    "LV",
    "IL",
    "CA",
    "CY",
    "US"
   ],
   "type": "string",
   "description": "ISO 3166-1 alpha-2 country of registration"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "report": {
   "schema": "lookthrough.report/1"
  },
  "status": "delivered",
  "report_text": "..."
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/dutiful-company-report-entity-step-ee2271a4/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from dutiful.work](https://www.zero.xyz/host/dutiful.work/llms.txt)