Eckari · UK Filings

import { wrapFetchWithPayment } from "@x402/fetch";
import { privateKeyToAccount } from "viem/accounts";

const account = privateKeyToAccount(process.env.PRIVATE_KEY);
const fetchWithPay = wrapFetchWithPayment(fetch, account);

const res = await fetchWithPay("https://api.eckari.com/v1/companies/uk/:companyNumber/filings", {
  method: "GET",
});
const data = await res.json();

curl -X GET \
  "https://api.eckari.com/v1/companies/uk/:companyNumber/filings?limit=3" \
  -H "X-PAYMENT: <signed x402 payment>"

{
  "data": {
    "company_number": "00445790",
    "filing_history_status": "filing-history-available",
    "is_filing_history_available": true,
    "items": [
      {
        "annotations": [
          {
            "annotation": "Clarification HMRC confirmation received that appropriate Stamp Duty has been paid for this transaction.",
            "date": "2026-08-06",
            "description": "annotation"
          }
        ],
        "category": "capital",
        "date": "2026-08-06",
        "description": "Purchase of own shares.",
        "description_source": "enumeration",
        "document_url": "https://find-and-update.company-information.service.gov.uk/company/00445790/filing-history/MzUzNjI5NTk0OWFkaXF6a2N4/document?format=pdf",
        "has_document": true,
        "pages": 4,
        "paper_filed": true,
        "subcategory": null,
        "transaction_id": "MzUzNjI5NTk0OWFkaXF6a2N4",
        "type": "SH03"
      }
    ],
    "page": {
      "has_more": true,
      "limit": 3,
      "next_offset": 3,
      "offset": 0,
      "returned": 3,
      "total": 8367
    },
    "query": {
      "category": null,
      "detail": "summary"
    }
  },
  "meta": {
    "capability": "company.uk.filings",
    "freshness": "live",
    "source": "companies_house",
    "version": "2.0.0"
  }
}