78trust / 100

Execute Companies House Live Discovery V1

by Macaroon Network in Company & people data

x402 APIPassing, checked 3 h ago

Discover current UK companies through the official Companies House advanced search using bounded filters for company-name inclusion, status, type, incorporation date range, location, and five-digit SIC code. Returns at most 20 normalized company-level public-register records.

POST https://api.macaroonnetwork.com/execute/companies-house-live-discovery-v1

Last 30 days

All checks passedSome failedAll failedNot checked
Uptime
100%
Response time
195 ms typical, 348 ms slowest 5%
Last check
3 h ago
Next check
any minute now

How to call it

# See the payment challenge (nothing is charged)
curl -i -X POST "https://api.macaroonnetwork.com/execute/companies-house-live-discovery-v1" \
  -H "content-type: application/json" \
  -d '{"input":{"company_name_inclusion":"Macaroon","company_status":"active","limit":10},"predicate":{"conditions":[{"field":"$.records","type":"count_gte","value":1},{"field":"$.provenance.metadata_only","operator":"eq","type":"field_changed","value":true},{"field":"$.provenance.live_data","operator":"eq","type":"field_changed","value":true},{"field":"$.provenance.outbound_network_used","operator":"eq","type":"field_changed","value":true}],"type":"all"}}'
import { wrapFetchWithPayment } from "@x402/fetch";
import { x402Client } from "@x402/core/client";
import { ExactEvmScheme } from "@x402/evm/exact/client";
import { privateKeyToAccount } from "viem/accounts";

const client = new x402Client().register(
  "eip155:8453",
  new ExactEvmScheme(privateKeyToAccount(process.env.AGENT_KEY)),
);
const pay = wrapFetchWithPayment(fetch, client);

// Not sure it's safe to pay? Preflight it first for $0.005:
// GET https://toolvet.app/api/v1/check?url=https%3A%2F%2Fapi.macaroonnetwork.com%2Fexecute%2Fcompanies-house-live-discovery-v1
const res = await pay("https://api.macaroonnetwork.com/execute/companies-house-live-discovery-v1", {
  method: "POST",
  headers: { "content-type": "application/json" },
  body: JSON.stringify({"input":{"company_name_inclusion":"Macaroon","company_status":"active","limit":10},"predicate":{"conditions":[{"field":"$.records","type":"count_gte","value":1},{"field":"$.provenance.metadata_only","operator":"eq","type":"field_changed","value":true},{"field":"$.provenance.live_data","operator":"eq","type":"field_changed","value":true},{"field":"$.provenance.outbound_network_used","operator":"eq","type":"field_changed","value":true}],"type":"all"}}),
});
console.log(await res.json());

Example input

{
  "input": {
    "company_name_inclusion": "Macaroon",
    "company_status": "active",
    "limit": 10
  },
  "predicate": {
    "conditions": [
      {
        "field": "$.records",
        "type": "count_gte",
        "value": 1
      },
      {
        "field": "$.provenance.metadata_only",
        "operator": "eq",
        "type": "field_changed",
        "value": true
      },
      {
        "field": "$.provenance.live_data",
        "operator": "eq",
        "type": "field_changed",
        "value": true
      },
      {
        "field": "$.provenance.outbound_network_used",
        "operator": "eq",
        "type": "field_changed",
        "value": true
      }
    ],
    "type": "all"
  }
}

Example output

{
  "payload": {
    "filters": {},
    "provenance": {
      "content_hash": null,
      "live_data": null,
      "metadata_only": null,
      "outbound_network_used": null,
      "retrieved_at": null,
      "source": null,
      "source_endpoint": null
    },
    "records": [],
    "total": 0
  },
  "predicate_passed": true,
  "settled": true
}

Security scan

  • No findings. We scan names, descriptions and tool definitions for hidden instructions and other prompt-injection patterns.

Recent checks

WhenResultHTTPTimePrice
3 h agoPassed402109 ms$0.01
6 h agoPassed402143 ms$0.01
10 h agoPassed402261 ms$0.01
13 h agoPassed402195 ms$0.01
17 h agoPassed402170 ms$0.01
20 h agoPassed402180 ms$0.01
24 h agoPassed402332 ms$0.01
27 h agoPassed402357 ms$0.01
31 h agoPassed402100 ms$0.01
35 h agoPassed402237 ms$0.01
38 h agoPassed402105 ms$0.01
43 h agoPassed402225 ms$0.01
45 h agoPassed402348 ms$0.01
2 days agoPassed402278 ms$0.01