{"components":{"schemas":{"Company":{"properties":{"company_number":{"pattern":"^[0-9]{1,20}$","type":"string"},"company_type":{"type":["string","null"]},"company_type_code":{"type":["string","null"]},"dissolved_date":{"format":"date","type":["string","null"]},"last_accounts_date":{"format":"date","type":["string","null"]},"last_annual_return_date":{"format":"date","type":["string","null"]},"legal_name":{"type":"string"},"nace_v2_code":{"type":["string","null"]},"name_effective_date":{"format":"date","type":["string","null"]},"next_annual_return_date":{"format":"date","type":["string","null"]},"principal_object_code":{"type":["string","null"]},"registered_address":{"properties":{"eircode":{"type":["string","null"]},"lines":{"items":{"type":"string"},"type":"array"}},"required":["lines","eircode"],"type":"object"},"registered_date":{"format":"date","type":["string","null"]},"status":{"type":["string","null"]},"status_code":{"type":["string","null"]},"status_date":{"format":"date","type":["string","null"]},"type_effective_date":{"format":"date","type":["string","null"]}},"required":["company_number","legal_name","status","status_code","company_type","company_type_code","nace_v2_code","principal_object_code","registered_date","dissolved_date","last_annual_return_date","next_annual_return_date","last_accounts_date","status_date","name_effective_date","type_effective_date","registered_address"],"type":"object"},"CompanyResponse":{"properties":{"company":{"$ref":"#/components/schemas/Company"},"snapshot_id":{"type":"string"},"source":{"$ref":"#/components/schemas/Source"}},"required":["company","source","snapshot_id"],"type":"object"},"DataError":{"properties":{"company":{"type":"null"},"error":{"$ref":"#/components/schemas/Error"},"snapshot_id":{"type":"string"},"source":{"$ref":"#/components/schemas/Source"}},"required":["company","error","source","snapshot_id"],"type":"object"},"Error":{"properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"],"type":"object"},"ErrorResponse":{"properties":{"error":{"$ref":"#/components/schemas/Error"}},"required":["error"],"type":"object"},"Metadata":{"properties":{"endpoints":{"items":{"type":"string"},"type":"array"},"imported_at":{"format":"date-time","type":"string"},"quarantined_company_count":{"minimum":0,"type":"integer"},"rejected_row_count":{"minimum":0,"type":"integer"},"row_count":{"minimum":0,"type":"integer"},"service":{"type":"string"},"snapshot_id":{"type":"string"},"source":{"$ref":"#/components/schemas/Source"},"version":{"type":"string"}},"required":["service","version","endpoints","source","snapshot_id","row_count","quarantined_company_count","rejected_row_count","imported_at"],"type":"object"},"Source":{"properties":{"dataset":{"type":"string"},"dataset_url":{"type":"string"},"license":{"type":"string"},"license_url":{"type":"string"},"modified":{"type":"boolean"},"notice":{"type":"string"},"publisher":{"type":"string"},"resource_id":{"type":"string"},"retrieved_at":{"format":"date-time","type":"string"},"source_updated_at":{"format":"date-time","type":["string","null"]},"synthetic":{"type":"boolean"}},"required":["publisher","dataset","dataset_url","license","license_url","resource_id","notice","retrieved_at","source_updated_at","modified","synthetic"],"type":"object"}}},"info":{"description":"Irish company exact lookups with x402 v2 payments in native USDC on Base. Each successful new lookup costs 10,000 micro-USDC (0.01 USDC). Documentation and metadata are free. Search and resolution are not implemented.","title":"QuerySpigot Company API","version":"0.1.0"},"openapi":"3.1.0","paths":{"/api/v1/company/{company_number}":{"get":{"description":"Successful responses are prepared before settlement and stored durably. Invalid, missing, conflicted, stale and rate-limited requests are not charged. Retry an identical payment to recover a stored result; never automatically create a replacement authorization after an uncertain outcome.","operationId":"getCompany","parameters":[{"example":"100001","in":"path","name":"company_number","required":true,"schema":{"pattern":"^[0-9]{1,20}$","type":"string"}},{"description":"Base64 x402 v2 payload signed by a separate wallet tool.","in":"header","name":"PAYMENT-SIGNATURE","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"examples":{"synthetic":{"summary":"Synthetic illustration only; this number can identify a different company in live CRO data.","value":{"company":{"company_number":"100001","company_type":"Private limited by shares","company_type_code":null,"dissolved_date":null,"last_accounts_date":null,"last_annual_return_date":null,"legal_name":"EXAMPLE SOFTWARE LIMITED","nace_v2_code":null,"name_effective_date":null,"next_annual_return_date":null,"principal_object_code":null,"registered_address":{"eircode":"T12AB34","lines":["1 EXAMPLE STREET","CORK"]},"registered_date":"2014-02-03","status":"Normal","status_code":null,"status_date":null,"type_effective_date":null},"snapshot_id":"sha256:0000000000000000000000000000000000000000000000000000000000000000","source":{"dataset":"Synthetic companies","dataset_url":"","license":"Test data","license_url":"","modified":true,"notice":"Synthetic example. This is not a CRO record.","publisher":"Spigot test fixture","resource_id":"synthetic-companies-v1","retrieved_at":"2026-09-08T00:00:00Z","source_updated_at":null,"synthetic":true}}}},"schema":{"$ref":"#/components/schemas/CompanyResponse"}}},"description":"Company from the current snapshot.","headers":{"PAYMENT-RESPONSE":{"description":"Base64 settlement result; save it with the request and response.","schema":{"type":"string"}}}},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Invalid company number.","headers":{}},"402":{"description":"Payment required or rejected.","headers":{"PAYMENT-REQUIRED":{"schema":{"type":"string"}}}},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DataError"}}},"description":"No company in the current snapshot.","headers":{}},"405":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Unsupported method at the origin.","headers":{}},"409":{"content":{"application/json":{"examples":{"conflict":{"summary":"Synthetic source-conflict illustration.","value":{"company":null,"error":{"code":"source_data_conflict","message":"The source contains multiple records for this company number. No version was selected."},"snapshot_id":"sha256:0000000000000000000000000000000000000000000000000000000000000000","source":{"dataset":"Synthetic companies","dataset_url":"","license":"Test data","license_url":"","modified":true,"notice":"Synthetic example. This is not a CRO record.","publisher":"Spigot test fixture","resource_id":"synthetic-companies-v1","retrieved_at":"2026-09-08T00:00:00Z","source_updated_at":null,"synthetic":true}}}},"schema":{"$ref":"#/components/schemas/DataError"}}},"description":"Conflicting source records withheld.","headers":{}},"429":{"description":"Shared service rate limit reached. Wait for Retry-After seconds.","headers":{"Retry-After":{"schema":{"type":"integer"}}}},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Unavailable dataset or uncertain payment outcome. Do not sign a replacement payment.","headers":{}},"default":{"description":"Gateway or infrastructure error; body and settlement evidence can vary."}},"summary":"Look up one Irish company by company number","x-payment":{"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","network":"eip155:8453","pay_to":"0x5Bb201198478075705fe1e972f6221c812C88EcC","price_micro_usdc":10000}}},"/api/v1/meta":{"get":{"operationId":"getDatasetMetadata","responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Metadata"}}},"description":"Current snapshot."},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"No dataset or database unavailable."}},"summary":"Read current dataset provenance and quality counts without payment"}},"/attribution":{"get":{"operationId":"getAttribution","responses":{"200":{"content":{"application/json":{"schema":{"properties":{"dataset_url":{"type":"string"},"license":{"type":"string"},"license_url":{"type":"string"},"notice":{"type":"string"},"publisher":{"type":"string"}},"required":["publisher","dataset_url","license","license_url","notice"],"type":"object"}}},"description":"CRO source and license notice."}},"summary":"Read source acknowledgment without payment"}},"/docs":{"get":{"operationId":"getDocumentation","responses":{"200":{"content":{"text/html":{"schema":{"type":"string"}}},"description":"Public documentation."}},"summary":"Read public documentation without payment"}},"/docs/api.md":{"get":{"operationId":"getApiGuide","responses":{"200":{"content":{"text/markdown":{"schema":{"type":"string"}}},"description":"Public documentation."}},"summary":"Read public documentation without payment"}},"/llms.txt":{"get":{"operationId":"getLlmGuide","responses":{"200":{"content":{"text/plain":{"schema":{"type":"string"}}},"description":"Public documentation."}},"summary":"Read public documentation without payment"}},"/openapi.json":{"get":{"operationId":"getOpenApi","responses":{"200":{"content":{"application/json":{"schema":{"type":"object"}}},"description":"Public documentation."}},"summary":"Read public documentation without payment"}},"/robots.txt":{"get":{"operationId":"getRobotsPolicy","responses":{"200":{"content":{"text/plain":{"schema":{"type":"string"}}},"description":"Public documentation."}},"summary":"Read public documentation without payment"}}},"servers":[{"description":"Base mainnet API","url":"https://api.queryspigot.com"}]}