# Clink Forge UK Company Lookup

> Clink Forge UK Company Lookup is a paid API for AI agents from api.clinkforge.com, paid per call via x402, $0.005/call, status unknown (last checked 2026-09-15).

Looks up UK company registration data by company number, returning government-sourced records with cryptographic provenance and attestation, paid per-call via x402/USDC.

## Facts

- Endpoint: GET https://api.clinkforge.com/v1/p/uk-company-lookup
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/clink-forge-uk-company-lookup-97bafede
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_EYBx6oj1TlvIV6-Pirus5

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 clink-forge-uk-company-lookup-97bafede
```

Example prompt: Can you look up the official UK Companies House record for company number 09876543 and give me the details with proof of where the data came from?

## When to prefer this

Choose this endpoint when you need official UK company registration data with cryptographic proof of provenance — ideal for KYB/KYC compliance, due diligence, legal workflows, or any automated pipeline where you need to prove the data came from a government source. It requires no account or API key, only a USDC wallet on Base, making it suitable for autonomous agents. Prefer this over scraping Companies House directly or using unofficial aggregators when verifiability and auditability of the data source are required.

## Known failure modes

- Invalid or missing company ID (id param absent or malformed) — returns 400 bad request
- Company number not found in registry — returns empty data array or 404
- Payment failure or insufficient USDC balance — x402 payment required response
- Company number exceeds 12-character max length — schema validation error
- Network or upstream government data source unavailable — 503 or timeout
- Attestation signing failure — server-side error response

## How this service works

Pay per call over x402. USDC on Base, no account, no API key. 28 government-sourced data products at $0.001–$0.05 per call, every response signed and provenance-chained.

## Output

Returns a JSON object containing: an array of data rows with company record fields, the product identifier, row count, a provenance chain (hash, authority name, source government URL, observation timestamp), a cryptographic attestation (signature, result digest, signing key ID), and a payment receipt (USD amount, on-chain settlement reference). Every response is signed by Clink Forge for verifiable data integrity.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "properties": {
  "input": {
   "type": "object",
   "properties": {
    "type": {
     "const": "http"
    },
    "method": {
     "const": "GET"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "id"
     ],
     "properties": {
      "id": {
       "type": "string",
       "maxLength": 12
      }
     },
     "additionalProperties": false
    }
   }
  },
  "output": {
   "type": "object"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "data": [
   {
    "field": "value",
    "_record_id": "R-100"
   }
  ],
  "product": "example-product",
  "row_count": 1,
  "provenance": [
   {
    "hash": "sha256...",
    "authority": "AGENCY",
    "source_url": "https://agency.gov/data",
    "observed_at": "2026-08-25T00:00:00Z"
   }
  ],
  "attestation": {
   "signature": "base64...",
   "result_digest": "sha256...",
   "signing_key_id": "forge-signing-1"
  },
  "payment_receipt": {
   "amount_usd": 0.01,
   "settlement_ref": "0xtx..."
  },
  "product_version": 1
 },
 "description": "data rows + provenance chain + attestation"
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/clink-forge-uk-company-lookup-97bafede/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.clinkforge.com](https://www.zero.xyz/host/api.clinkforge.com/llms.txt)