{"x402Version":2,"service":{"name":"UK Company Data API","description":"Companies House: search, profiles, officers, filings","version":"1.0.0","homepage":"https://github.com/chetparker/x402-company-api"},"payment":{"payTo":"0xFFc458dB291b4ABcE020fE3de4f91F2770E537b1","network":"eip155:8453","scheme":"exact","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","facilitator":"https://api.cdp.coinbase.com/platform/v2/x402"},"endpoints":[{"method":"POST","path":"/company-search","price":"0.001","description":"Search companies by name","extensions":{"bazaar":{"info":{"input":{"type":"http","method":"POST","bodyType":"json","body":{"query":"Tesco","limit":10}},"output":{"type":"json","example":{"query":"Tesco","total_results":423,"results":[{"company_number":"00445790","title":"TESCO PLC","company_status":"active","company_type":"plc","date_of_creation":"1947-11-27","address":"Tesco House, Shire Park, Welwyn Garden City, AL7 1GA"}]}}},"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"input":{"type":"object","properties":{"type":{"type":"string","const":"http"},"method":{"type":"string","enum":["POST","PUT","PATCH"]},"bodyType":{"type":"string","enum":["json","form-data","text"]},"body":{"type":"object","properties":{"query":{"type":"string","description":"Company name (or partial name) to search."},"limit":{"type":"integer","minimum":1,"maximum":50,"description":"Maximum number of matches to return (1-50)."}},"required":["query"]}},"required":["type","method","bodyType","body"],"additionalProperties":false},"output":{"type":"object","properties":{"type":{"type":"string"},"example":{"type":"object","properties":{"query":{"type":"string"},"total_results":{"type":"integer"},"results":{"type":"array","description":"Matching companies with number, name, status, type, incorporation date, address."}}}},"required":["type"]}},"required":["input"]}}}},{"method":"POST","path":"/company-profile","price":"0.001","description":"Full company profile","extensions":{"bazaar":{"info":{"input":{"type":"http","method":"POST","bodyType":"json","body":{"company_number":"00445790"}},"output":{"type":"json","example":{"company_number":"00445790","company_name":"TESCO PLC","company_status":"active","company_type":"plc","date_of_creation":"1947-11-27","date_of_cessation":null,"registered_office":{"address_line_1":"Tesco House, Shire Park","locality":"Welwyn Garden City","postal_code":"AL7 1GA"},"sic_codes":["47110"],"accounts":{"next_due":"2025-08-31","last_accounts":{"made_up_to":"2024-02-24"}},"confirmation_statement":{"next_due":"2025-06-21"},"has_charges":true,"has_insolvency_history":false}}},"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"input":{"type":"object","properties":{"type":{"type":"string","const":"http"},"method":{"type":"string","enum":["POST","PUT","PATCH"]},"bodyType":{"type":"string","enum":["json","form-data","text"]},"body":{"type":"object","properties":{"company_number":{"type":"string","description":"Companies House registration number (zero-padded, e.g. '00445790')."}},"required":["company_number"]}},"required":["type","method","bodyType","body"],"additionalProperties":false},"output":{"type":"object","properties":{"type":{"type":"string"},"example":{"type":"object","properties":{"company_number":{"type":"string"},"company_name":{"type":"string"},"company_status":{"type":"string"},"company_type":{"type":"string"},"date_of_creation":{"type":"string"},"date_of_cessation":{"type":["string","null"]},"registered_office":{"type":"object"},"sic_codes":{"type":"array"},"accounts":{"type":"object"},"confirmation_statement":{"type":"object"},"has_charges":{"type":"boolean"},"has_insolvency_history":{"type":"boolean"}}}},"required":["type"]}},"required":["input"]}}}},{"method":"POST","path":"/officers","price":"0.001","description":"Company officers/directors","extensions":{"bazaar":{"info":{"input":{"type":"http","method":"POST","bodyType":"json","body":{"company_number":"00445790"}},"output":{"type":"json","example":{"company_number":"00445790","total_results":12,"active_count":9,"resigned_count":3,"officers":[{"name":"MURPHY, Kenneth John","officer_role":"director","appointed_on":"2020-10-01","resigned_on":null,"nationality":"Irish","occupation":"Chief Executive Officer","address":{"locality":"Welwyn Garden City","country":"England"}}]}}},"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"input":{"type":"object","properties":{"type":{"type":"string","const":"http"},"method":{"type":"string","enum":["POST","PUT","PATCH"]},"bodyType":{"type":"string","enum":["json","form-data","text"]},"body":{"type":"object","properties":{"company_number":{"type":"string","description":"Companies House registration number (zero-padded, e.g. '00445790')."}},"required":["company_number"]}},"required":["type","method","bodyType","body"],"additionalProperties":false},"output":{"type":"object","properties":{"type":{"type":"string"},"example":{"type":"object","properties":{"company_number":{"type":"string"},"total_results":{"type":"integer"},"active_count":{"type":"integer"},"resigned_count":{"type":"integer"},"officers":{"type":"array","description":"Officers with name, role, appointment/resignation dates, nationality, occupation, address."}}}},"required":["type"]}},"required":["input"]}}}},{"method":"POST","path":"/filings","price":"0.001","description":"Filing history","extensions":{"bazaar":{"info":{"input":{"type":"http","method":"POST","bodyType":"json","body":{"company_number":"00445790","limit":20}},"output":{"type":"json","example":{"company_number":"00445790","total_count":1247,"filings":[{"date":"2024-08-22","type":"AA","category":"accounts","description":"Full accounts made up to 24 February 2024","action_date":"2024-02-24"}]}}},"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"input":{"type":"object","properties":{"type":{"type":"string","const":"http"},"method":{"type":"string","enum":["POST","PUT","PATCH"]},"bodyType":{"type":"string","enum":["json","form-data","text"]},"body":{"type":"object","properties":{"company_number":{"type":"string","description":"Companies House registration number (zero-padded, e.g. '00445790')."},"limit":{"type":"integer","minimum":1,"maximum":50,"description":"Maximum number of filings to return, most recent first (1-50)."}},"required":["company_number"]}},"required":["type","method","bodyType","body"],"additionalProperties":false},"output":{"type":"object","properties":{"type":{"type":"string"},"example":{"type":"object","properties":{"company_number":{"type":"string"},"total_count":{"type":"integer"},"filings":{"type":"array","description":"Filing history entries with date, type, category, description."}}}},"required":["type"]}},"required":["input"]}}}}]}