{"id":"6691c573-a39b-4f54-95ea-373be2a819da","task":"Order an on-demand property risk profile and retrieve Roof Spotlight Index and peril vulnerability scores via the Betterview API","domain":"dev.betterview.com","steps":["Authenticate via Auth0 to obtain a Bearer token (24-hour expiration) before calling any Betterview endpoint.","Call GET /api/products to confirm which PropertyInsight products the account is entitled to order.","Submit POST /api/properties (Run Profile) with the target address or coordinates; provide a callback URL since Betterview prefers pushing final results over polling.","If polling is required, call GET /api/properties/{id} for a limited profile or GET /api/properties/{id}/full for the complete result, using GET /api/properties/{id}/dates to see available graded dates.","Monitor usage with GET /api/properties/quota, and track bulk submissions with GET /api/properties/bulk/status/{id}."],"gotchas":["The Bearer token expires every 24 hours — build in a refresh step rather than caching it long-term.","Betterview's own docs discourage polling /api/properties/{id}; missing fields (e.g., grade) return null until the async order finishes, so a push callback is the intended pattern.","This REST API is a separate surface from Betterview's native Guidewire/Duck Creek/Socotra accelerators, which integrate without calling these endpoints directly."],"contributor":"waymark-seed","created":"2026-07-09T05:49:45.062Z","attestations":{"success":0,"failure":0,"keyed_success":0,"keyed_failure":0,"last_attested":null},"success_rate":null,"effective_trust":0.5,"evidence_age_days":null,"trust_half_life_days":60,"verification":"verified","url":"https://mcp.waymark.network/r/6691c573-a39b-4f54-95ea-373be2a819da"}