# company-facts

> company-facts is a paid API for AI agents from api.firstmention.uk, paid per call via x402, $0.01/call, status unknown (last checked 2026-10-31).

Returns a joined company dossier combining SEC EDGAR identity data, CIK, SIC industry, incorporation state, recent filings, RDAP domain facts, and an OFAC/UK/EU sanctions screen for a named company.

## Facts

- Endpoint: GET https://api.firstmention.uk/s/company-facts/snapshot?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-31
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/company-facts-6d1971db
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Acno9uaudzL2136atVE66

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 company-facts-6d1971db
```

Example prompt: Pull up the full company dossier for Palantir Technologies — I need their SEC EDGAR CIK, SIC code, state of incorporation, recent filings, and whether they show up on any OFAC, UK, or EU sanctions lists.

## When to prefer this

Use this endpoint when you need a single aggregated snapshot of a US-registered company's public regulatory identity — combining SEC EDGAR, domain RDAP, and sanctions screening in one call rather than hitting three separate APIs. Ideal for compliance workflows, vendor onboarding, investor due diligence, and AML screening where you want structured, sourced corporate facts without personal data.

## Known failure modes

- Company name not found in SEC EDGAR — returns empty or null CIK/SIC fields
- Ambiguous company name matches multiple EDGAR entities — may return first match or require disambiguation
- RDAP data unavailable for unlisted or private domains — domain object may be empty
- Sanctions API timeout — match field may be null or error flagged
- Missing required 'company' query parameter — returns 400 bad request
- Rate limit exceeded — returns 402 or 429 depending on payment status

## How this service works

One joined company dossier from public sources: SEC EDGAR identity, CIK, SIC industry, incorporation state, recent filings, plus RDAP domain facts and an OFAC/UK/EU sanctions screen of the name. No personal data…[44 more chars, already applied]

## Output

A JSON object containing the company's canonical name, SEC EDGAR CIK, SIC industry code, state of incorporation, recent filing list with total filing count, RDAP domain registration facts, and a sanctions object indicating whether the name matched any OFAC, UK, or EU sanctions list entries.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "headers": {
     "type": "object",
     "additionalProperties": {
      "type": "string"
     }
    },
    "queryParams": {
     "type": "object",
     "required": [
      "company"
     ],
     "properties": {
      "company": {
       "type": "string",
       "description": "Company name to look up; \"q\" is accepted as an alias."
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "properties": {
      "cik": {
       "type": "string"
      },
      "sic": {
       "type": "string"
      },
      "domain": {
       "type": "object",
       "properties": {
        "rdap": {
         "type": "object",
         "properties": {}
        }
       }
      },
      "company": {
       "type": "string"
      },
      "filings": {
       "type": "object",
       "properties": {
        "total": {
         "type": "number"
        },
        "recent": {
         "type": "array"
        }
       }
      },
      "sanctions": {
       "type": "object",
       "properties": {
        "match": {
         "type": "boolean"
        }
       }
      },
      "state_of_incorporation": {
       "type": "string"
      }
     }
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/company-facts-6d1971db/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.firstmention.uk](https://www.zero.xyz/host/api.firstmention.uk/llms.txt)