{"openapi":"3.1.0","info":{"title":"DateHog Real Estate Transaction API","description":"Authenticated connector endpoints for extracting and organizing supported Washington real estate contract deadlines, listing a user's saved deals, and retrieving payment support information. DateHog outputs must be verified against the signed agreement and written modifications.","version":"1.0.0","contact":{"email":"support@datehog.com","url":"https://datehog.com"}},"servers":[{"url":"https://datehog.com","description":"DateHog Live Server"}],"paths":{"/api/connector/parse":{"post":{"operationId":"parseAndSyncContract","summary":"Parse real estate contract and sync contingency deadlines to calendar","description":"Extracts transaction milestones from supplied purchase-agreement text, applies supported Washington computation-of-time rules, enforces the user's deal allowance, and returns calendar and client-portal actions. The responsible real estate professional must verify every result.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"contract_text":{"type":"string","description":"The full text or key terms of the signed real estate purchase and sale agreement (Form 21, PSA, Addenda)."},"property_address":{"type":"string","description":"Optional property address. If omitted, DateHog extracts it from the contract text."},"state_code":{"type":"string","default":"WA","description":"Two-letter US state code (default: 'WA' for Washington State)."}},"required":["contract_text"]}}}},"responses":{"200":{"description":"Successfully parsed contract deadlines and generated calendar feed","content":{"application/json":{"schema":{"type":"object","properties":{"property_address":{"type":"string"},"mutual_acceptance_date":{"type":"string"},"closing_date":{"type":"string"},"events":{"type":"array","items":{"type":"object","properties":{"event_name":{"type":"string"},"target_date":{"type":"string"},"legal_cutoff":{"type":"string"},"description":{"type":"string"}}}},"calendar_sync":{"type":"object","properties":{"webcal_url":{"type":"string"},"google_calendar_url":{"type":"string"},"download_ics_url":{"type":"string"}}},"client_portal_url":{"type":"string"},"quota":{"type":"object","properties":{"deals_count":{"type":"integer"},"is_free_deal":{"type":"boolean"},"requires_payment":{"type":"boolean"},"checkout_url":{"type":"string"}}}}}}}}}}},"/api/connector/deals":{"get":{"operationId":"listActiveDeals","summary":"List agent's active transactions and upcoming contingency deadlines","description":"Fetches all current escrow deals for the authenticated agent, including inspection, earnest money, and closing dates.","responses":{"200":{"description":"List of active transactions","content":{"application/json":{"schema":{"type":"object","properties":{"deals":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"property_address":{"type":"string"},"closing_date":{"type":"string"},"events_count":{"type":"integer"},"portal_url":{"type":"string"}}}}}}}}}}}},"/api/connector/checkout":{"post":{"operationId":"createCheckoutUrl","summary":"Get payment-support information","description":"Returns the DateHog support address for payment questions. Online checkout is not currently available.","security":[],"responses":{"200":{"description":"Payment-support information returned","content":{"application/json":{"schema":{"type":"object","properties":{"checkout_url":{"type":"string"},"support_email":{"type":"string","format":"email"},"online_payments_available":{"type":"boolean"},"description":{"type":"string"}}}}}}}}}},"components":{"securitySchemes":{"oauth2":{"type":"oauth2","description":"OAuth 2.1 authorization-code flow with PKCE. DateHog validates the resulting Supabase access token for every protected operation.","flows":{"authorizationCode":{"authorizationUrl":"https://lojnhgukeckdgskssqjk.supabase.co/auth/v1/oauth/authorize","tokenUrl":"https://lojnhgukeckdgskssqjk.supabase.co/auth/v1/oauth/token","scopes":{"openid":"Identify the signed-in DateHog user","email":"Read the account email address","profile":"Read basic DateHog profile information","offline_access":"Refresh access without requiring another sign-in"}}}}}},"security":[{"oauth2":["openid","email","profile"]}]}