overlay: 1.0.0
info:
  title: API Evangelist enhancements for Zoopla Leads API
  version: 1.0.0
extends: openapi/zoopla-leads-api-openapi.json
x-apievangelist:
  generated: '2026-07-26'
  method: generated
  source: derived from the harvested spec plus the searched artifacts in this repo
  note: Additive only. Records what API Evangelist established about this contract; the harvested spec is never
    mutated.
actions:
- target: $.info
  update:
    x-apievangelist-provider: alto-vebra
    x-apievangelist-generated: '2026-07-26'
    x-apievangelist-artifacts:
      authentication: authentication/alto-vebra-authentication.yml
      scopes: scopes/alto-vebra-scopes.yml
      conventions: conventions/alto-vebra-conventions.yml
      errors: errors/alto-vebra-problem-types.yml
      lifecycle: lifecycle/alto-vebra-lifecycle.yml
      conformance: conformance/alto-vebra-conformance.yml
      sandbox: sandbox/alto-vebra-sandbox.yml
      data_model: data-model/alto-vebra-data-model.yml
    x-apievangelist-access:
      gate: partner-only
      self_serve_signup: false
      note: The contract is anonymous and public; credentials require a Vebra Solutions contract, an integration
        registered in Alto Connect and per-agency activation.
    x-apievangelist-rate-limits:
      published_quota: null
      signal: 429 "service busy"
      headers: null
      remediation: Cache the access token for its full 3600s expiry and retry after a wait.
    x-apievangelist-retention:
      lead_retention: 30 days
      default_window: last 24 hours
    x-apievangelist-events:
      asyncapi: asyncapi/alto-vebra-zoopla-leads-push-asyncapi.yml
      note: A push service delivers the identical payload in real time; this polled API is the recovery path.