{"uid":"cap_2arAd1Z9WKzfAcHGbts1z","slug":"business-change-intelligence-api-location-timeline-d2da34eb","name":"Business Change Intelligence API – Location 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.","url":"https://api.businesschanges.dev/v1/locations/timeline","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"city":{"type":"string","maxLength":120,"minLength":1},"limit":{"type":"integer","default":50,"maximum":100,"minimum":1},"cursor":{"type":"string","maxLength":512,"minLength":1},"address":{"type":"string","maxLength":300,"minLength":3},"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)$"},"matchScope":{"enum":["exact_premise","building"],"type":"string","default":"exact_premise"},"regionCode":{"type":"string","maxLength":16,"minLength":2}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.03","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.03/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.03","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.03","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_F6kgLobZkR74Qoe8VbFK2","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.03","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Retrieves a chronological list of business-change events for a specific address or building, returning match scope metadata and suite-level identity.","exampleAgentPrompt":"Pull the full business-change timeline for 450 Mission Street, San Francisco, CA — match on the exact premise and give me up to 100 events.","exampleUseCases":[{"title":"Commercial real estate tenant due diligence","prompt":"Give me the complete history of business changes at 1600 Amphitheatre Pkwy, Mountain View, CA — I want to see every tenant event at the exact premise, up to 100 results."},{"title":"Sales prospecting for recently vacated storefronts","prompt":"Show me the business-change timeline for the building at 200 Park Ave, New York, NY — match at the building level so I can see all suite activity, limit to 50 events."},{"title":"Market research on neighborhood business turnover","prompt":"I need the chronological business events for 800 N Michigan Ave, Chicago, IL — exact premise match, first 100 events — so I can analyze how often tenants change here."}],"resultDescription":"An ordered list of business-change events for the queried premises, each event including a timestamp, event type, business identity, and suite information. The response also indicates the match scope used (exact_premise or building) and provides a pagination cursor for fetching subsequent pages.","failureModes":["Address not found or unresolvable — returns empty event list or 404","Invalid UUID format for locationId — returns 400 validation error","matchScope 'building' requested without sufficient address specificity — may return broader or no results","cursor value expired or malformed — returns 400 or restarts pagination","Limit exceeds 100 — returns 400 validation error","regionCode or city missing when address is ambiguous — may reduce match accuracy"],"whenToPreferThis":"Choose this endpoint when you need the full ordered history of business-change events at a specific address or building, especially when suite-level identity matters. It is the right choice for due diligence, tenant history research, sales prospecting on location activity, or any workflow that needs paginated chronological event data tied to a physical premises. Use the sibling delta-feed endpoint instead if you only need changes since a prior sync point.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T00:38:21.679Z","isFirstParty":false}