{"openapi":"3.0.1","info":{"title":"iGaming Finder API","version":"v1","description":"Public API for iGaming company, license, domain, signal, logo, Brief, export, and account data."},"components":{"schemas":{"ErrorEnvelope":{"type":"object","additionalProperties":false,"required":["success","message","errors","doc_url","timestamp"],"properties":{"success":{"type":"boolean"},"message":{"type":"string"},"errors":{"type":"object","additionalProperties":true},"doc_url":{"type":"string","nullable":true},"timestamp":{"type":"string","format":"date-time"}}},"DomainEntry":{"type":"object","additionalProperties":false,"required":["domain_ref","domain","inferred_geo"],"properties":{"domain_ref":{"type":"string","nullable":true},"domain":{"type":"string"},"inferred_geo":{"type":"string","nullable":true}}},"FirmographicsResult":{"type":"object","additionalProperties":false,"required":["domain","available","cached","stale","reason","fetched_at","refresh","data"],"properties":{"domain":{"$ref":"#/components/schemas/DomainEntry"},"available":{"type":"boolean"},"cached":{"type":"boolean"},"stale":{"type":"boolean"},"reason":{"type":"string","enum":["not_resolved","source_temporarily_unavailable","source_unavailable","response_too_large"],"nullable":true},"fetched_at":{"type":"string","format":"date-time","nullable":true},"refresh":{"type":"object","additionalProperties":false,"required":["attempted","status","reason","attempted_at"],"properties":{"attempted":{"type":"boolean"},"status":{"type":"string","enum":["not_attempted","completed","failed"]},"reason":{"type":"string","enum":["not_resolved","source_temporarily_unavailable","source_unavailable","response_too_large"],"nullable":true},"attempted_at":{"type":"string","format":"date-time","nullable":true}}},"data":{"type":"object","additionalProperties":false,"required":["name","description","industry","company_size","employee_count","founded_year","headquarters","website","linkedin_url"],"properties":{"name":{"type":"string","nullable":true},"description":{"type":"string","nullable":true},"industry":{"type":"string","nullable":true},"company_size":{"type":"array","items":{"type":"integer"},"nullable":true},"employee_count":{"type":"integer","nullable":true},"founded_year":{"type":"integer","nullable":true},"headquarters":{"type":"object","additionalProperties":false,"required":["city","region","country","postal_code"],"properties":{"city":{"type":"string","nullable":true},"region":{"type":"string","nullable":true},"country":{"type":"string","nullable":true},"postal_code":{"type":"string","nullable":true}},"nullable":true},"website":{"type":"string","nullable":true},"linkedin_url":{"type":"string","nullable":true}},"nullable":true}}},"CompanyProfile":{"type":"object","additionalProperties":false,"required":["company_ref","company_name","legal_entity","subject_kind","role","country","matched_as","brands","domains","licenses","apps","payment_methods","payment_categories","supplier_brands","platform_brands","affiliate_program","geo_hints","evidence_routes","data_completeness","last_observed_at","last_updated_at"],"properties":{"company_ref":{"type":"string"},"company_name":{"type":"string","nullable":true},"legal_entity":{"type":"string","nullable":true},"subject_kind":{"type":"string","enum":["legal_entity","trade_name","platform","domain","unknown"]},"role":{"type":"array","items":{"type":"string","enum":["operator","aggregator","platform_provider","payment_provider","game_studio","affiliate_software","affiliate_media","other_supplier","unknown"]}},"country":{"type":"string","nullable":true},"matched_as":{"type":"array","items":{"type":"string"}},"brands":{"type":"array","items":{"type":"string"}},"domains":{"type":"array","items":{"$ref":"#/components/schemas/DomainEntry"}},"licenses":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["license_ref","jurisdiction","license_number","status","license_type","authorized_domains"],"properties":{"license_ref":{"type":"string"},"jurisdiction":{"type":"string","nullable":true},"license_number":{"type":"string","nullable":true},"status":{"type":"string","nullable":true},"license_type":{"type":"string","nullable":true},"authorized_domains":{"type":"array","items":{"$ref":"#/components/schemas/DomainEntry"}}}}},"apps":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["store","app_id","url"],"properties":{"store":{"type":"string","enum":["google_play","app_store"]},"app_id":{"type":"string"},"url":{"type":"string"}}}},"payment_methods":{"type":"array","items":{"type":"string"}},"payment_categories":{"type":"array","items":{"type":"string"}},"supplier_brands":{"type":"array","items":{"type":"string"}},"platform_brands":{"type":"array","items":{"type":"string"}},"affiliate_program":{"type":"boolean"},"geo_hints":{"type":"array","items":{"type":"string"}},"evidence_routes":{"type":"array","items":{"type":"string"}},"data_completeness":{"type":"number"},"last_observed_at":{"type":"string","format":"date-time","nullable":true},"last_updated_at":{"type":"string","format":"date-time","nullable":true},"firmographics":{"type":"array","items":{"$ref":"#/components/schemas/FirmographicsResult"}}}},"DomainVerdict":{"type":"object","additionalProperties":false,"required":["domain","verdict","licensed_by","blocked_by","company","billing","observations"],"properties":{"domain":{"type":"string"},"verdict":{"type":"string","enum":["licensed","blocklisted","mixed","no_record"]},"licensed_by":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["geo","license_number"],"properties":{"geo":{"type":"string"},"license_number":{"type":"string","nullable":true}}}},"blocked_by":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["geo"],"properties":{"geo":{"type":"string"}}}},"company":{"type":"object","additionalProperties":false,"required":["company_ref","name"],"properties":{"company_ref":{"type":"string"},"name":{"type":"string"}},"nullable":true},"billing":{"type":"object","additionalProperties":false,"required":["returned_count","credits_charged","billing_reason","breakdown"],"properties":{"returned_count":{"type":"integer"},"credits_per_verdict":{"type":"integer"},"credits_charged":{"type":"integer"},"billing_reason":{"type":"string"},"max_credits":{"type":"integer","nullable":true},"page_size":{"type":"integer","nullable":true},"breakdown":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["key","units","credits_per_unit","credits_charged"],"properties":{"key":{"type":"string","enum":["domain.verdict","domain.operator_launch_profile"]},"units":{"type":"integer"},"credits_per_unit":{"type":"integer"},"credits_charged":{"type":"integer"}}}}}},"observations":{"type":"object","additionalProperties":true,"properties":{"operator_launch_profile":{"type":"object","additionalProperties":false,"required":["availability","reason","domain","observed_at","regulatory_context","registration","dns","web_presence","launch","legal_claims","public_contacts","related_domains","quality","coverage","evidence"],"properties":{"availability":{"type":"string","enum":["available","not_available"]},"reason":{"type":"string","nullable":true},"domain":{"type":"string"},"observed_at":{"type":"string","format":"date-time","nullable":true},"regulatory_context":{"type":"object","additionalProperties":false,"required":["market","license_ref","license_number","licensee","authorized_domain"],"properties":{"market":{"type":"string"},"license_ref":{"type":"string"},"license_number":{"type":"string"},"licensee":{"type":"object","additionalProperties":false,"required":["company_ref","legal_name"],"properties":{"company_ref":{"type":"string"},"legal_name":{"type":"string"}}},"authorized_domain":{"type":"boolean"}},"nullable":true},"registration":{"type":"object","additionalProperties":false,"required":["observation_status","registrar","registered_at","updated_at","expires_at","domain_statuses","registrant","evidence_refs"],"properties":{"observation_status":{"type":"string","enum":["observed","not_available"]},"registrar":{"type":"string","nullable":true},"registered_at":{"type":"string","format":"date-time","nullable":true},"updated_at":{"type":"string","format":"date-time","nullable":true},"expires_at":{"type":"string","format":"date-time","nullable":true},"domain_statuses":{"type":"array","items":{"type":"string"}},"registrant":{"type":"object","additionalProperties":false,"required":["disclosure_status","name","organization","country_code"],"properties":{"disclosure_status":{"type":"string","enum":["public","redacted","unavailable"]},"name":{"type":"string","nullable":true},"organization":{"type":"string","nullable":true},"country_code":{"type":"string","nullable":true}}},"evidence_refs":{"type":"array","items":{"type":"string"}}},"nullable":true},"dns":{"type":"object","additionalProperties":false,"required":["observation_status","records","fingerprints","evidence_refs"],"properties":{"observation_status":{"type":"string","enum":["observed","not_available"]},"records":{"type":"object","additionalProperties":false,"required":["a","aaaa","ns","mx"],"properties":{"a":{"type":"array","items":{"type":"string"}},"aaaa":{"type":"array","items":{"type":"string"}},"ns":{"type":"array","items":{"type":"string"}},"mx":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["priority","host"],"properties":{"priority":{"type":"integer"},"host":{"type":"string"}}}}}},"fingerprints":{"type":"object","additionalProperties":false,"required":["nameservers","mail","hosting"],"properties":{"nameservers":{"type":"string","nullable":true},"mail":{"type":"string","nullable":true},"hosting":{"type":"string","nullable":true}}},"evidence_refs":{"type":"array","items":{"type":"string"}}},"nullable":true},"web_presence":{"type":"object","additionalProperties":false,"required":["observation_status","status","requested_url","final_url","redirect_chain","http_status","title","parked","legal_pages","evidence_refs"],"properties":{"observation_status":{"type":"string","enum":["observed","not_available"]},"status":{"type":"string","enum":["live","parked","blocked","offline","unknown"]},"requested_url":{"type":"string"},"final_url":{"type":"string","nullable":true},"redirect_chain":{"type":"array","items":{"type":"string"}},"http_status":{"type":"integer","nullable":true},"title":{"type":"string","nullable":true},"parked":{"type":"boolean"},"legal_pages":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["page_type","url"],"properties":{"page_type":{"type":"string"},"url":{"type":"string"}}}},"evidence_refs":{"type":"array","items":{"type":"string"}}},"nullable":true},"launch":{"type":"object","additionalProperties":false,"required":["status","confidence","reasons","observed_at"],"properties":{"status":{"type":"string","enum":["pre_launch","launching","live","unknown"]},"confidence":{"type":"string","enum":["low","medium","high"]},"reasons":{"type":"array","items":{"type":"string"}},"observed_at":{"type":"string","format":"date-time","nullable":true}},"nullable":true},"legal_claims":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["claim_type","claimed_name","company_registration_number","license_number","registered_address","match","evidence_text","evidence_refs"],"properties":{"claim_type":{"type":"string","enum":["owner","operator","billing_agent","data_controller","licensee"]},"claimed_name":{"type":"string"},"company_registration_number":{"type":"string","nullable":true},"license_number":{"type":"string","nullable":true},"registered_address":{"type":"string","nullable":true},"match":{"type":"object","additionalProperties":false,"required":["status","matched_company_ref","matched_as","confidence","reasons"],"properties":{"status":{"type":"string","enum":["unresolved","matched","conflict"]},"matched_company_ref":{"type":"string","nullable":true},"matched_as":{"type":"string","nullable":true},"confidence":{"type":"string","enum":["low","medium","high"]},"reasons":{"type":"array","items":{"type":"string"}}}},"evidence_text":{"type":"string"},"evidence_refs":{"type":"array","items":{"type":"string"}}}}},"public_contacts":{"type":"object","additionalProperties":false,"required":["observation_status","items"],"properties":{"observation_status":{"type":"string","enum":["observed","not_observed"]},"items":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["type","value","source"],"properties":{"type":{"type":"string","enum":["email"]},"value":{"type":"string"},"source":{"type":"string","enum":["website"]}}}}}},"related_domains":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["domain","relationship","confidence","reasons","ownership_claimed","evidence_refs"],"properties":{"domain":{"type":"string"},"relationship":{"type":"string"},"confidence":{"type":"string","enum":["low","medium","high"]},"reasons":{"type":"array","items":{"type":"string"}},"ownership_claimed":{"type":"boolean"},"evidence_refs":{"type":"array","items":{"type":"string"}}}}},"quality":{"type":"object","additionalProperties":false,"required":["confidence","source_count","warnings"],"properties":{"confidence":{"type":"string","enum":["low","medium","high"]},"source_count":{"type":"integer"},"warnings":{"type":"array","items":{"type":"string"}}}},"coverage":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["component","status","reason"],"properties":{"component":{"type":"string"},"status":{"type":"string","enum":["included","available","not_available","not_requested"]},"reason":{"type":"string","nullable":true}}}},"evidence":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["evidence_ref","source_type","source_url","observed_at"],"properties":{"evidence_ref":{"type":"string"},"source_type":{"type":"string","enum":["rdap","dns","site_scrape"]},"source_url":{"type":"string"},"observed_at":{"type":"string","format":"date-time","nullable":true}}}}}},"platform_history":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["platform","from","to","observations"],"properties":{"platform":{"type":"string"},"from":{"type":"string","format":"date-time"},"to":{"type":"string","format":"date-time","nullable":true},"observations":{"type":"integer"}}}}}},"demo":{"type":"boolean"},"_demo_redactions":{"type":"object","additionalProperties":true},"simulated":{"type":"boolean"},"credits_charged":{"type":"integer"}}}},"securitySchemes":{"apiKeyAuth":{"type":"apiKey","in":"header","name":"X-API-Key"},"bearerAuth":{"type":"http","scheme":"bearer"}}},"servers":[{"url":"https://api.igamingfinder.com","description":"Production"}],"security":[{"apiKeyAuth":[]},{"bearerAuth":[]}],"paths":{"/v1/signals/market-entries":{"get":{"summary":"Qualified operator market-entry Signals by regulatory license regime","tags":["iGaming Signals API"],"parameters":[{"name":"role","in":"query","required":true,"schema":{"type":"string","enum":["operator"]}},{"name":"market","in":"query","required":true,"schema":{"type":"string","enum":["mga","ukgc","curacao","anjouan","gibraltar","isle_of_man","kahnawake","belgium","germany","ontario","france","argentina","portugal","sweden","greece","spain","italy","colombia","ireland","brazil","australia","us_pennsylvania","us_new_jersey","us_michigan","us_iowa","us_illinois","us_wyoming","us_maryland","us_arizona","us_new_york","us_massachusetts","us_vermont","us_connecticut","us_west_virginia","us_colorado","us_indiana","us_maine","us_tennessee","us_virginia","us_oregon","us_california","us_ohio","us_kentucky","us_louisiana","us_north_carolina","us_delaware","us_district_of_columbia","us_missouri","us_nevada","us_mississippi","netherlands","denmark","romania","switzerland_esbk","ca_alberta","au_northern_territory","au_south_australia","ar_caba","ar_buenos_aires","ar_mendoza","ar_neuquen","uzbekistan_napp","benin","botswana","ghana","guinea_conakry","liberia","ng_fct","ng_lagos","tanzania_mainland","uganda","slovakia","cyprus","latvia","hungary","georgia","kazakhstan","tobique","peru","czechia","poland","uruguay","croatia","austria","estonia","jersey","alderney","us_kansas","philippines","puerto_rico","fbih","bulgaria","dominican_republic","united_arab_emirates","russia"]}},{"name":"occurred_from","in":"query","schema":{"type":"string","format":"date"}},{"name":"occurred_to","in":"query","schema":{"type":"string","format":"date"}},{"name":"after","in":"query","schema":{"type":"string"}},{"name":"page","in":"query","schema":{"type":"integer","enum":[1]}},{"name":"page_size","in":"query","schema":{"type":"integer","minimum":1,"maximum":20}},{"name":"include[]","in":"query","schema":{"type":"array","items":{"type":"string","enum":["firmographics","contacts"]}}},{"name":"domains[]","in":"query","schema":{"type":"array","maxItems":3,"items":{"type":"string"}}},{"name":"contacts_limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":3}},{"name":"max_age_days","in":"query","schema":{"type":"integer","minimum":0,"maximum":365}},{"name":"max_credits","in":"query","schema":{"type":"integer","minimum":0}},{"name":"Idempotency-Key","in":"header","required":false,"description":"Stable retry key for one paid operation. Reuse it only when retrying the same request.","schema":{"type":"string"}}],"responses":{"200":{"description":"Qualified operator market-entry Signals by regulatory license regime","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["success","message","data","timestamp"],"properties":{"success":{"type":"boolean"},"message":{"type":"string"},"data":{"type":"object","additionalProperties":false,"required":["query","total","page","page_size","next_cursor","signals","billing"],"properties":{"query":{"type":"object","additionalProperties":false,"required":["role","market","include","domains","contacts_limit","max_age_days"],"properties":{"role":{"type":"string","enum":["operator"]},"market":{"type":"string","enum":["mga","ukgc","curacao","anjouan","gibraltar","isle_of_man","kahnawake","belgium","germany","ontario","france","argentina","portugal","sweden","greece","spain","italy","colombia","ireland","brazil","australia","us_pennsylvania","us_new_jersey","us_michigan","us_iowa","us_illinois","us_wyoming","us_maryland","us_arizona","us_new_york","us_massachusetts","us_vermont","us_connecticut","us_west_virginia","us_colorado","us_indiana","us_maine","us_tennessee","us_virginia","us_oregon","us_california","us_ohio","us_kentucky","us_louisiana","us_north_carolina","us_delaware","us_district_of_columbia","us_missouri","us_nevada","us_mississippi","netherlands","denmark","romania","switzerland_esbk","ca_alberta","au_northern_territory","au_south_australia","ar_caba","ar_buenos_aires","ar_mendoza","ar_neuquen","uzbekistan_napp","benin","botswana","ghana","guinea_conakry","liberia","ng_fct","ng_lagos","tanzania_mainland","uganda","slovakia","cyprus","latvia","hungary","georgia","kazakhstan","tobique","peru","czechia","poland","uruguay","croatia","austria","estonia","jersey","alderney","us_kansas","philippines","puerto_rico","fbih","bulgaria","dominican_republic","united_arab_emirates","russia"]},"include":{"type":"array","items":{"type":"string"}},"domains":{"type":"array","items":{"type":"string"}},"contacts_limit":{"type":"integer"},"max_age_days":{"type":"integer"}}},"total":{"type":"integer"},"page":{"type":"integer"},"page_size":{"type":"integer"},"next_cursor":{"type":"string","nullable":true},"signals":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["signal_ref","type","headline","market","subject","change","regulatory","quality","evidence"],"properties":{"signal_ref":{"type":"string"},"type":{"type":"string","enum":["market_entry"]},"headline":{"type":"string"},"market":{"type":"object","additionalProperties":false,"required":["scope","key","regulator","regulator_country_code","label","truth_state","hold_reasons","last_confirmed_at","last_seen_at","last_run_at"],"properties":{"scope":{"type":"string"},"key":{"type":"string"},"regulator":{"type":"string"},"regulator_country_code":{"type":"string"},"label":{"type":"string"},"truth_state":{"type":"string"},"hold_reasons":{"type":"array","items":{"type":"string"}},"last_confirmed_at":{"type":"string","nullable":true},"last_seen_at":{"type":"string","nullable":true},"last_run_at":{"type":"string","nullable":true}}},"subject":{"type":"object","additionalProperties":false,"required":["company_ref","role","role_derived_at","brand","domains"],"properties":{"company_ref":{"type":"string"},"role":{"type":"string","enum":["operator","aggregator","platform_provider","payment_provider","game_studio","affiliate_software","affiliate_media","other_supplier","unknown"]},"role_derived_at":{"type":"string","format":"date-time"},"brand":{"type":"string","nullable":true},"domains":{"type":"array","items":{"$ref":"#/components/schemas/DomainEntry"}}}},"change":{"type":"object","additionalProperties":false,"required":["type","occurred_at","detected_at","last_corrected_at"],"properties":{"type":{"type":"string","enum":["license_issued"]},"occurred_at":{"type":"string","format":"date-time"},"detected_at":{"type":"string","format":"date-time"},"last_corrected_at":{"type":"string","format":"date-time","nullable":true}}},"regulatory":{"type":"object","additionalProperties":false,"required":["license_ref","licensee_legal_name","license_number","license_type","status","issued_at","expires_at","last_confirmed_at","authorized_domains"],"properties":{"license_ref":{"type":"string"},"licensee_legal_name":{"type":"string"},"license_number":{"type":"string"},"license_type":{"type":"string","nullable":true},"status":{"type":"string","enum":["unknown","active","suspended","revoked","expired"]},"issued_at":{"type":"string"},"expires_at":{"type":"string","nullable":true},"last_confirmed_at":{"type":"string","format":"date-time","nullable":true},"authorized_domains":{"type":"array","items":{"$ref":"#/components/schemas/DomainEntry"}}}},"quality":{"type":"object","additionalProperties":false,"required":["confidence","materiality","materiality_reasons","coverage"],"properties":{"confidence":{"type":"string","enum":["low","medium","high"]},"materiality":{"type":"string","enum":["unscored","low","medium","high"]},"materiality_reasons":{"type":"array","items":{"type":"string"}},"coverage":{"type":"object","additionalProperties":false,"required":["licenses","authorized_domains","firmographics","contacts"],"properties":{"licenses":{"type":"object","additionalProperties":false,"required":["status","reason"],"properties":{"status":{"type":"string","enum":["included","available","not_available","not_requested"]},"reason":{"type":"string","nullable":true}}},"authorized_domains":{"type":"object","additionalProperties":false,"required":["status","reason"],"properties":{"status":{"type":"string","enum":["included","available","not_available","not_requested"]},"reason":{"type":"string","nullable":true}}},"firmographics":{"type":"object","additionalProperties":false,"required":["status","reason"],"properties":{"status":{"type":"string","enum":["included","available","not_available","not_requested"]},"reason":{"type":"string","nullable":true}}},"contacts":{"type":"object","additionalProperties":false,"required":["status","reason"],"properties":{"status":{"type":"string","enum":["included","available","not_available","not_requested"]},"reason":{"type":"string","nullable":true}}}}}}},"evidence":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["source_type","source_name","source_url","observed_at"],"properties":{"source_type":{"type":"string","enum":["license_registry"]},"source_name":{"type":"string"},"source_url":{"type":"string","nullable":true},"observed_at":{"type":"string","format":"date-time","nullable":true}}}}}}},"billing":{"type":"object","additionalProperties":false,"required":["credits_charged","breakdown","max_credits"],"properties":{"credits_charged":{"type":"integer"},"breakdown":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["key","units","credits_per_unit","credits_charged"],"properties":{"key":{"type":"string","enum":["signal.base"]},"units":{"type":"integer"},"credits_per_unit":{"type":"integer"},"credits_charged":{"type":"integer"}}}},"max_credits":{"type":"integer","nullable":true}}},"demo":{"type":"boolean"},"_demo_redactions":{"type":"object","additionalProperties":true},"simulated":{"type":"boolean"},"credits_charged":{"type":"integer"}}},"timestamp":{"type":"string","format":"date-time"}}}}}},"400":{"description":"Bad request — invalid or missing parameter","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"401":{"description":"Unauthorized — missing or unknown API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"402":{"description":"Payment required — max_credits below cost, or plan gate","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"403":{"description":"Forbidden — demo key outside documented templates","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"409":{"description":"Conflict — idempotency reuse or ambiguous ref","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"422":{"description":"Unprocessable entity","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"429":{"description":"Too many requests — credit quota exhausted","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"500":{"description":"Internal server error — request failed before delivery","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"503":{"description":"Service unavailable — search backend down","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-igf-paid":true,"operationId":"signals_market_entries","description":"Qualified operator market-entry Signals by regulatory license regime"}},"/v1/signals/platform-sites":{"get":{"summary":"First-observed operator sites by ruled platform","tags":["iGaming Signals API"],"parameters":[{"name":"role","in":"query","required":true,"schema":{"type":"string","enum":["operator"]}},{"name":"platform","in":"query","required":true,"schema":{"type":"string"}},{"name":"occurred_from","in":"query","schema":{"type":"string","format":"date"}},{"name":"occurred_to","in":"query","schema":{"type":"string","format":"date"}},{"name":"after","in":"query","schema":{"type":"string"}},{"name":"page","in":"query","schema":{"type":"integer","enum":[1]}},{"name":"page_size","in":"query","schema":{"type":"integer","minimum":1,"maximum":20}},{"name":"max_credits","in":"query","schema":{"type":"integer","minimum":0}},{"name":"Idempotency-Key","in":"header","required":false,"description":"Stable retry key for one paid operation. Reuse it only when retrying the same request.","schema":{"type":"string"}}],"responses":{"200":{"description":"First-observed operator sites by ruled platform","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["success","message","data","timestamp"],"properties":{"success":{"type":"boolean"},"message":{"type":"string"},"data":{"type":"object","additionalProperties":false,"required":["query","total","page","page_size","next_cursor","signals","billing"],"properties":{"query":{"type":"object","additionalProperties":false,"required":["role","platform"],"properties":{"role":{"type":"string","enum":["operator"]},"platform":{"type":"string"}}},"total":{"type":"integer"},"page":{"type":"integer"},"page_size":{"type":"integer"},"next_cursor":{"type":"string","nullable":true},"signals":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["signal_ref","type","headline","platform","subject","change","evidence"],"properties":{"signal_ref":{"type":"string"},"type":{"type":"string","enum":["platform_new_site"]},"headline":{"type":"string"},"platform":{"type":"object","additionalProperties":false,"required":["key","name"],"properties":{"key":{"type":"string"},"name":{"type":"string"}}},"subject":{"type":"object","additionalProperties":false,"required":["company_ref","role","role_derived_at","brand","domain"],"properties":{"company_ref":{"type":"string"},"role":{"type":"string","enum":["operator","aggregator","platform_provider","payment_provider","game_studio","affiliate_software","affiliate_media","other_supplier","unknown"]},"role_derived_at":{"type":"string","format":"date-time"},"brand":{"type":"string","nullable":true},"domain":{"type":"string"}}},"change":{"type":"object","additionalProperties":false,"required":["type","occurred_at","detected_at","last_corrected_at"],"properties":{"type":{"type":"string","enum":["platform_first_observed"]},"occurred_at":{"type":"string","format":"date-time"},"detected_at":{"type":"string","format":"date-time"},"last_corrected_at":{"type":"string","format":"date-time","nullable":true}}},"evidence":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["source_type","source_url","observed_at"],"properties":{"source_type":{"type":"string","enum":["site_capture"]},"source_url":{"type":"string","nullable":true},"observed_at":{"type":"string","format":"date-time","nullable":true}}}}}}},"billing":{"type":"object","additionalProperties":false,"required":["credits_charged","breakdown","max_credits"],"properties":{"credits_charged":{"type":"integer"},"breakdown":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["key","units","credits_per_unit","credits_charged"],"properties":{"key":{"type":"string","enum":["signal.base"]},"units":{"type":"integer"},"credits_per_unit":{"type":"integer"},"credits_charged":{"type":"integer"}}}},"max_credits":{"type":"integer","nullable":true}}},"demo":{"type":"boolean"},"_demo_redactions":{"type":"object","additionalProperties":true},"simulated":{"type":"boolean"},"credits_charged":{"type":"integer"}}},"timestamp":{"type":"string","format":"date-time"}}}}}},"400":{"description":"Bad request — invalid or missing parameter","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"401":{"description":"Unauthorized — missing or unknown API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"402":{"description":"Payment required — max_credits below cost, or plan gate","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"403":{"description":"Forbidden — demo key outside documented templates","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"409":{"description":"Conflict — idempotency reuse or ambiguous ref","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"422":{"description":"Unprocessable entity","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"429":{"description":"Too many requests — credit quota exhausted","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"500":{"description":"Internal server error — request failed before delivery","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"503":{"description":"Service unavailable — search backend down","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-igf-paid":true,"operationId":"signals_platform_sites","description":"First-observed operator sites by ruled platform"}},"/v1/signals/register-changes":{"get":{"summary":"Claim-aware changes published by official register streams","tags":["iGaming Signals API"],"parameters":[{"name":"jurisdiction","in":"query","required":true,"schema":{"type":"string","enum":["mga","ukgc","curacao","anjouan","gibraltar","isle_of_man","kahnawake","belgium","germany","ontario","france","argentina","portugal","sweden","greece","spain","italy","colombia","ireland","brazil","australia","us_pennsylvania","us_new_jersey","us_michigan","us_iowa","us_illinois","us_wyoming","us_maryland","us_arizona","us_new_york","us_massachusetts","us_vermont","us_connecticut","us_west_virginia","us_colorado","us_indiana","us_maine","us_tennessee","us_virginia","us_oregon","us_california","us_ohio","us_kentucky","us_louisiana","us_north_carolina","us_delaware","us_district_of_columbia","us_missouri","us_nevada","us_mississippi","netherlands","denmark","romania","switzerland_esbk","ca_alberta","au_northern_territory","au_south_australia","ar_caba","ar_buenos_aires","ar_mendoza","ar_neuquen","uzbekistan_napp","benin","botswana","ghana","guinea_conakry","liberia","ng_fct","ng_lagos","tanzania_mainland","uganda","slovakia","cyprus","latvia","hungary","georgia","kazakhstan","tobique","peru","czechia","poland","uruguay","croatia","austria","estonia","jersey","alderney","us_kansas","philippines","puerto_rico","fbih","bulgaria","dominican_republic","united_arab_emirates","russia"]}},{"name":"source_stream_key","in":"query","schema":{"type":"string"}},{"name":"event_type","in":"query","schema":{"type":"string","enum":["added_to_register","removed_from_register","revoked","returned_to_register","expiry_date_passed","authorized_domains_changed","published_expiry_changed","license_type_changed","legal_entity_changed","published_status_changed"]}},{"name":"event_type[]","in":"query","schema":{"type":"array","items":{"type":"string","enum":["added_to_register","removed_from_register","revoked","returned_to_register","expiry_date_passed","authorized_domains_changed","published_expiry_changed","license_type_changed","legal_entity_changed","published_status_changed"]}}},{"name":"occurred_from","in":"query","schema":{"type":"string","format":"date"}},{"name":"occurred_to","in":"query","schema":{"type":"string","format":"date"}},{"name":"after","in":"query","schema":{"type":"string"}},{"name":"page","in":"query","schema":{"type":"integer","enum":[1]}},{"name":"page_size","in":"query","schema":{"type":"integer","minimum":1,"maximum":20}},{"name":"max_credits","in":"query","schema":{"type":"integer","minimum":0}},{"name":"Idempotency-Key","in":"header","required":false,"description":"Stable retry key for one paid operation. Reuse it only when retrying the same request.","schema":{"type":"string"}}],"responses":{"200":{"description":"Claim-aware changes published by official register streams","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["success","message","data","timestamp"],"properties":{"success":{"type":"boolean"},"message":{"type":"string"},"data":{"type":"object","additionalProperties":false,"required":["query","total","page","page_size","next_cursor","signals","billing"],"properties":{"query":{"type":"object","additionalProperties":false,"required":["jurisdiction","source_stream_key","event_type","occurred_from","occurred_to"],"properties":{"jurisdiction":{"type":"string","enum":["mga","ukgc","curacao","anjouan","gibraltar","isle_of_man","kahnawake","belgium","germany","ontario","france","argentina","portugal","sweden","greece","spain","italy","colombia","ireland","brazil","australia","us_pennsylvania","us_new_jersey","us_michigan","us_iowa","us_illinois","us_wyoming","us_maryland","us_arizona","us_new_york","us_massachusetts","us_vermont","us_connecticut","us_west_virginia","us_colorado","us_indiana","us_maine","us_tennessee","us_virginia","us_oregon","us_california","us_ohio","us_kentucky","us_louisiana","us_north_carolina","us_delaware","us_district_of_columbia","us_missouri","us_nevada","us_mississippi","netherlands","denmark","romania","switzerland_esbk","ca_alberta","au_northern_territory","au_south_australia","ar_caba","ar_buenos_aires","ar_mendoza","ar_neuquen","uzbekistan_napp","benin","botswana","ghana","guinea_conakry","liberia","ng_fct","ng_lagos","tanzania_mainland","uganda","slovakia","cyprus","latvia","hungary","georgia","kazakhstan","tobique","peru","czechia","poland","uruguay","croatia","austria","estonia","jersey","alderney","us_kansas","philippines","puerto_rico","fbih","bulgaria","dominican_republic","united_arab_emirates","russia"]},"source_stream_key":{"type":"string","nullable":true},"event_type":{"type":"array","items":{"type":"string","enum":["added_to_register","removed_from_register","revoked","returned_to_register","expiry_date_passed","authorized_domains_changed","published_expiry_changed","license_type_changed","legal_entity_changed","published_status_changed"]},"nullable":true},"occurred_from":{"type":"string","nullable":true},"occurred_to":{"type":"string","nullable":true}}},"total":{"type":"integer"},"page":{"type":"integer"},"page_size":{"type":"integer"},"next_cursor":{"type":"string","nullable":true},"signals":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["signal_ref","type","headline","source","subject","license","change","evidence"],"properties":{"signal_ref":{"type":"string"},"type":{"type":"string","enum":["register_change"]},"headline":{"type":"string"},"source":{"type":"object","additionalProperties":false,"required":["source_stream_key","jurisdiction","source_claim","qualification","source_identity"],"properties":{"source_stream_key":{"type":"string"},"jurisdiction":{"type":"string","enum":["mga","ukgc","curacao","anjouan","gibraltar","isle_of_man","kahnawake","belgium","germany","ontario","france","argentina","portugal","sweden","greece","spain","italy","colombia","ireland","brazil","australia","us_pennsylvania","us_new_jersey","us_michigan","us_iowa","us_illinois","us_wyoming","us_maryland","us_arizona","us_new_york","us_massachusetts","us_vermont","us_connecticut","us_west_virginia","us_colorado","us_indiana","us_maine","us_tennessee","us_virginia","us_oregon","us_california","us_ohio","us_kentucky","us_louisiana","us_north_carolina","us_delaware","us_district_of_columbia","us_missouri","us_nevada","us_mississippi","netherlands","denmark","romania","switzerland_esbk","ca_alberta","au_northern_territory","au_south_australia","ar_caba","ar_buenos_aires","ar_mendoza","ar_neuquen","uzbekistan_napp","benin","botswana","ghana","guinea_conakry","liberia","ng_fct","ng_lagos","tanzania_mainland","uganda","slovakia","cyprus","latvia","hungary","georgia","kazakhstan","tobique","peru","czechia","poland","uruguay","croatia","austria","estonia","jersey","alderney","us_kansas","philippines","puerto_rico","fbih","bulgaria","dominican_republic","united_arab_emirates","russia"]},"source_claim":{"type":"string"},"qualification":{"type":"string"},"source_identity":{"type":"string"}}},"subject":{"type":"object","additionalProperties":false,"required":["company_ref","role","published_legal_name"],"properties":{"company_ref":{"type":"string","nullable":true},"role":{"type":"string","enum":["unknown"]},"published_legal_name":{"type":"string","nullable":true}}},"license":{"type":"object","additionalProperties":false,"required":["license_number","license_type","reviewed_status_claim","authorized_domains"],"properties":{"license_number":{"type":"string","nullable":true},"license_type":{"type":"string","nullable":true},"reviewed_status_claim":{"type":"string","nullable":true},"authorized_domains":{"type":"array","items":{"type":"string"}}}},"change":{"type":"object","additionalProperties":false,"required":["event_type","change_set","occurred_at","detected_at"],"properties":{"event_type":{"type":"string","enum":["added_to_register","removed_from_register","revoked","returned_to_register","expiry_date_passed","authorized_domains_changed","published_expiry_changed","license_type_changed","legal_entity_changed","published_status_changed"]},"change_set":{"type":"object"},"occurred_at":{"type":"string","format":"date-time"},"detected_at":{"type":"string","format":"date-time"}}},"evidence":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["source_type","source_url","observed_at"],"properties":{"source_type":{"type":"string","enum":["register"]},"source_url":{"type":"string","nullable":true},"observed_at":{"type":"string","format":"date-time","nullable":true}}}}}}},"billing":{"type":"object","additionalProperties":false,"required":["credits_charged","breakdown","max_credits"],"properties":{"credits_charged":{"type":"integer"},"breakdown":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["key","units","credits_per_unit","credits_charged"],"properties":{"key":{"type":"string","enum":["signal.base"]},"units":{"type":"integer"},"credits_per_unit":{"type":"integer"},"credits_charged":{"type":"integer"}}}},"max_credits":{"type":"integer","nullable":true}}},"demo":{"type":"boolean"},"_demo_redactions":{"type":"object","additionalProperties":true},"simulated":{"type":"boolean"},"credits_charged":{"type":"integer"}}},"timestamp":{"type":"string","format":"date-time"}}}}}},"400":{"description":"Bad request — invalid or missing parameter","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"401":{"description":"Unauthorized — missing or unknown API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"402":{"description":"Payment required — max_credits below cost, or plan gate","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"403":{"description":"Forbidden — demo key outside documented templates","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"409":{"description":"Conflict — idempotency reuse or ambiguous ref","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"422":{"description":"Unprocessable entity","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"429":{"description":"Too many requests — credit quota exhausted","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"500":{"description":"Internal server error — request failed before delivery","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"503":{"description":"Service unavailable — search backend down","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-igf-paid":true,"operationId":"signals_register_changes","description":"Claim-aware changes published by official register streams"}},"/v1/companies/search/preview":{"get":{"summary":"Preview Company search count/facets/cost","tags":["iGaming Company API"],"parameters":[{"name":"q","in":"query","description":"Free text. Preview rejects ruled platform-brand values that would reveal paid payload data.","schema":{"type":"string"}},{"name":"domain","in":"query","schema":{"type":"string"}},{"name":"role","in":"query","schema":{"type":"string","enum":["operator","aggregator","platform_provider","payment_provider","game_studio","affiliate_software","affiliate_media","other_supplier","unknown"]}},{"name":"jurisdiction","in":"query","schema":{"type":"string"}},{"name":"license_status","in":"query","schema":{"type":"string"}},{"name":"payment_category","in":"query","schema":{"type":"string"}},{"name":"has_platform","in":"query","schema":{"type":"boolean"}},{"name":"affiliate_program","in":"query","schema":{"type":"boolean"}},{"name":"geo","in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":"Preview Company search count/facets/cost","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["success","message","data","timestamp"],"properties":{"success":{"type":"boolean"},"message":{"type":"string"},"data":{"type":"object","additionalProperties":false,"required":["query","total_count","estimated_costs","next_action","facet_counts","sample","identity_match","answered","answer_basis"],"properties":{"query":{"type":"object"},"total_count":{"type":"integer"},"estimated_costs":{"type":"object"},"next_action":{"type":"object","additionalProperties":false,"required":["type","method","href","estimated_credits"],"properties":{"type":{"type":"string","enum":["paid_search"]},"method":{"type":"string","enum":["GET"]},"href":{"type":"string"},"estimated_credits":{"type":"integer"}},"nullable":true},"facet_counts":{"type":"array","items":{"type":"object"}},"sample":{"type":"array","items":{"type":"object"}},"identity_match":{"type":"object","nullable":true,"additionalProperties":false,"properties":{"type":{"type":"string"},"name":{"type":"string"},"aliases":{"type":"array","items":{"type":"string"}},"official_domain":{"type":"string","nullable":true},"company_ref":{"type":"string","nullable":true},"company_name":{"type":"string","nullable":true},"legal_entity":{"type":"string","nullable":true}},"required":["type","name","aliases","official_domain","company_ref","company_name","legal_entity"]},"answered":{"type":"boolean","nullable":true},"answer_basis":{"type":"string","nullable":true},"demo":{"type":"boolean"},"_demo_redactions":{"type":"object","additionalProperties":true},"simulated":{"type":"boolean"},"credits_charged":{"type":"integer"}}},"timestamp":{"type":"string","format":"date-time"}}}}}},"400":{"description":"Bad request — invalid or missing parameter","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"401":{"description":"Unauthorized — missing or unknown API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"402":{"description":"Payment required — max_credits below cost, or plan gate","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"403":{"description":"Forbidden — demo key outside documented templates","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"409":{"description":"Conflict — idempotency reuse or ambiguous ref","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"422":{"description":"Unprocessable entity","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"429":{"description":"Too many requests — credit quota exhausted","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"500":{"description":"Internal server error — request failed before delivery","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"503":{"description":"Service unavailable — search backend down","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-igf-paid":false,"operationId":"companies_search_preview","description":"Preview Company search count/facets/cost"}},"/v1/companies/search":{"get":{"summary":"Paid ranked Company discovery rows","tags":["iGaming Company API"],"parameters":[{"name":"q","in":"query","description":"Free text.","schema":{"type":"string"}},{"name":"domain","in":"query","schema":{"type":"string"}},{"name":"role","in":"query","schema":{"type":"string","enum":["operator","aggregator","platform_provider","payment_provider","game_studio","affiliate_software","affiliate_media","other_supplier","unknown"]}},{"name":"jurisdiction","in":"query","schema":{"type":"string"}},{"name":"license_status","in":"query","schema":{"type":"string"}},{"name":"payment_method","in":"query","schema":{"type":"string"}},{"name":"payment_category","in":"query","schema":{"type":"string"}},{"name":"supplier_brand","in":"query","schema":{"type":"string"}},{"name":"platform","in":"query","schema":{"type":"string"}},{"name":"has_platform","in":"query","schema":{"type":"boolean"}},{"name":"affiliate_program","in":"query","schema":{"type":"boolean"}},{"name":"geo","in":"query","schema":{"type":"string"}},{"name":"page","in":"query","schema":{"type":"integer","minimum":1}},{"name":"page_size","in":"query","schema":{"type":"integer","minimum":1,"maximum":100}},{"name":"max_credits","in":"query","schema":{"type":"integer","minimum":0}},{"name":"Idempotency-Key","in":"header","required":false,"description":"Stable retry key for one paid operation. Reuse it only when retrying the same request.","schema":{"type":"string"}}],"responses":{"200":{"description":"Paid ranked Company discovery rows","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["success","message","data","timestamp"],"properties":{"success":{"type":"boolean"},"message":{"type":"string"},"data":{"type":"object","additionalProperties":false,"required":["query","total","page","page_size","hits","facet_counts","identity_match","answered","answer_basis","billing"],"properties":{"query":{"type":"object"},"total":{"type":"integer"},"page":{"type":"integer"},"page_size":{"type":"integer"},"hits":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["company_ref","company_name","legal_entity","subject_kind","role","primary_domain","domains_sample","domain_count","jurisdictions","license_statuses","license_count","payment_categories","payment_method_count","supplier_brand_count","platform_present","affiliate_program_present","geo_hints","data_completeness","last_observed_at","last_updated_at","rank","score","matched_fields","highlight","firmographics_available","contacts_available"],"properties":{"company_ref":{"type":"string"},"company_name":{"type":"string","nullable":true},"legal_entity":{"type":"string","nullable":true},"subject_kind":{"type":"string","enum":["legal_entity","trade_name","platform","domain","unknown"]},"role":{"type":"array","items":{"type":"string","enum":["operator","aggregator","platform_provider","payment_provider","game_studio","affiliate_software","affiliate_media","other_supplier","unknown"]}},"primary_domain":{"nullable":true,"allOf":[{"$ref":"#/components/schemas/DomainEntry"}]},"domains_sample":{"type":"array","items":{"$ref":"#/components/schemas/DomainEntry"}},"domain_count":{"type":"integer"},"jurisdictions":{"type":"array","items":{"type":"string"}},"license_statuses":{"type":"array","items":{"type":"string"}},"license_count":{"type":"integer"},"payment_categories":{"type":"array","items":{"type":"string"}},"payment_method_count":{"type":"integer"},"supplier_brand_count":{"type":"integer"},"platform_present":{"type":"boolean"},"affiliate_program_present":{"type":"boolean"},"geo_hints":{"type":"array","items":{"type":"string"}},"data_completeness":{"type":"number","nullable":true},"last_observed_at":{"type":"string","format":"date-time","nullable":true},"last_updated_at":{"type":"string","format":"date-time","nullable":true},"rank":{"type":"integer"},"score":{"type":"number","nullable":true},"matched_fields":{"type":"array","items":{"type":"string"}},"highlight":{"type":"object"},"firmographics_available":{"type":"boolean"},"contacts_available":{"type":"boolean"}}}},"facet_counts":{"type":"array","items":{"type":"object"}},"identity_match":{"type":"object","nullable":true,"additionalProperties":false,"properties":{"type":{"type":"string"},"name":{"type":"string"},"aliases":{"type":"array","items":{"type":"string"}},"official_domain":{"type":"string","nullable":true},"company_ref":{"type":"string","nullable":true},"company_name":{"type":"string","nullable":true},"legal_entity":{"type":"string","nullable":true}},"required":["type","name","aliases","official_domain","company_ref","company_name","legal_entity"]},"answered":{"type":"boolean","nullable":true},"answer_basis":{"type":"string","nullable":true},"billing":{"type":"object","additionalProperties":false,"required":["returned_count","credits_charged","billing_reason"],"properties":{"returned_count":{"type":"integer"},"credits_per_result":{"type":"integer"},"credits_charged":{"type":"integer"},"billing_reason":{"type":"string"},"max_credits":{"type":"integer","nullable":true},"page_size":{"type":"integer","nullable":true}}},"demo":{"type":"boolean"},"_demo_redactions":{"type":"object","additionalProperties":true},"simulated":{"type":"boolean"},"credits_charged":{"type":"integer"}}},"timestamp":{"type":"string","format":"date-time"}}}}}},"400":{"description":"Bad request — invalid or missing parameter","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"401":{"description":"Unauthorized — missing or unknown API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"402":{"description":"Payment required — max_credits below cost, or plan gate","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"403":{"description":"Forbidden — demo key outside documented templates","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"409":{"description":"Conflict — idempotency reuse or ambiguous ref","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"422":{"description":"Unprocessable entity","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"429":{"description":"Too many requests — credit quota exhausted","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"500":{"description":"Internal server error — request failed before delivery","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"503":{"description":"Service unavailable — search backend down","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-igf-paid":true,"operationId":"companies_search","description":"Paid ranked Company discovery rows"}},"/v1/companies/resolve":{"get":{"summary":"Resolve authoritative Company profile","tags":["iGaming Company API"],"parameters":[{"name":"company_ref","in":"query","required":false,"schema":{"type":"string"}},{"name":"license_number","in":"query","required":false,"schema":{"type":"string"}},{"name":"jurisdiction","in":"query","required":false,"schema":{"type":"string"}},{"name":"domain","in":"query","required":false,"schema":{"type":"string"}},{"name":"legal_entity","in":"query","required":false,"schema":{"type":"string"}},{"name":"name","in":"query","required":false,"schema":{"type":"string"}},{"name":"domain_ref","in":"query","required":false,"schema":{"type":"string"}},{"name":"allow_stale_on_error","in":"query","required":false,"schema":{"type":"boolean","default":true}},{"name":"max_credits","in":"query","required":false,"schema":{"type":"integer","minimum":0}},{"name":"include[]","in":"query","required":false,"description":"Repeat include[] for each requested section.","schema":{"type":"array","items":{"type":"string"}}},{"name":"max_age_days","in":"query","required":false,"schema":{"type":"integer","minimum":0,"maximum":365}},{"name":"Idempotency-Key","in":"header","required":false,"description":"Stable retry key for one paid operation. Reuse it only when retrying the same request.","schema":{"type":"string"}}],"responses":{"200":{"description":"Company profile resolved","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["success","message","data","timestamp"],"properties":{"success":{"type":"boolean"},"message":{"type":"string"},"data":{"type":"object","additionalProperties":false,"required":["resolved_by","query","ignored_inputs","input_company_ref","resolved_company_ref","ref_status","matches","companies","billing"],"properties":{"resolved_by":{"type":"string","nullable":true},"query":{"type":"object"},"ignored_inputs":{"type":"object"},"input_company_ref":{"type":"string","nullable":true},"resolved_company_ref":{"type":"string","nullable":true},"ref_status":{"type":"string","nullable":true},"matches":{"type":"array","items":{"type":"object"}},"companies":{"type":"array","items":{"$ref":"#/components/schemas/CompanyProfile"}},"billing":{"type":"object","additionalProperties":false,"required":["returned_count","credits_charged","billing_reason"],"properties":{"returned_count":{"type":"integer"},"credits_per_profile":{"type":"integer"},"credits_charged":{"type":"integer"},"billing_reason":{"type":"string"},"max_credits":{"type":"integer","nullable":true},"page_size":{"type":"integer","nullable":true},"firmographics_returned_count":{"type":"integer"},"credits_per_firmographics_result":{"type":"integer"}}},"demo":{"type":"boolean"},"_demo_redactions":{"type":"object","additionalProperties":true},"simulated":{"type":"boolean"},"credits_charged":{"type":"integer"}}},"timestamp":{"type":"string","format":"date-time"}}}}}},"400":{"description":"Bad request — invalid or missing parameter","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"401":{"description":"Unauthorized — missing or unknown API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"402":{"description":"Payment required — max_credits below cost, or plan gate","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"403":{"description":"Forbidden — demo key outside documented templates","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"409":{"description":"Conflict — idempotency reuse or ambiguous ref","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"422":{"description":"Unprocessable entity","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"429":{"description":"Too many requests — credit quota exhausted","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"500":{"description":"Internal server error — request failed before delivery","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"503":{"description":"Service unavailable — search backend down","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-igf-paid":true,"operationId":"companies_resolve","description":"Resolve identifiers to authoritative Company profile(s)"}},"/v1/companies/{company_ref}/people":{"get":{"summary":"Decision-maker contacts for a Company","tags":["iGaming Company API"],"parameters":[{"name":"role","in":"query","schema":{"type":"string"}},{"name":"page_size","in":"query","schema":{"type":"integer","minimum":1,"maximum":25}},{"name":"max_age_days","in":"query","schema":{"type":"integer","minimum":0,"maximum":365}},{"name":"max_credits","in":"query","schema":{"type":"integer","minimum":0}},{"name":"company_ref","in":"path","required":true,"schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":false,"description":"Stable retry key for one paid operation. Reuse it only when retrying the same request.","schema":{"type":"string"}}],"responses":{"200":{"description":"Decision-maker contacts for a Company","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["success","message","data","timestamp"],"properties":{"success":{"type":"boolean"},"message":{"type":"string"},"data":{"type":"object","additionalProperties":false,"required":["company_ref","resolved_company_ref","available","reason","cached","people","billing"],"properties":{"company_ref":{"type":"string"},"resolved_company_ref":{"type":"string","nullable":true},"available":{"type":"boolean"},"reason":{"type":"string","nullable":true},"cached":{"type":"boolean"},"people":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["full_name","role","linkedin_url","personal_emails"],"properties":{"full_name":{"type":"string","nullable":true},"role":{"type":"string","nullable":true},"linkedin_url":{"type":"string","nullable":true},"personal_emails":{"type":"array","items":{"type":"string"}}}}},"billing":{"type":"object","additionalProperties":false,"required":["returned_count","credits_charged","billing_reason"],"properties":{"returned_count":{"type":"integer"},"credits_per_contact":{"type":"integer"},"credits_charged":{"type":"integer"},"billing_reason":{"type":"string"},"max_credits":{"type":"integer","nullable":true},"page_size":{"type":"integer","nullable":true}}},"demo":{"type":"boolean"},"_demo_redactions":{"type":"object","additionalProperties":true},"simulated":{"type":"boolean"},"credits_charged":{"type":"integer"}}},"timestamp":{"type":"string","format":"date-time"}}}}}},"400":{"description":"Bad request — invalid or missing parameter","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"401":{"description":"Unauthorized — missing or unknown API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"402":{"description":"Payment required — max_credits below cost, or plan gate","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"403":{"description":"Forbidden — demo key outside documented templates","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"409":{"description":"Conflict — idempotency reuse or ambiguous ref","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"422":{"description":"Unprocessable entity","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"429":{"description":"Too many requests — credit quota exhausted","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"500":{"description":"Internal server error — request failed before delivery","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"503":{"description":"Service unavailable — search backend down","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-igf-paid":true,"operationId":"companies_people","description":"Decision-maker contacts for a Company"}},"/v1/licenses/search/preview":{"get":{"summary":"Preview License search count/facets/cost","tags":["iGaming License API"],"parameters":[{"name":"q","in":"query","schema":{"type":"string"}},{"name":"role","in":"query","schema":{"type":"string","enum":["operator","aggregator","platform_provider","payment_provider","game_studio","affiliate_software","affiliate_media","other_supplier","unknown"]}},{"name":"jurisdiction","in":"query","schema":{"type":"string"}},{"name":"license_status","in":"query","schema":{"type":"string"}},{"name":"license_type","in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":"Preview License search count/facets/cost","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["success","message","data","timestamp"],"properties":{"success":{"type":"boolean"},"message":{"type":"string"},"data":{"type":"object","additionalProperties":false,"required":["query","total_count","estimated_costs","facet_counts","sample"],"properties":{"query":{"type":"object"},"total_count":{"type":"integer"},"estimated_costs":{"type":"object"},"facet_counts":{"type":"array","items":{"type":"object"}},"sample":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["jurisdiction","license_status","license_type","role","payload_redacted"],"properties":{"jurisdiction":{"type":"string","nullable":true},"license_status":{"type":"string","nullable":true},"license_type":{"type":"string","nullable":true},"role":{"type":"array","items":{"type":"string","enum":["operator","aggregator","platform_provider","payment_provider","game_studio","affiliate_software","affiliate_media","other_supplier","unknown"]}},"payload_redacted":{"type":"boolean"},"domain_match_basis":{"type":"string","enum":["regulator_published","site_corroborated","both"]}}}},"demo":{"type":"boolean"},"_demo_redactions":{"type":"object","additionalProperties":true},"simulated":{"type":"boolean"},"credits_charged":{"type":"integer"}}},"timestamp":{"type":"string","format":"date-time"}}}}}},"400":{"description":"Bad request — invalid or missing parameter","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"401":{"description":"Unauthorized — missing or unknown API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"402":{"description":"Payment required — max_credits below cost, or plan gate","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"403":{"description":"Forbidden — demo key outside documented templates","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"409":{"description":"Conflict — idempotency reuse or ambiguous ref","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"422":{"description":"Unprocessable entity","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"429":{"description":"Too many requests — credit quota exhausted","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"500":{"description":"Internal server error — request failed before delivery","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"503":{"description":"Service unavailable — search backend down","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-igf-paid":false,"operationId":"licenses_search_preview","description":"Preview License search count/facets/cost"}},"/v1/licenses/search":{"get":{"summary":"Paid ranked License discovery rows","tags":["iGaming License API"],"parameters":[{"name":"q","in":"query","schema":{"type":"string"}},{"name":"role","in":"query","schema":{"type":"string","enum":["operator","aggregator","platform_provider","payment_provider","game_studio","affiliate_software","affiliate_media","other_supplier","unknown"]}},{"name":"jurisdiction","in":"query","schema":{"type":"string"}},{"name":"license_status","in":"query","schema":{"type":"string"}},{"name":"license_type","in":"query","schema":{"type":"string"}},{"name":"page","in":"query","schema":{"type":"integer","minimum":1}},{"name":"page_size","in":"query","schema":{"type":"integer","minimum":1,"maximum":100}},{"name":"max_credits","in":"query","schema":{"type":"integer","minimum":0}},{"name":"Idempotency-Key","in":"header","required":false,"description":"Stable retry key for one paid operation. Reuse it only when retrying the same request.","schema":{"type":"string"}}],"responses":{"200":{"description":"Paid ranked License discovery rows","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["success","message","data","timestamp"],"properties":{"success":{"type":"boolean"},"message":{"type":"string"},"data":{"type":"object","additionalProperties":false,"required":["query","total","page","page_size","hits","facet_counts","billing"],"properties":{"query":{"type":"object"},"total":{"type":"integer"},"page":{"type":"integer"},"page_size":{"type":"integer"},"hits":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["license_ref","license_number","jurisdiction","license_status","license_type","company_ref","company_name","role","authorized_domain_count","first_seen_at","last_confirmed_at","rank","score","matched_fields","highlight"],"properties":{"license_ref":{"type":"string"},"license_number":{"type":"string","nullable":true},"jurisdiction":{"type":"string","nullable":true},"license_status":{"type":"string","nullable":true},"license_type":{"type":"string","nullable":true},"company_ref":{"type":"string","nullable":true},"company_name":{"type":"string","nullable":true},"role":{"type":"array","items":{"type":"string","enum":["operator","aggregator","platform_provider","payment_provider","game_studio","affiliate_software","affiliate_media","other_supplier","unknown"]}},"authorized_domain_count":{"type":"integer"},"domain_match_basis":{"type":"string","enum":["regulator_published","site_corroborated","both"]},"first_seen_at":{"type":"string","format":"date-time","nullable":true},"last_confirmed_at":{"type":"string","format":"date-time","nullable":true},"rank":{"type":"integer"},"score":{"type":"number","nullable":true},"matched_fields":{"type":"array","items":{"type":"string"}},"highlight":{"type":"object"}}}},"facet_counts":{"type":"array","items":{"type":"object"}},"billing":{"type":"object","additionalProperties":false,"required":["returned_count","credits_charged","billing_reason"],"properties":{"returned_count":{"type":"integer"},"credits_per_result":{"type":"integer"},"credits_charged":{"type":"integer"},"billing_reason":{"type":"string"},"max_credits":{"type":"integer","nullable":true},"page_size":{"type":"integer","nullable":true}}},"demo":{"type":"boolean"},"_demo_redactions":{"type":"object","additionalProperties":true},"simulated":{"type":"boolean"},"credits_charged":{"type":"integer"}}},"timestamp":{"type":"string","format":"date-time"}}}}}},"400":{"description":"Bad request — invalid or missing parameter","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"401":{"description":"Unauthorized — missing or unknown API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"402":{"description":"Payment required — max_credits below cost, or plan gate","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"403":{"description":"Forbidden — demo key outside documented templates","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"409":{"description":"Conflict — idempotency reuse or ambiguous ref","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"422":{"description":"Unprocessable entity","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"429":{"description":"Too many requests — credit quota exhausted","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"500":{"description":"Internal server error — request failed before delivery","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"503":{"description":"Service unavailable — search backend down","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-igf-paid":true,"operationId":"licenses_search","description":"Paid ranked License discovery rows"}},"/v1/licenses/resolve":{"get":{"summary":"Resolve license_ref or natural license key","tags":["iGaming License API"],"parameters":[{"name":"license_ref","in":"query","schema":{"type":"string"}},{"name":"license_number","in":"query","schema":{"type":"string"}},{"name":"jurisdiction","in":"query","schema":{"type":"string"}},{"name":"max_credits","in":"query","schema":{"type":"integer","minimum":0}},{"name":"Idempotency-Key","in":"header","required":false,"description":"Stable retry key for one paid operation. Reuse it only when retrying the same request.","schema":{"type":"string"}}],"responses":{"200":{"description":"Resolve license_ref or natural license key","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["success","message","data","timestamp"],"properties":{"success":{"type":"boolean"},"message":{"type":"string"},"data":{"type":"object","additionalProperties":false,"required":["resolved_by","query","input_license_ref","resolved_license_ref","ref_status","matches","licenses","billing"],"properties":{"resolved_by":{"type":"string","nullable":true},"query":{"type":"object"},"input_license_ref":{"type":"string","nullable":true},"resolved_license_ref":{"type":"string","nullable":true},"ref_status":{"type":"string","nullable":true},"matches":{"type":"array","items":{"type":"object"}},"licenses":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["license_ref","jurisdiction","license_number","status","license_type","authorized_domains","issuing_company","first_seen_at","last_seen_at","last_confirmed_at"],"properties":{"license_ref":{"type":"string"},"jurisdiction":{"type":"string","nullable":true},"license_number":{"type":"string","nullable":true},"status":{"type":"string","nullable":true},"license_type":{"type":"string","nullable":true},"authorized_domains":{"type":"array","items":{"$ref":"#/components/schemas/DomainEntry"}},"issuing_company":{"type":"object","nullable":true},"first_seen_at":{"type":"string","format":"date-time","nullable":true},"last_seen_at":{"type":"string","format":"date-time","nullable":true},"last_confirmed_at":{"type":"string","format":"date-time","nullable":true}}}},"billing":{"type":"object","additionalProperties":false,"required":["returned_count","credits_charged","billing_reason"],"properties":{"returned_count":{"type":"integer"},"credits_per_profile":{"type":"integer"},"credits_charged":{"type":"integer"},"billing_reason":{"type":"string"},"max_credits":{"type":"integer","nullable":true},"page_size":{"type":"integer","nullable":true}}},"demo":{"type":"boolean"},"_demo_redactions":{"type":"object","additionalProperties":true},"simulated":{"type":"boolean"},"credits_charged":{"type":"integer"}}},"timestamp":{"type":"string","format":"date-time"}}}}}},"400":{"description":"Bad request — invalid or missing parameter","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"401":{"description":"Unauthorized — missing or unknown API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"402":{"description":"Payment required — max_credits below cost, or plan gate","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"403":{"description":"Forbidden — demo key outside documented templates","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"409":{"description":"Conflict — idempotency reuse or ambiguous ref","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"422":{"description":"Unprocessable entity","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"429":{"description":"Too many requests — credit quota exhausted","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"500":{"description":"Internal server error — request failed before delivery","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"503":{"description":"Service unavailable — search backend down","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-igf-paid":true,"operationId":"licenses_resolve","description":"Resolve license_ref or natural license key"}},"/v1/domains/resolve":{"get":{"summary":"Resolve a casino domain to its trust verdict","tags":["iGaming Domain API"],"parameters":[{"name":"domain","in":"query","required":true,"schema":{"type":"string"}},{"name":"include[]","in":"query","required":false,"description":"Repeat include[] for each requested section.","schema":{"type":"array","items":{"type":"string","enum":["licenses","payment_methods","supplier_brands","affiliate_programs","geo","related_domains","operator_launch_profile","logos","platform_history"]}}},{"name":"max_age_days","in":"query","required":false,"schema":{"type":"integer","minimum":0,"maximum":365}},{"name":"max_credits","in":"query","required":false,"schema":{"type":"integer"}},{"name":"Idempotency-Key","in":"header","required":false,"description":"Stable retry key for one paid operation. Reuse it only when retrying the same request.","schema":{"type":"string"}}],"responses":{"200":{"description":"Domain trust verdict","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["success","message","data","timestamp"],"properties":{"success":{"type":"boolean"},"message":{"type":"string"},"data":{"$ref":"#/components/schemas/DomainVerdict"},"timestamp":{"type":"string","format":"date-time"}}}}}},"400":{"description":"Bad request — invalid or missing parameter","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"401":{"description":"Unauthorized — missing or unknown API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"402":{"description":"Payment required — max_credits below cost, or plan gate","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"403":{"description":"Forbidden — demo key outside documented templates","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"409":{"description":"Conflict — idempotency reuse or ambiguous ref","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"422":{"description":"Unprocessable entity","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"429":{"description":"Too many requests — credit quota exhausted","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"500":{"description":"Internal server error — request failed before delivery","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"503":{"description":"Service unavailable — search backend down","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-igf-paid":true,"operationId":"domains_resolve","description":"Casino domain to trust verdict (licensed/blocklisted/mixed/no_record) + per-geo licensed_by/blocked_by"}},"/v1/domains/search":{"get":{"summary":"The set of domains by verdict/geo/time","tags":["iGaming Domain API"],"parameters":[{"name":"verdict","in":"query","required":true,"schema":{"type":"string","enum":["blocklisted","licensed","mixed"]}},{"name":"geo","in":"query","schema":{"type":"string"}},{"name":"since","in":"query","schema":{"type":"string","format":"date-time"}},{"name":"until","in":"query","schema":{"type":"string","format":"date-time"}},{"name":"dropped_before","in":"query","schema":{"type":"string","format":"date-time"}},{"name":"payment_category","in":"query","schema":{"type":"string"}},{"name":"platform","in":"query","schema":{"type":"string"}},{"name":"page","in":"query","schema":{"type":"integer","minimum":1}},{"name":"per_page","in":"query","schema":{"type":"integer","minimum":1,"maximum":1000}},{"name":"page_size","in":"query","schema":{"type":"integer","minimum":1,"maximum":1000}},{"name":"max_credits","in":"query","schema":{"type":"integer","minimum":0}},{"name":"Idempotency-Key","in":"header","required":false,"description":"Stable retry key for one paid operation. Reuse it only when retrying the same request.","schema":{"type":"string"}}],"responses":{"200":{"description":"The set of domains by verdict/geo/time","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["success","message","data","timestamp"],"properties":{"success":{"type":"boolean"},"message":{"type":"string"},"data":{"type":"object","additionalProperties":false,"required":["domains","page","per_page","total","billing"],"properties":{"domains":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["domain","verdict","licensed_by","blocked_by","platform_present"],"properties":{"domain":{"type":"string"},"verdict":{"type":"string"},"licensed_by":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["geo"],"properties":{"geo":{"type":"string"}}}},"blocked_by":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["geo"],"properties":{"geo":{"type":"string"}}}},"platform_present":{"type":"boolean"}}}},"page":{"type":"integer"},"per_page":{"type":"integer"},"total":{"type":"integer"},"billing":{"type":"object","additionalProperties":false,"required":["returned_count","credits_charged","billing_reason"],"properties":{"returned_count":{"type":"integer"},"credits_per_result":{"type":"integer"},"credits_charged":{"type":"integer"},"billing_reason":{"type":"string"},"max_credits":{"type":"integer","nullable":true},"page_size":{"type":"integer","nullable":true}}},"demo":{"type":"boolean"},"_demo_redactions":{"type":"object","additionalProperties":true},"simulated":{"type":"boolean"},"credits_charged":{"type":"integer"}}},"timestamp":{"type":"string","format":"date-time"}}}}}},"400":{"description":"Bad request — invalid or missing parameter","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"401":{"description":"Unauthorized — missing or unknown API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"402":{"description":"Payment required — max_credits below cost, or plan gate","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"403":{"description":"Forbidden — demo key outside documented templates","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"409":{"description":"Conflict — idempotency reuse or ambiguous ref","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"422":{"description":"Unprocessable entity","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"429":{"description":"Too many requests — credit quota exhausted","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"500":{"description":"Internal server error — request failed before delivery","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"503":{"description":"Service unavailable — search backend down","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-igf-paid":true,"operationId":"domains_search","description":"The set of domains by verdict/geo/time; bulk blocklist/change-feed"}},"/v1/logos/search":{"get":{"summary":"Find a logo by brand, supplier, game or payment-method name","tags":["iGaming Logo API"],"parameters":[{"name":"q","in":"query","required":true,"schema":{"type":"string","minLength":3}},{"name":"kind","in":"query","schema":{"type":"string","enum":["operator_brand","company","supplier_brand","payment_method","game"]}},{"name":"page","in":"query","schema":{"type":"integer","enum":[1]}}],"responses":{"200":{"description":"Find a logo by brand, supplier, game or payment-method name","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["success","message","data","timestamp"],"properties":{"success":{"type":"boolean"},"message":{"type":"string"},"data":{"type":"object","additionalProperties":false,"required":["results","found","found_capped"],"properties":{"results":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["name","kind","slug","domain","logo_url"],"properties":{"name":{"type":"string","nullable":true},"kind":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true},"domain":{"type":"string","nullable":true},"logo_url":{"type":"string","nullable":true}}}},"found":{"type":"integer"},"found_capped":{"type":"boolean"},"demo":{"type":"boolean"},"_demo_redactions":{"type":"object","additionalProperties":true},"simulated":{"type":"boolean"},"credits_charged":{"type":"integer"}}},"timestamp":{"type":"string","format":"date-time"}}}}}},"400":{"description":"Bad request — invalid or missing parameter","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"401":{"description":"Unauthorized — missing or unknown API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"402":{"description":"Payment required — max_credits below cost, or plan gate","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"403":{"description":"Forbidden — demo key outside documented templates","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"409":{"description":"Conflict — idempotency reuse or ambiguous ref","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"422":{"description":"Unprocessable entity","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"429":{"description":"Too many requests — credit quota exhausted","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"500":{"description":"Internal server error — request failed before delivery","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"503":{"description":"Service unavailable — search backend down","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-igf-paid":false,"operationId":"logos_search","description":"Find a logo by brand, supplier, game or payment-method name"}},"/v1/account":{"get":{"summary":"Credit balance and plan info","tags":["iGaming Account API"],"parameters":[],"responses":{"200":{"description":"Credit balance and plan info","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["success","message","data","timestamp"],"properties":{"success":{"type":"boolean"},"message":{"type":"string"},"data":{"type":"object","additionalProperties":false,"required":["plan","credits_granted","credits_used","credits_reserved","available_credits"],"properties":{"plan":{"type":"string","nullable":true},"credits_granted":{"type":"integer","nullable":true},"credits_used":{"type":"integer","nullable":true},"credits_reserved":{"type":"integer","nullable":true},"available_credits":{"type":"integer","nullable":true},"demo":{"type":"boolean"},"_demo_redactions":{"type":"object","additionalProperties":true},"simulated":{"type":"boolean"},"credits_charged":{"type":"integer"}}},"timestamp":{"type":"string","format":"date-time"}}}}}},"400":{"description":"Bad request — invalid or missing parameter","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"401":{"description":"Unauthorized — missing or unknown API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"402":{"description":"Payment required — max_credits below cost, or plan gate","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"403":{"description":"Forbidden — demo key outside documented templates","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"409":{"description":"Conflict — idempotency reuse or ambiguous ref","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"422":{"description":"Unprocessable entity","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"429":{"description":"Too many requests — credit quota exhausted","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"500":{"description":"Internal server error — request failed before delivery","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"503":{"description":"Service unavailable — search backend down","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-igf-paid":false,"operationId":"account_show","description":"Credit balance and plan info"}},"/v1/briefs":{"get":{"summary":"List Sales Intelligence Briefs","tags":["iGaming Sales Intelligence API"],"parameters":[{"name":"status","in":"query","schema":{"type":"string","enum":["requested","preparing","ready"]}},{"name":"cadence","in":"query","schema":{"type":"string","enum":["one_time","weekly","continuous"]}},{"name":"after","in":"query","schema":{"type":"string"}},{"name":"page_size","in":"query","schema":{"type":"integer","minimum":1,"maximum":50,"default":20}}],"responses":{"200":{"description":"List Sales Intelligence Briefs","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["success","message","data","timestamp"],"properties":{"success":{"type":"boolean"},"message":{"type":"string"},"data":{"type":"object","additionalProperties":false,"required":["briefs","next_cursor"],"properties":{"briefs":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["brief_ref","status","cadence","prompt","requested_at","delivery_on","due_at","ready_at","target_account_count","download_path"],"properties":{"brief_ref":{"type":"string"},"status":{"type":"string","enum":["requested","preparing","ready"]},"cadence":{"type":"string","enum":["one_time","weekly","continuous"]},"prompt":{"type":"string"},"requested_at":{"type":"string","format":"date-time"},"delivery_on":{"type":"string","format":"date"},"due_at":{"type":"string","format":"date-time","nullable":true},"ready_at":{"type":"string","format":"date-time","nullable":true},"target_account_count":{"type":"integer","nullable":true},"download_path":{"type":"string","nullable":true}}}},"next_cursor":{"type":"string","nullable":true},"demo":{"type":"boolean"},"_demo_redactions":{"type":"object","additionalProperties":true},"simulated":{"type":"boolean"},"credits_charged":{"type":"integer"}}},"timestamp":{"type":"string","format":"date-time"}}}}}},"400":{"description":"Bad request — invalid or missing parameter","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"401":{"description":"Unauthorized — missing or unknown API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"402":{"description":"Payment required — max_credits below cost, or plan gate","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"403":{"description":"Forbidden — demo key outside documented templates","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"409":{"description":"Conflict — idempotency reuse or ambiguous ref","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"422":{"description":"Unprocessable entity","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"429":{"description":"Too many requests — credit quota exhausted","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"500":{"description":"Internal server error — request failed before delivery","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"503":{"description":"Service unavailable — search backend down","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-igf-paid":false,"operationId":"briefs_list","description":"List Sales Intelligence Briefs"}},"/v1/briefs/{brief_ref}":{"get":{"summary":"Show a Sales Intelligence Brief","tags":["iGaming Sales Intelligence API"],"parameters":[{"name":"brief_ref","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Show a Sales Intelligence Brief","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["success","message","data","timestamp"],"properties":{"success":{"type":"boolean"},"message":{"type":"string"},"data":{"type":"object","additionalProperties":false,"required":["brief_ref","status","cadence","prompt","requested_at","delivery_on","due_at","ready_at","target_account_count","download_path","result"],"properties":{"brief_ref":{"type":"string"},"status":{"type":"string","enum":["requested","preparing","ready"]},"cadence":{"type":"string","enum":["one_time","weekly","continuous"]},"prompt":{"type":"string"},"requested_at":{"type":"string","format":"date-time"},"delivery_on":{"type":"string","format":"date"},"due_at":{"type":"string","format":"date-time","nullable":true},"ready_at":{"type":"string","format":"date-time","nullable":true},"target_account_count":{"type":"integer","nullable":true},"download_path":{"type":"string","nullable":true},"result":{"type":"object","additionalProperties":false,"required":["schema_version","request_interpretation","executive_summary","target_accounts","citations"],"properties":{"schema_version":{"type":"integer","enum":[1]},"request_interpretation":{"type":"object","additionalProperties":false,"required":["journey","summary"],"properties":{"journey":{"type":"string","enum":["sell_into_igaming","go_to_market_in_igaming"]},"summary":{"type":"string","minLength":20,"maxLength":2000}}},"executive_summary":{"type":"string","minLength":20,"maxLength":5000},"target_accounts":{"type":"array","minItems":1,"maxItems":100,"items":{"type":"object","additionalProperties":false,"required":["target_ref","name","website","candidate_organizations","why_this_account","why_now","confidence","evidence_refs","outreach_angles","key_contacts","crm_tasks"],"properties":{"target_ref":{"type":"string","pattern":"^igf[a-z]+_[A-Za-z0-9_-]{8,64}$"},"name":{"type":"string","minLength":1,"maxLength":300},"website":{"type":"string","format":"uri","pattern":"^https://","maxLength":2048,"nullable":true},"candidate_organizations":{"type":"array","minItems":0,"maxItems":20,"items":{"type":"object","additionalProperties":false,"required":["name","role","confidence","evidence_refs"],"properties":{"name":{"type":"string","minLength":1,"maxLength":300},"role":{"type":"string","enum":["licensee","brand","operating_organization_candidate","employer","regional_organization","legacy_profile","other_candidate"]},"confidence":{"type":"string","enum":["low","medium","high"]},"evidence_refs":{"type":"array","minItems":1,"maxItems":50,"uniqueItems":true,"items":{"type":"string","pattern":"^igf[a-z]+_[A-Za-z0-9_-]{8,64}$"}}}}},"why_this_account":{"type":"string","minLength":1,"maxLength":5000},"why_now":{"type":"string","minLength":1,"maxLength":5000},"confidence":{"type":"string","enum":["low","medium","high"]},"evidence_refs":{"type":"array","minItems":1,"maxItems":50,"uniqueItems":true,"items":{"type":"string","pattern":"^igf[a-z]+_[A-Za-z0-9_-]{8,64}$"}},"outreach_angles":{"type":"array","minItems":0,"maxItems":20,"items":{"type":"string","minLength":1,"maxLength":1000}},"key_contacts":{"type":"array","minItems":0,"maxItems":20,"items":{"type":"object","additionalProperties":false,"required":["contact_ref","name","role","professional_profile_url","professional_context","business_network_context","contact_channels","confidence","evidence_refs","email_draft","direct_message_draft"],"properties":{"contact_ref":{"type":"string","pattern":"^igf[a-z]+_[A-Za-z0-9_-]{8,64}$"},"name":{"type":"string","minLength":1,"maxLength":300},"role":{"type":"string","minLength":1,"maxLength":300,"nullable":true},"professional_profile_url":{"type":"string","format":"uri","pattern":"^https://","maxLength":2048,"nullable":true},"professional_context":{"type":"string","minLength":1,"maxLength":5000,"nullable":true},"business_network_context":{"type":"string","minLength":1,"maxLength":5000,"nullable":true},"contact_channels":{"type":"array","minItems":0,"maxItems":5,"items":{"type":"object","additionalProperties":false,"required":["kind","value","verification","evidence_refs"],"properties":{"kind":{"type":"string","enum":["email"]},"value":{"type":"string","format":"email"},"verification":{"type":"string","enum":["verified"]},"evidence_refs":{"type":"array","minItems":1,"maxItems":50,"uniqueItems":true,"items":{"type":"string","pattern":"^igf[a-z]+_[A-Za-z0-9_-]{8,64}$"}}}}},"confidence":{"type":"string","enum":["low","medium","high"]},"evidence_refs":{"type":"array","minItems":1,"maxItems":50,"uniqueItems":true,"items":{"type":"string","pattern":"^igf[a-z]+_[A-Za-z0-9_-]{8,64}$"}},"email_draft":{"type":"object","additionalProperties":false,"required":["subject","body"],"properties":{"subject":{"type":"string","minLength":1,"maxLength":300},"body":{"type":"string","minLength":1,"maxLength":10000}},"nullable":true},"direct_message_draft":{"type":"object","additionalProperties":false,"required":["body"],"properties":{"body":{"type":"string","minLength":1,"maxLength":5000}},"nullable":true}}}},"crm_tasks":{"type":"array","minItems":0,"maxItems":20,"items":{"type":"object","additionalProperties":false,"required":["title","description"],"properties":{"title":{"type":"string","minLength":1,"maxLength":300},"description":{"type":"string","minLength":1,"maxLength":5000}}}}}}},"citations":{"type":"array","minItems":1,"maxItems":500,"items":{"type":"object","additionalProperties":false,"required":["citation_ref","label","url","observed_at"],"properties":{"citation_ref":{"type":"string","pattern":"^igf[a-z]+_[A-Za-z0-9_-]{8,64}$"},"label":{"type":"string","minLength":1,"maxLength":500},"url":{"type":"string","format":"uri","pattern":"^https://","maxLength":2048},"observed_at":{"type":"string","format":"date-time","nullable":true}}}}},"nullable":true},"demo":{"type":"boolean"},"_demo_redactions":{"type":"object","additionalProperties":true},"simulated":{"type":"boolean"},"credits_charged":{"type":"integer"}}},"timestamp":{"type":"string","format":"date-time"}}}}}},"400":{"description":"Bad request — invalid or missing parameter","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"401":{"description":"Unauthorized — missing or unknown API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"402":{"description":"Payment required — max_credits below cost, or plan gate","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"403":{"description":"Forbidden — demo key outside documented templates","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"409":{"description":"Conflict — idempotency reuse or ambiguous ref","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"422":{"description":"Unprocessable entity","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"429":{"description":"Too many requests — credit quota exhausted","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"500":{"description":"Internal server error — request failed before delivery","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"503":{"description":"Service unavailable — search backend down","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-igf-paid":false,"operationId":"briefs_show","description":"Show a Sales Intelligence Brief"}},"/v1/briefs/{brief_ref}/download":{"get":{"summary":"Download a ready Sales Intelligence Brief as CSV","tags":["iGaming Sales Intelligence API"],"responses":{"200":{"description":"Ready Sales Intelligence Brief CSV attachment","headers":{"Content-Disposition":{"description":"attachment; filename=\"sales-intelligence-{brief_ref}.csv\"","schema":{"type":"string"}}},"content":{"text/csv; charset=utf-8":{"schema":{"type":"string","format":"binary"}}}},"401":{"description":"Unauthorized — missing or unknown API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"409":{"description":"Conflict — Brief is not ready","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-igf-paid":false,"parameters":[{"name":"brief_ref","in":"path","required":true,"schema":{"type":"string"}}],"operationId":"briefs_download","description":"Download a ready Sales Intelligence Brief as CSV"}},"/v1/exports":{"post":{"summary":"Create CSV/JSON export","tags":["iGaming Export API"],"parameters":[{"name":"Idempotency-Key","in":"header","required":false,"description":"Stable retry key for one paid operation. Reuse it only when retrying the same request.","schema":{"type":"string"}}],"responses":{"202":{"description":"Create CSV/JSON export","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["success","message","data","timestamp"],"properties":{"success":{"type":"boolean"},"message":{"type":"string"},"data":{"type":"object","additionalProperties":false,"required":["export_id","poll_url","status"],"properties":{"export_id":{"oneOf":[{"type":"integer"},{"type":"string"}]},"poll_url":{"type":"string"},"status":{"type":"string"},"demo":{"type":"boolean"},"_demo_redactions":{"type":"object","additionalProperties":true},"simulated":{"type":"boolean"},"credits_charged":{"type":"integer"}}},"timestamp":{"type":"string","format":"date-time"}}}}}},"400":{"description":"Bad request — invalid or missing parameter","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"401":{"description":"Unauthorized — missing or unknown API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"402":{"description":"Payment required — max_credits below cost, or plan gate","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"403":{"description":"Forbidden — demo key outside documented templates","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"409":{"description":"Conflict — idempotency reuse or ambiguous ref","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"422":{"description":"Unprocessable entity","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"429":{"description":"Too many requests — credit quota exhausted","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"500":{"description":"Internal server error — request failed before delivery","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"503":{"description":"Service unavailable — search backend down","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"export_format":{"type":"string","enum":["csv","json"],"default":"csv"},"filters":{"type":"object","additionalProperties":true},"fields":{"type":"array","items":{"type":"string"}}}}}}},"x-igf-paid":true,"operationId":"exports_create","description":"Create CSV/JSON export"}},"/v1/exports/{id}":{"get":{"summary":"Poll export status","tags":["iGaming Export API"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Poll export status","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["success","message","data","timestamp"],"properties":{"success":{"type":"boolean"},"message":{"type":"string"},"data":{"type":"object","additionalProperties":false,"required":["id","status","format","created_at","download_url","total_rows","credits_used","expires_at"],"properties":{"id":{"oneOf":[{"type":"integer"},{"type":"string"}]},"status":{"type":"string"},"format":{"type":"string"},"created_at":{"type":"string","format":"date-time"},"download_url":{"type":"string","nullable":true},"total_rows":{"type":"integer","nullable":true},"credits_used":{"type":"integer","nullable":true},"expires_at":{"type":"string","format":"date-time","nullable":true},"demo":{"type":"boolean"},"_demo_redactions":{"type":"object","additionalProperties":true},"simulated":{"type":"boolean"},"credits_charged":{"type":"integer"}}},"timestamp":{"type":"string","format":"date-time"}}}}}},"400":{"description":"Bad request — invalid or missing parameter","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"401":{"description":"Unauthorized — missing or unknown API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"402":{"description":"Payment required — max_credits below cost, or plan gate","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"403":{"description":"Forbidden — demo key outside documented templates","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"409":{"description":"Conflict — idempotency reuse or ambiguous ref","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"422":{"description":"Unprocessable entity","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"429":{"description":"Too many requests — credit quota exhausted","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"500":{"description":"Internal server error — request failed before delivery","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"503":{"description":"Service unavailable — search backend down","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-igf-paid":false,"operationId":"exports_show","description":"Poll export status"}},"/v1/exports/{id}/download":{"get":{"summary":"Download completed export","tags":["iGaming Export API"],"responses":{"200":{"description":"Completed export attachment","content":{"text/csv":{"schema":{"type":"string","format":"binary"}},"application/json":{"schema":{"type":"string","format":"binary"}}}},"401":{"description":"Unauthorized — missing or unknown API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"500":{"description":"Internal server error — request failed before delivery","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-igf-paid":false,"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"operationId":"exports_download","description":"Download completed export"}}}}