{"openapi":"3.1.0","info":{"title":"Business Change Intelligence API","version":"1.0.0","description":"Temporal, evidence-backed business and location change intelligence for research agents. The API separates effective time from observation time, preserves exact premises, exposes source coverage, and never treats regulatory activity as proof of public opening.","contact":{"url":"https://businesschanges.dev/docs"}},"servers":[{"url":"https://api.businesschanges.dev","description":"Canonical production API"}],"tags":[{"name":"business-changes","description":"Search and monitor derived business events."},{"name":"evidence","description":"Expand events into immutable primary-source records."},{"name":"coverage","description":"Inspect source, jurisdiction, and freshness coverage."},{"name":"location-intelligence","description":"Research exact premises or buildings."}],"paths":{"/v1/events/search":{"post":{"operationId":"business_changes.find_leads","summary":"Find evidence-backed business change leads","description":"Find previously unknown businesses or locations with recent license, permit, inspection, ownership, opening, closure, or tenant-transition signals. Use for market research, sales prospecting, expansion tracking, and location intelligence. Results are compact by default and always distinguish regulatory leads from confirmed public status.","tags":["business-changes","sales-intelligence","public-records","location-intelligence","research"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"jurisdictions":{"minItems":1,"maxItems":25,"type":"array","items":{"type":"string","minLength":2,"maxLength":64,"pattern":"^[A-Z0-9][A-Z0-9._-]*$","description":"Stable jurisdiction code such as US-FL."}},"geography":{"type":"object","properties":{"cities":{"minItems":1,"maxItems":25,"type":"array","items":{"type":"string","minLength":1}},"counties":{"minItems":1,"maxItems":25,"type":"array","items":{"type":"string","minLength":1}},"regionCodes":{"minItems":1,"maxItems":25,"type":"array","items":{"type":"string","minLength":2,"maxLength":16}},"postalCodes":{"minItems":1,"maxItems":50,"type":"array","items":{"type":"string","minLength":3,"maxLength":16}},"near":{"type":"object","properties":{"latitude":{"type":"number","minimum":-90,"maximum":90},"longitude":{"type":"number","minimum":-180,"maximum":180},"radiusKm":{"type":"number","exclusiveMinimum":0,"maximum":250}},"required":["latitude","longitude","radiusKm"],"additionalProperties":false}},"additionalProperties":false},"intents":{"minItems":1,"maxItems":6,"type":"array","items":{"type":"string","enum":["opening_leads","construction_activity","remodels","operator_changes","closure_risk","compliance_activity"]}},"eventTypes":{"minItems":1,"maxItems":25,"type":"array","items":{"type":"string","minLength":3,"maxLength":100,"pattern":"^[a-z0-9]+(?:[._-][a-z0-9]+)+$"}},"industries":{"minItems":1,"maxItems":25,"type":"array","items":{"type":"string","minLength":1,"maxLength":80}},"effectiveAfter":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","description":"ISO calendar date in YYYY-MM-DD form."},"effectiveBefore":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","description":"ISO calendar date in YYYY-MM-DD form."},"observedAfter":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$","description":"ISO 8601 timestamp with an explicit timezone offset."},"minEvidenceStrength":{"default":"strong","type":"string","enum":["weak","moderate","strong","authoritative"]},"minClassificationConfidence":{"default":0.75,"type":"number","minimum":0,"maximum":1},"projection":{"default":"compact","type":"string","enum":["compact","standard","full"]},"limit":{"default":25,"type":"integer","minimum":1,"maximum":100},"cursor":{"type":"string","minLength":1,"maxLength":512}},"required":["minEvidenceStrength","minClassificationConfidence","projection","limit"],"additionalProperties":false},"example":{"jurisdictions":["US-FL"],"geography":{"cities":["Orlando"]},"intents":["opening_leads"],"industries":["restaurant"],"observedAfter":"2026-07-01T00:00:00.000Z","projection":"compact","limit":25}}}},"responses":{"200":{"description":"Successful evidence-backed response.","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"events":{"type":"array","items":{"type":"object","properties":{"eventId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"eventType":{"type":"string","minLength":3,"maxLength":100,"pattern":"^[a-z0-9]+(?:[._-][a-z0-9]+)+$"},"intents":{"type":"array","items":{"type":"string","enum":["opening_leads","construction_activity","remodels","operator_changes","closure_risk","compliance_activity"]}},"status":{"type":"string","enum":["active","superseded","retracted"]},"headline":{"type":"string"},"explanation":{"anyOf":[{"type":"string"},{"type":"null"}]},"effectiveAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$","description":"ISO 8601 timestamp with an explicit timezone offset."},"firstObservedAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$","description":"ISO 8601 timestamp with an explicit timezone offset."},"lastObservedAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$","description":"ISO 8601 timestamp with an explicit timezone offset."},"jurisdiction":{"type":"string","minLength":2,"maxLength":64,"pattern":"^[A-Z0-9][A-Z0-9._-]*$","description":"Stable jurisdiction code such as US-FL."},"organization":{"anyOf":[{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"name":{"type":"string"}},"required":["id","name"],"additionalProperties":false},{"type":"null"}]},"brand":{"anyOf":[{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"name":{"type":"string"}},"required":["id","name"],"additionalProperties":false},{"type":"null"}]},"establishmentId":{"anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"null"}]},"location":{"anyOf":[{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"addressLine1":{"type":"string"},"subpremise":{"anyOf":[{"type":"string"},{"type":"null"}]},"city":{"type":"string"},"county":{"anyOf":[{"type":"string"},{"type":"null"}]},"regionCode":{"type":"string"},"postalCode":{"anyOf":[{"type":"string"},{"type":"null"}]},"countryCode":{"type":"string"},"latitude":{"anyOf":[{"type":"number"},{"type":"null"}]},"longitude":{"anyOf":[{"type":"number"},{"type":"null"}]},"matchScope":{"type":"string","enum":["exact_premise","building"]}},"required":["id","addressLine1","subpremise","city","county","regionCode","postalCode","countryCode","latitude","longitude","matchScope"],"additionalProperties":false},{"type":"null"}]},"industries":{"type":"array","items":{"type":"string"}},"confidence":{"type":"object","properties":{"classification":{"type":"number","minimum":0,"maximum":1},"identityResolution":{"anyOf":[{"type":"number","minimum":0,"maximum":1},{"type":"null"}]},"publicStatus":{"anyOf":[{"type":"number","minimum":0,"maximum":1},{"type":"null"}]},"evidenceStrength":{"type":"string","enum":["weak","moderate","strong","authoritative"]},"derivationVersion":{"type":"string"}},"required":["classification","identityResolution","publicStatus","evidenceStrength","derivationVersion"],"additionalProperties":false},"evidence":{"type":"object","properties":{"count":{"type":"integer","minimum":0,"maximum":9007199254740991},"strongestSource":{"anyOf":[{"type":"string"},{"type":"null"}]},"sourceTypes":{"type":"array","items":{"type":"string"}}},"required":["count","strongestSource","sourceTypes"],"additionalProperties":false},"publicStatus":{"anyOf":[{"type":"object","properties":{"status":{"type":"string","enum":["announced","preparing_to_open","publicly_listed","open_confirmed","temporarily_closed","permanently_closed"]},"observedAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$","description":"ISO 8601 timestamp with an explicit timezone offset."},"sourceRecordId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"sourceUrl":{"type":"string","format":"uri"},"summary":{"type":"string"}},"required":["status","observedAt","sourceRecordId","sourceUrl","summary"],"additionalProperties":false},{"type":"null"}]},"schemaVersion":{"type":"string"},"taxonomyVersion":{"type":"string"}},"required":["eventId","eventType","intents","status","headline","explanation","effectiveAt","firstObservedAt","lastObservedAt","jurisdiction","organization","brand","establishmentId","location","industries","confidence","evidence","publicStatus","schemaVersion","taxonomyVersion"],"additionalProperties":false}},"nextCursor":{"anyOf":[{"type":"string"},{"type":"null"}]},"hasMore":{"type":"boolean"}},"required":["events","nextCursor","hasMore"],"additionalProperties":false},"coverage":{"type":"array","items":{"type":"object","properties":{"sourceSlug":{"type":"string"},"sourceName":{"type":"string"},"jurisdiction":{"type":"string","minLength":2,"maxLength":64,"pattern":"^[A-Z0-9][A-Z0-9._-]*$","description":"Stable jurisdiction code such as US-FL."},"status":{"type":"string","enum":["complete","partial","failed","unsupported","stale"]},"windowStart":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$","description":"ISO 8601 timestamp with an explicit timezone offset."},{"type":"null"}]},"windowEnd":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$","description":"ISO 8601 timestamp with an explicit timezone offset."},{"type":"null"}]},"lastSuccessfulAt":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$","description":"ISO 8601 timestamp with an explicit timezone offset."},{"type":"null"}]},"watermark":{"anyOf":[{"type":"string"},{"type":"null"}]},"recordsSeen":{"type":"integer","minimum":0,"maximum":9007199254740991},"limitations":{"type":"array","items":{"type":"string"}}},"required":["sourceSlug","sourceName","jurisdiction","status","windowStart","windowEnd","lastSuccessfulAt","watermark","recordsSeen","limitations"],"additionalProperties":false}},"meta":{"type":"object","properties":{"service":{"type":"string","const":"business-change-intelligence"},"version":{"type":"string","const":"1.0.0"},"schemaVersion":{"type":"string","const":"2026-07-22"},"taxonomyVersion":{"type":"string","const":"2026-07-22"},"dataVersion":{"type":"string"},"generatedAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$","description":"ISO 8601 timestamp with an explicit timezone offset."},"projection":{"type":"string","enum":["compact","standard","full"]}},"required":["service","version","schemaVersion","taxonomyVersion","dataVersion","generatedAt"],"additionalProperties":false}},"required":["data","coverage","meta"],"additionalProperties":false}}}},"400":{"description":"Invalid typed input or cursor."},"402":{"description":"Payment required when x402 is enabled for this route."},"503":{"description":"Database unavailable or not yet configured."}},"x-agent-tool-name":"find_business_change_leads","x-price-usd":0.1,"x-read-only":true}},"/v1/events/evidence":{"post":{"operationId":"business_changes.get_evidence","summary":"Get primary-source evidence for business events","description":"Expand selected business event IDs into dated, versioned primary-source evidence. Use after lead search to verify a small set of results before citing or acting on them.","tags":["business-changes","evidence","public-records","verification"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"eventIds":{"minItems":1,"maxItems":50,"type":"array","items":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}}},"required":["eventIds"],"additionalProperties":false}}}},"responses":{"200":{"description":"Successful evidence-backed response.","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"events":{"type":"array","items":{"type":"object","properties":{"eventId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"evidence":{"type":"array","items":{"type":"object","properties":{"evidenceId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"eventId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"sourceSlug":{"type":"string"},"sourceName":{"type":"string"},"sourceRecordId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"sourceNativeId":{"type":"string"},"recordType":{"type":"string"},"jurisdiction":{"anyOf":[{"type":"string","minLength":2,"maxLength":64,"pattern":"^[A-Z0-9][A-Z0-9._-]*$","description":"Stable jurisdiction code such as US-FL."},{"type":"null"}]},"effectiveAt":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$","description":"ISO 8601 timestamp with an explicit timezone offset."},{"type":"null"}]},"observedAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$","description":"ISO 8601 timestamp with an explicit timezone offset."},"retrievedAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$","description":"ISO 8601 timestamp with an explicit timezone offset."},"sourceUrl":{"type":"string","format":"uri"},"summary":{"type":"string"},"contentHash":{"type":"string"},"direct":{"type":"boolean"},"role":{"type":"string"}},"required":["evidenceId","eventId","sourceSlug","sourceName","sourceRecordId","sourceNativeId","recordType","jurisdiction","effectiveAt","observedAt","retrievedAt","sourceUrl","summary","contentHash","direct","role"],"additionalProperties":false}}},"required":["eventId","evidence"],"additionalProperties":false}}},"required":["events"],"additionalProperties":false},"meta":{"type":"object","properties":{"service":{"type":"string","const":"business-change-intelligence"},"version":{"type":"string","const":"1.0.0"},"schemaVersion":{"type":"string","const":"2026-07-22"},"taxonomyVersion":{"type":"string","const":"2026-07-22"},"dataVersion":{"type":"string"},"generatedAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$","description":"ISO 8601 timestamp with an explicit timezone offset."},"projection":{"type":"string","enum":["compact","standard","full"]}},"required":["service","version","schemaVersion","taxonomyVersion","dataVersion","generatedAt"],"additionalProperties":false}},"required":["data","meta"],"additionalProperties":false}}}},"400":{"description":"Invalid typed input or cursor."},"402":{"description":"Payment required when x402 is enabled for this route."},"503":{"description":"Database unavailable or not yet configured."}},"x-agent-tool-name":"get_business_event_evidence","x-price-usd":0.02,"x-read-only":true}},"/v1/locations/timeline":{"post":{"operationId":"business_changes.location_timeline","summary":"Get an exact-premise or building timeline","description":"Retrieve chronological business-change events for an exact premises or, when explicitly requested, its parent building. The response discloses match scope and preserves suite identity.","tags":["business-changes","location-intelligence","timelines","public-records"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"locationId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"address":{"type":"string","minLength":3,"maxLength":300},"city":{"type":"string","minLength":1,"maxLength":120},"regionCode":{"type":"string","minLength":2,"maxLength":16},"matchScope":{"default":"exact_premise","type":"string","enum":["exact_premise","building"]},"limit":{"default":50,"type":"integer","minimum":1,"maximum":100},"cursor":{"type":"string","minLength":1,"maxLength":512}},"required":["matchScope","limit"],"additionalProperties":false},"example":{"address":"5959 Lake Nona Blvd Ste 115","city":"Orlando","regionCode":"FL","matchScope":"exact_premise"}}}},"responses":{"200":{"description":"Successful evidence-backed response.","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"location":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"addressLine1":{"type":"string"},"subpremise":{"anyOf":[{"type":"string"},{"type":"null"}]},"city":{"type":"string"},"county":{"anyOf":[{"type":"string"},{"type":"null"}]},"regionCode":{"type":"string"},"postalCode":{"anyOf":[{"type":"string"},{"type":"null"}]},"countryCode":{"type":"string"},"latitude":{"anyOf":[{"type":"number"},{"type":"null"}]},"longitude":{"anyOf":[{"type":"number"},{"type":"null"}]},"matchScope":{"type":"string","enum":["exact_premise","building"]}},"required":["id","addressLine1","subpremise","city","county","regionCode","postalCode","countryCode","latitude","longitude","matchScope"],"additionalProperties":false},"events":{"type":"array","items":{"type":"object","properties":{"eventId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"eventType":{"type":"string","minLength":3,"maxLength":100,"pattern":"^[a-z0-9]+(?:[._-][a-z0-9]+)+$"},"intents":{"type":"array","items":{"type":"string","enum":["opening_leads","construction_activity","remodels","operator_changes","closure_risk","compliance_activity"]}},"status":{"type":"string","enum":["active","superseded","retracted"]},"headline":{"type":"string"},"explanation":{"anyOf":[{"type":"string"},{"type":"null"}]},"effectiveAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$","description":"ISO 8601 timestamp with an explicit timezone offset."},"firstObservedAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$","description":"ISO 8601 timestamp with an explicit timezone offset."},"lastObservedAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$","description":"ISO 8601 timestamp with an explicit timezone offset."},"jurisdiction":{"type":"string","minLength":2,"maxLength":64,"pattern":"^[A-Z0-9][A-Z0-9._-]*$","description":"Stable jurisdiction code such as US-FL."},"organization":{"anyOf":[{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"name":{"type":"string"}},"required":["id","name"],"additionalProperties":false},{"type":"null"}]},"brand":{"anyOf":[{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"name":{"type":"string"}},"required":["id","name"],"additionalProperties":false},{"type":"null"}]},"establishmentId":{"anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"null"}]},"location":{"anyOf":[{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"addressLine1":{"type":"string"},"subpremise":{"anyOf":[{"type":"string"},{"type":"null"}]},"city":{"type":"string"},"county":{"anyOf":[{"type":"string"},{"type":"null"}]},"regionCode":{"type":"string"},"postalCode":{"anyOf":[{"type":"string"},{"type":"null"}]},"countryCode":{"type":"string"},"latitude":{"anyOf":[{"type":"number"},{"type":"null"}]},"longitude":{"anyOf":[{"type":"number"},{"type":"null"}]},"matchScope":{"type":"string","enum":["exact_premise","building"]}},"required":["id","addressLine1","subpremise","city","county","regionCode","postalCode","countryCode","latitude","longitude","matchScope"],"additionalProperties":false},{"type":"null"}]},"industries":{"type":"array","items":{"type":"string"}},"confidence":{"type":"object","properties":{"classification":{"type":"number","minimum":0,"maximum":1},"identityResolution":{"anyOf":[{"type":"number","minimum":0,"maximum":1},{"type":"null"}]},"publicStatus":{"anyOf":[{"type":"number","minimum":0,"maximum":1},{"type":"null"}]},"evidenceStrength":{"type":"string","enum":["weak","moderate","strong","authoritative"]},"derivationVersion":{"type":"string"}},"required":["classification","identityResolution","publicStatus","evidenceStrength","derivationVersion"],"additionalProperties":false},"evidence":{"type":"object","properties":{"count":{"type":"integer","minimum":0,"maximum":9007199254740991},"strongestSource":{"anyOf":[{"type":"string"},{"type":"null"}]},"sourceTypes":{"type":"array","items":{"type":"string"}}},"required":["count","strongestSource","sourceTypes"],"additionalProperties":false},"publicStatus":{"anyOf":[{"type":"object","properties":{"status":{"type":"string","enum":["announced","preparing_to_open","publicly_listed","open_confirmed","temporarily_closed","permanently_closed"]},"observedAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$","description":"ISO 8601 timestamp with an explicit timezone offset."},"sourceRecordId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"sourceUrl":{"type":"string","format":"uri"},"summary":{"type":"string"}},"required":["status","observedAt","sourceRecordId","sourceUrl","summary"],"additionalProperties":false},{"type":"null"}]},"schemaVersion":{"type":"string"},"taxonomyVersion":{"type":"string"}},"required":["eventId","eventType","intents","status","headline","explanation","effectiveAt","firstObservedAt","lastObservedAt","jurisdiction","organization","brand","establishmentId","location","industries","confidence","evidence","publicStatus","schemaVersion","taxonomyVersion"],"additionalProperties":false}},"nextCursor":{"anyOf":[{"type":"string"},{"type":"null"}]},"hasMore":{"type":"boolean"}},"required":["location","events","nextCursor","hasMore"],"additionalProperties":false},"coverage":{"type":"array","items":{"type":"object","properties":{"sourceSlug":{"type":"string"},"sourceName":{"type":"string"},"jurisdiction":{"type":"string","minLength":2,"maxLength":64,"pattern":"^[A-Z0-9][A-Z0-9._-]*$","description":"Stable jurisdiction code such as US-FL."},"status":{"type":"string","enum":["complete","partial","failed","unsupported","stale"]},"windowStart":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$","description":"ISO 8601 timestamp with an explicit timezone offset."},{"type":"null"}]},"windowEnd":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$","description":"ISO 8601 timestamp with an explicit timezone offset."},{"type":"null"}]},"lastSuccessfulAt":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$","description":"ISO 8601 timestamp with an explicit timezone offset."},{"type":"null"}]},"watermark":{"anyOf":[{"type":"string"},{"type":"null"}]},"recordsSeen":{"type":"integer","minimum":0,"maximum":9007199254740991},"limitations":{"type":"array","items":{"type":"string"}}},"required":["sourceSlug","sourceName","jurisdiction","status","windowStart","windowEnd","lastSuccessfulAt","watermark","recordsSeen","limitations"],"additionalProperties":false}},"meta":{"type":"object","properties":{"service":{"type":"string","const":"business-change-intelligence"},"version":{"type":"string","const":"1.0.0"},"schemaVersion":{"type":"string","const":"2026-07-22"},"taxonomyVersion":{"type":"string","const":"2026-07-22"},"dataVersion":{"type":"string"},"generatedAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$","description":"ISO 8601 timestamp with an explicit timezone offset."},"projection":{"type":"string","enum":["compact","standard","full"]}},"required":["service","version","schemaVersion","taxonomyVersion","dataVersion","generatedAt"],"additionalProperties":false}},"required":["data","coverage","meta"],"additionalProperties":false}}}},"400":{"description":"Invalid typed input or cursor."},"402":{"description":"Payment required when x402 is enabled for this route."},"503":{"description":"Database unavailable or not yet configured."}},"x-agent-tool-name":"get_location_timeline","x-price-usd":0.03,"x-read-only":true}},"/v1/changes":{"post":{"operationId":"business_changes.changes_since","summary":"Get business changes observed since a cursor","description":"Poll a compact, stable delta feed of events first observed since a timestamp or prior cursor, including superseded and retracted events. Use for recurring research and monitoring agents.","tags":["business-changes","change-feed","monitoring","research"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"cursor":{"type":"string","minLength":1,"maxLength":512},"observedAfter":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$","description":"ISO 8601 timestamp with an explicit timezone offset."},"jurisdictions":{"minItems":1,"maxItems":25,"type":"array","items":{"type":"string","minLength":2,"maxLength":64,"pattern":"^[A-Z0-9][A-Z0-9._-]*$","description":"Stable jurisdiction code such as US-FL."}},"intents":{"minItems":1,"maxItems":6,"type":"array","items":{"type":"string","enum":["opening_leads","construction_activity","remodels","operator_changes","closure_risk","compliance_activity"]}},"minEvidenceStrength":{"default":"strong","type":"string","enum":["weak","moderate","strong","authoritative"]},"minClassificationConfidence":{"default":0.75,"type":"number","minimum":0,"maximum":1},"projection":{"default":"compact","type":"string","enum":["compact","standard","full"]},"limit":{"default":50,"type":"integer","minimum":1,"maximum":100}},"required":["minEvidenceStrength","minClassificationConfidence","projection","limit"],"additionalProperties":false},"example":{"observedAfter":"2026-07-01T00:00:00.000Z","limit":50}}}},"responses":{"200":{"description":"Successful evidence-backed response.","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"events":{"type":"array","items":{"type":"object","properties":{"eventId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"eventType":{"type":"string","minLength":3,"maxLength":100,"pattern":"^[a-z0-9]+(?:[._-][a-z0-9]+)+$"},"intents":{"type":"array","items":{"type":"string","enum":["opening_leads","construction_activity","remodels","operator_changes","closure_risk","compliance_activity"]}},"status":{"type":"string","enum":["active","superseded","retracted"]},"headline":{"type":"string"},"explanation":{"anyOf":[{"type":"string"},{"type":"null"}]},"effectiveAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$","description":"ISO 8601 timestamp with an explicit timezone offset."},"firstObservedAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$","description":"ISO 8601 timestamp with an explicit timezone offset."},"lastObservedAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$","description":"ISO 8601 timestamp with an explicit timezone offset."},"jurisdiction":{"type":"string","minLength":2,"maxLength":64,"pattern":"^[A-Z0-9][A-Z0-9._-]*$","description":"Stable jurisdiction code such as US-FL."},"organization":{"anyOf":[{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"name":{"type":"string"}},"required":["id","name"],"additionalProperties":false},{"type":"null"}]},"brand":{"anyOf":[{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"name":{"type":"string"}},"required":["id","name"],"additionalProperties":false},{"type":"null"}]},"establishmentId":{"anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"null"}]},"location":{"anyOf":[{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"addressLine1":{"type":"string"},"subpremise":{"anyOf":[{"type":"string"},{"type":"null"}]},"city":{"type":"string"},"county":{"anyOf":[{"type":"string"},{"type":"null"}]},"regionCode":{"type":"string"},"postalCode":{"anyOf":[{"type":"string"},{"type":"null"}]},"countryCode":{"type":"string"},"latitude":{"anyOf":[{"type":"number"},{"type":"null"}]},"longitude":{"anyOf":[{"type":"number"},{"type":"null"}]},"matchScope":{"type":"string","enum":["exact_premise","building"]}},"required":["id","addressLine1","subpremise","city","county","regionCode","postalCode","countryCode","latitude","longitude","matchScope"],"additionalProperties":false},{"type":"null"}]},"industries":{"type":"array","items":{"type":"string"}},"confidence":{"type":"object","properties":{"classification":{"type":"number","minimum":0,"maximum":1},"identityResolution":{"anyOf":[{"type":"number","minimum":0,"maximum":1},{"type":"null"}]},"publicStatus":{"anyOf":[{"type":"number","minimum":0,"maximum":1},{"type":"null"}]},"evidenceStrength":{"type":"string","enum":["weak","moderate","strong","authoritative"]},"derivationVersion":{"type":"string"}},"required":["classification","identityResolution","publicStatus","evidenceStrength","derivationVersion"],"additionalProperties":false},"evidence":{"type":"object","properties":{"count":{"type":"integer","minimum":0,"maximum":9007199254740991},"strongestSource":{"anyOf":[{"type":"string"},{"type":"null"}]},"sourceTypes":{"type":"array","items":{"type":"string"}}},"required":["count","strongestSource","sourceTypes"],"additionalProperties":false},"publicStatus":{"anyOf":[{"type":"object","properties":{"status":{"type":"string","enum":["announced","preparing_to_open","publicly_listed","open_confirmed","temporarily_closed","permanently_closed"]},"observedAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$","description":"ISO 8601 timestamp with an explicit timezone offset."},"sourceRecordId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"sourceUrl":{"type":"string","format":"uri"},"summary":{"type":"string"}},"required":["status","observedAt","sourceRecordId","sourceUrl","summary"],"additionalProperties":false},{"type":"null"}]},"schemaVersion":{"type":"string"},"taxonomyVersion":{"type":"string"}},"required":["eventId","eventType","intents","status","headline","explanation","effectiveAt","firstObservedAt","lastObservedAt","jurisdiction","organization","brand","establishmentId","location","industries","confidence","evidence","publicStatus","schemaVersion","taxonomyVersion"],"additionalProperties":false}},"nextCursor":{"anyOf":[{"type":"string"},{"type":"null"}]},"hasMore":{"type":"boolean"}},"required":["events","nextCursor","hasMore"],"additionalProperties":false},"coverage":{"type":"array","items":{"type":"object","properties":{"sourceSlug":{"type":"string"},"sourceName":{"type":"string"},"jurisdiction":{"type":"string","minLength":2,"maxLength":64,"pattern":"^[A-Z0-9][A-Z0-9._-]*$","description":"Stable jurisdiction code such as US-FL."},"status":{"type":"string","enum":["complete","partial","failed","unsupported","stale"]},"windowStart":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$","description":"ISO 8601 timestamp with an explicit timezone offset."},{"type":"null"}]},"windowEnd":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$","description":"ISO 8601 timestamp with an explicit timezone offset."},{"type":"null"}]},"lastSuccessfulAt":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$","description":"ISO 8601 timestamp with an explicit timezone offset."},{"type":"null"}]},"watermark":{"anyOf":[{"type":"string"},{"type":"null"}]},"recordsSeen":{"type":"integer","minimum":0,"maximum":9007199254740991},"limitations":{"type":"array","items":{"type":"string"}}},"required":["sourceSlug","sourceName","jurisdiction","status","windowStart","windowEnd","lastSuccessfulAt","watermark","recordsSeen","limitations"],"additionalProperties":false}},"meta":{"type":"object","properties":{"service":{"type":"string","const":"business-change-intelligence"},"version":{"type":"string","const":"1.0.0"},"schemaVersion":{"type":"string","const":"2026-07-22"},"taxonomyVersion":{"type":"string","const":"2026-07-22"},"dataVersion":{"type":"string"},"generatedAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$","description":"ISO 8601 timestamp with an explicit timezone offset."},"projection":{"type":"string","enum":["compact","standard","full"]}},"required":["service","version","schemaVersion","taxonomyVersion","dataVersion","generatedAt"],"additionalProperties":false}},"required":["data","coverage","meta"],"additionalProperties":false}}}},"400":{"description":"Invalid typed input or cursor."},"402":{"description":"Payment required when x402 is enabled for this route."},"503":{"description":"Database unavailable or not yet configured."}},"x-agent-tool-name":"get_changes_since","x-price-usd":0.05,"x-read-only":true}},"/v1/coverage":{"post":{"operationId":"business_changes.coverage","summary":"Inspect source and jurisdiction coverage","description":"Inspect supported sources, jurisdictions, freshness, successful collection windows, and known limitations before interpreting a result or no-match.","tags":["business-changes","coverage","freshness","public-records"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"jurisdictions":{"minItems":1,"maxItems":50,"type":"array","items":{"type":"string","minLength":2,"maxLength":64,"pattern":"^[A-Z0-9][A-Z0-9._-]*$","description":"Stable jurisdiction code such as US-FL."}},"sourceSlugs":{"minItems":1,"maxItems":50,"type":"array","items":{"type":"string","minLength":1,"maxLength":100}},"includeInactive":{"default":false,"type":"boolean"}},"required":["includeInactive"],"additionalProperties":false},"example":{"jurisdictions":["US-FL"]}}}},"responses":{"200":{"description":"Successful evidence-backed response.","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"coverage":{"type":"array","items":{"type":"object","properties":{"sourceSlug":{"type":"string"},"sourceName":{"type":"string"},"jurisdiction":{"type":"string","minLength":2,"maxLength":64,"pattern":"^[A-Z0-9][A-Z0-9._-]*$","description":"Stable jurisdiction code such as US-FL."},"status":{"type":"string","enum":["complete","partial","failed","unsupported","stale"]},"windowStart":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$","description":"ISO 8601 timestamp with an explicit timezone offset."},{"type":"null"}]},"windowEnd":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$","description":"ISO 8601 timestamp with an explicit timezone offset."},{"type":"null"}]},"lastSuccessfulAt":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$","description":"ISO 8601 timestamp with an explicit timezone offset."},{"type":"null"}]},"watermark":{"anyOf":[{"type":"string"},{"type":"null"}]},"recordsSeen":{"type":"integer","minimum":0,"maximum":9007199254740991},"limitations":{"type":"array","items":{"type":"string"}}},"required":["sourceSlug","sourceName","jurisdiction","status","windowStart","windowEnd","lastSuccessfulAt","watermark","recordsSeen","limitations"],"additionalProperties":false}}},"required":["coverage"],"additionalProperties":false},"meta":{"type":"object","properties":{"service":{"type":"string","const":"business-change-intelligence"},"version":{"type":"string","const":"1.0.0"},"schemaVersion":{"type":"string","const":"2026-07-22"},"taxonomyVersion":{"type":"string","const":"2026-07-22"},"dataVersion":{"type":"string"},"generatedAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$","description":"ISO 8601 timestamp with an explicit timezone offset."},"projection":{"type":"string","enum":["compact","standard","full"]}},"required":["service","version","schemaVersion","taxonomyVersion","dataVersion","generatedAt"],"additionalProperties":false}},"required":["data","meta"],"additionalProperties":false}}}},"400":{"description":"Invalid typed input or cursor."},"402":{"description":"Payment required when x402 is enabled for this route."},"503":{"description":"Database unavailable or not yet configured."}},"x-agent-tool-name":"get_business_change_coverage","x-price-usd":0,"x-read-only":true}}},"components":{"securitySchemes":{"apiKey":{"type":"apiKey","in":"header","name":"Authorization"},"x402":{"type":"apiKey","in":"header","name":"PAYMENT-SIGNATURE","description":"x402 v2 payment signature for autonomous pay-per-call access."}}},"x-platform":{"schemaVersion":"2026-07-22","taxonomyVersion":"2026-07-22","mcp":"https://api.businesschanges.dev/mcp","capabilities":"https://api.businesschanges.dev/.well-known/agent-capabilities.json","llms":"https://businesschanges.dev/llms.txt"}}