{"openapi":"3.1.0","info":{"title":"MapBulk API","version":"1.0"},"paths":{"/v1/billing/checkout":{"post":{"summary":"Checkout","operationId":"checkout_v1_billing_checkout_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Body_checkout_v1_billing_checkout_post"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Checkout V1 Billing Checkout Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"MapBulkBearer":[]}]}},"/health/live":{"get":{"summary":"Live","operationId":"live_health_live_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Live Health Live Get"}}}}}}},"/health/ready":{"get":{"summary":"Ready","operationId":"ready_health_ready_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Ready Health Ready Get"}}}}}}},"/v1/public/contact":{"post":{"summary":"Contact","operationId":"contact_v1_public_contact_post","parameters":[{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","minLength":32,"maxLength":200,"title":"Idempotency-Key"}},{"name":"CF-Connecting-IP","in":"header","required":true,"schema":{"type":"string","format":"ipvanyaddress","title":"Cf-Connecting-Ip"}},{"name":"CF-Turnstile-Response","in":"header","required":false,"schema":{"anyOf":[{"type":"string","maxLength":2048},{"type":"null"}],"title":"Cf-Turnstile-Response"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/public/session":{"get":{"summary":"Public Session","operationId":"public_session_v1_public_session_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Public Session V1 Public Session Get"}}}}}}},"/v1/public/sample":{"post":{"summary":"Public Sample","operationId":"public_sample_v1_public_sample_post","parameters":[{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","minLength":32,"maxLength":200,"title":"Idempotency-Key"}},{"name":"CF-Connecting-IP","in":"header","required":true,"schema":{"type":"string","format":"ipvanyaddress","title":"Cf-Connecting-Ip"}},{"name":"CF-Ray","in":"header","required":true,"schema":{"type":"string","pattern":"^[0-9a-f]{16,32}-[A-Z]{3}$","title":"Cf-Ray"}},{"name":"CF-Turnstile-Response","in":"header","required":false,"schema":{"anyOf":[{"type":"string","maxLength":2048},{"type":"null"}],"title":"Cf-Turnstile-Response"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicSampleCreate"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicSampleResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/public/sample/claim":{"post":{"summary":"Claim Sample","operationId":"claim_sample_v1_public_sample_claim_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Body_claim_sample_v1_public_sample_claim_post"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Claim Sample V1 Public Sample Claim Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"MapBulkBearer":[]}]}},"/v1/categories":{"get":{"summary":"Categories","operationId":"categories_v1_categories_get","parameters":[{"name":"version","in":"query","required":false,"schema":{"anyOf":[{"type":"string","pattern":"^[a-f0-9]{16}$"},{"type":"null"}],"title":"Version"}},{"name":"query","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":100},{"type":"null"}],"title":"Query"}},{"name":"parent_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":160},{"type":"null"}],"title":"Parent Id"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","maximum":6000,"minimum":0,"default":0,"title":"Offset"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":50,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/me":{"get":{"summary":"Me","operationId":"me_v1_me_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Me V1 Me Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"MapBulkBearer":[]}]}},"/v1/account/acceptance":{"post":{"summary":"Accept Account","operationId":"accept_account_v1_account_acceptance_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AccountAcceptance"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"MapBulkBearer":[]}]}},"/v1/marketing/conversions":{"post":{"summary":"Marketing Conversions","operationId":"marketing_conversions_v1_marketing_conversions_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"MapBulkBearer":[]}]}},"/v1/invoices":{"get":{"summary":"List Invoices","operationId":"list_invoices_v1_invoices_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"items":{},"type":"array","title":"Response List Invoices V1 Invoices Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"MapBulkBearer":[]}]}},"/v1/invoices/{invoice_id}/pdf":{"get":{"summary":"Invoice Pdf","operationId":"invoice_pdf_v1_invoices__invoice_id__pdf_get","security":[{"MapBulkBearer":[]}],"parameters":[{"name":"invoice_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Invoice Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/usage":{"get":{"summary":"Usage","operationId":"usage_v1_usage_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UsageRecord"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"MapBulkBearer":[]}]}},"/v1/api-keys":{"get":{"summary":"Api Keys","operationId":"api_keys_v1_api_keys_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Response Api Keys V1 Api Keys Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"MapBulkBearer":[]}]},"post":{"summary":"Create Key","operationId":"create_key_v1_api_keys_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiKeyCreate"}}},"required":true},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Create Key V1 Api Keys Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"MapBulkBearer":[]}]}},"/v1/api-keys/{key_id}":{"delete":{"summary":"Revoke Key","operationId":"revoke_key_v1_api_keys__key_id__delete","security":[{"MapBulkBearer":[]}],"parameters":[{"name":"key_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Key Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Revoke Key V1 Api Keys  Key Id  Delete"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/search-planning":{"post":{"summary":"Search Planning","operationId":"search_planning_v1_search_planning_post","security":[{"MapBulkBearer":[]}],"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","title":"Idempotency-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/PlanningResponseV2"},{"$ref":"#/components/schemas/PlanningResponse"}],"title":"Response Search Planning V1 Search Planning Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/searches":{"post":{"summary":"Create Search","operationId":"create_search_v1_searches_post","security":[{"MapBulkBearer":[]}],"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","minLength":8,"maxLength":200,"title":"Idempotency-Key"}},{"name":"X-MapBulk-Client","in":"header","required":false,"schema":{"type":"string","default":"api","title":"X-Mapbulk-Client"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SearchCreate"}}}},"responses":{"202":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CampaignRecord"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"get":{"summary":"Searches","operationId":"searches_v1_searches_get","security":[{"MapBulkBearer":[]}],"parameters":[{"name":"cursor","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":512},{"type":"null"}],"title":"Cursor"}},{"name":"limit","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","maximum":100,"minimum":1},{"type":"null"}],"title":"Limit"}},{"name":"source","in":"query","required":false,"schema":{"anyOf":[{"enum":["extension","dashboard","api","mcp"],"type":"string"},{"type":"null"}],"title":"Source"}},{"name":"q","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":160},{"type":"null"}],"title":"Q"}},{"name":"view","in":"query","required":false,"schema":{"enum":["full","summary"],"type":"string","default":"full","title":"View"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"anyOf":[{"type":"array","items":{"$ref":"#/components/schemas/CampaignRecord"}},{"$ref":"#/components/schemas/CampaignCursorPage"},{"type":"array","items":{"$ref":"#/components/schemas/CampaignSummary"}},{"$ref":"#/components/schemas/CampaignSummaryPage"}],"title":"Response Searches V1 Searches Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/imports":{"post":{"summary":"Create Import","operationId":"create_import_v1_imports_post","security":[{"MapBulkBearer":[]}],"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","minLength":8,"maxLength":200,"title":"Idempotency-Key"}},{"name":"X-MapBulk-Client","in":"header","required":false,"schema":{"type":"string","default":"api","title":"X-Mapbulk-Client"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExternalImportCreate"}}}},"responses":{"202":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CampaignRecord"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/imports/{campaign_id}/batches":{"post":{"summary":"Import Batch","operationId":"import_batch_v1_imports__campaign_id__batches_post","security":[{"MapBulkBearer":[]}],"parameters":[{"name":"campaign_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Campaign Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExternalImportBatch"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BatchAck"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/imports/{campaign_id}/complete":{"post":{"summary":"Complete Import","operationId":"complete_import_v1_imports__campaign_id__complete_post","security":[{"MapBulkBearer":[]}],"parameters":[{"name":"campaign_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Campaign Id"}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","minLength":8,"maxLength":200,"title":"Idempotency-Key"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExternalImportComplete"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CampaignRecord"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/searches/{campaign_id}":{"get":{"summary":"Search","operationId":"search_v1_searches__campaign_id__get","security":[{"MapBulkBearer":[]}],"parameters":[{"name":"campaign_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Campaign Id"}},{"name":"view","in":"query","required":false,"schema":{"enum":["full","summary"],"type":"string","default":"full","title":"View"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/CampaignRecord"},{"$ref":"#/components/schemas/CampaignSummary"}],"title":"Response Search V1 Searches  Campaign Id  Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/searches/{campaign_id}/results":{"get":{"summary":"Results","operationId":"results_v1_searches__campaign_id__results_get","security":[{"MapBulkBearer":[]}],"parameters":[{"name":"campaign_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Campaign Id"}},{"name":"cursor","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cursor"}},{"name":"has_email","in":"query","required":false,"schema":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Has Email"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":20,"minimum":1,"default":20,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/LeadCursorPage"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/leads":{"get":{"summary":"Leads","operationId":"leads_v1_leads_get","security":[{"MapBulkBearer":[]}],"parameters":[{"name":"campaign_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Campaign Id"}},{"name":"cursor","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cursor"}},{"name":"has_email","in":"query","required":false,"schema":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Has Email"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":20,"minimum":1,"default":20,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/LeadCursorPage"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/searches/{campaign_id}/issues":{"get":{"summary":"Issues","operationId":"issues_v1_searches__campaign_id__issues_get","security":[{"MapBulkBearer":[]}],"parameters":[{"name":"campaign_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Campaign Id"}},{"name":"cursor","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cursor"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":20,"minimum":1,"default":20,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Issues V1 Searches  Campaign Id  Issues Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/searches/{campaign_id}/cancel":{"post":{"summary":"Cancel","operationId":"cancel_v1_searches__campaign_id__cancel_post","security":[{"MapBulkBearer":[]}],"parameters":[{"name":"campaign_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Campaign Id"}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","minLength":8,"maxLength":200,"title":"Idempotency-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CampaignRecord"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/searches/{campaign_id}/retry":{"post":{"summary":"Retry","operationId":"retry_v1_searches__campaign_id__retry_post","security":[{"MapBulkBearer":[]}],"parameters":[{"name":"campaign_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Campaign Id"}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","minLength":8,"maxLength":200,"title":"Idempotency-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CampaignRecord"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/searches/estimate":{"post":{"summary":"Estimate Search","operationId":"estimate_search_v1_searches_estimate_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SearchCreate"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Estimate Search V1 Searches Estimate Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"MapBulkBearer":[]}]}},"/v1/searches/{campaign_id}/enrichment-quote":{"get":{"summary":"Enrichment Quote","operationId":"enrichment_quote_v1_searches__campaign_id__enrichment_quote_get","security":[{"MapBulkBearer":[]}],"parameters":[{"name":"campaign_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Campaign Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Enrichment Quote V1 Searches  Campaign Id  Enrichment Quote Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/searches/{campaign_id}/enrich":{"post":{"summary":"Enrich","operationId":"enrich_v1_searches__campaign_id__enrich_post","security":[{"MapBulkBearer":[]}],"parameters":[{"name":"campaign_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Campaign Id"}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","minLength":8,"maxLength":200,"title":"Idempotency-Key"}}],"requestBody":{"content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/EnrichRequest"},{"type":"null"}],"title":"Body"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EnrichedCampaign"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/extension/campaigns":{"post":{"summary":"Extension Campaign","operationId":"extension_campaign_v1_extension_campaigns_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExtensionCampaignCreate"}}},"required":true},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CampaignRecord"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"MapBulkBearer":[]}]}},"/v1/extension/campaigns/{campaign_id}/batches":{"post":{"summary":"Extension Batch","operationId":"extension_batch_v1_extension_campaigns__campaign_id__batches_post","security":[{"MapBulkBearer":[]}],"parameters":[{"name":"campaign_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Campaign Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SyncBatch"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BatchAck"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/extension/campaigns/{campaign_id}/complete":{"post":{"summary":"Extension Complete","operationId":"extension_complete_v1_extension_campaigns__campaign_id__complete_post","security":[{"MapBulkBearer":[]}],"parameters":[{"name":"campaign_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Campaign Id"}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","minLength":8,"maxLength":200,"title":"Idempotency-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CampaignRecord"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/searches/{campaign_id}/exports":{"post":{"summary":"Exports","operationId":"exports_v1_searches__campaign_id__exports_post","security":[{"MapBulkBearer":[]}],"parameters":[{"name":"campaign_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Campaign Id"}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","minLength":8,"maxLength":200,"title":"Idempotency-Key"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExportRequest"}}}},"responses":{"202":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/ArtifactRecord"},"title":"Response Exports V1 Searches  Campaign Id  Exports Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/artifacts/{artifact_id}":{"get":{"summary":"Artifact","operationId":"artifact_v1_artifacts__artifact_id__get","security":[{"MapBulkBearer":[]}],"parameters":[{"name":"artifact_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Artifact Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ArtifactRecord"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/artifacts/{artifact_id}/download":{"get":{"summary":"Download","operationId":"download_v1_artifacts__artifact_id__download_get","parameters":[{"name":"artifact_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Artifact Id"}},{"name":"workspace","in":"query","required":true,"schema":{"type":"string","format":"uuid","title":"Workspace"}},{"name":"exp","in":"query","required":true,"schema":{"type":"integer","title":"Exp"}},{"name":"sig","in":"query","required":true,"schema":{"type":"string","title":"Sig"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/artifacts/{artifact_id}/content":{"get":{"summary":"Authenticated Download","operationId":"authenticated_download_v1_artifacts__artifact_id__content_get","security":[{"MapBulkBearer":[]}],"parameters":[{"name":"artifact_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Artifact Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/account":{"delete":{"summary":"Delete Account","operationId":"delete_account_v1_account_delete","responses":{"202":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AccountDeletionRecord"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"MapBulkBearer":[]}]}}},"components":{"schemas":{"AccountAcceptance":{"properties":{"accepted":{"type":"boolean","title":"Accepted"},"termsVersion":{"type":"string","title":"Termsversion"},"privacyVersion":{"type":"string","title":"Privacyversion"}},"additionalProperties":false,"type":"object","required":["accepted","termsVersion","privacyVersion"],"title":"AccountAcceptance"},"AccountDeletionRecord":{"properties":{"status":{"type":"string","const":"tombstoned","title":"Status"}},"type":"object","required":["status"],"title":"AccountDeletionRecord"},"ApiKeyCreate":{"properties":{"name":{"type":"string","maxLength":80,"minLength":1,"title":"Name","default":"Default"},"scopes":{"items":{"type":"string","enum":["read","write"]},"type":"array","maxItems":2,"minItems":1,"title":"Scopes"}},"type":"object","title":"ApiKeyCreate"},"ArtifactRecord":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"campaign_id":{"type":"string","format":"uuid","title":"Campaign Id"},"format":{"type":"string","enum":["csv","json","xlsx"],"title":"Format"},"status":{"type":"string","enum":["queued","building","ready","failed","expired"],"title":"Status"},"selection_hash":{"type":"string","pattern":"^[0-9a-f]{64}$","title":"Selection Hash"},"file_sha256":{"anyOf":[{"type":"string","pattern":"^[0-9a-f]{64}$"},{"type":"null"}],"title":"File Sha256"},"byte_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Byte Count"},"row_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Row Count"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"ready_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Ready At"},"expires_at":{"type":"string","format":"date-time","title":"Expires At"},"download_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Download Url"},"export_version":{"type":"integer","title":"Export Version"}},"type":"object","required":["id","campaign_id","format","status","selection_hash","created_at","expires_at","export_version"],"title":"ArtifactRecord"},"BatchAck":{"properties":{"campaign_id":{"type":"string","format":"uuid","title":"Campaign Id"},"batch_id":{"type":"string","format":"uuid","title":"Batch Id"},"sequence":{"type":"integer","title":"Sequence"},"payload_hash":{"type":"string","title":"Payload Hash"},"accepted":{"type":"integer","title":"Accepted"},"duplicates":{"type":"integer","title":"Duplicates"},"replayed":{"type":"boolean","title":"Replayed"}},"type":"object","required":["campaign_id","batch_id","sequence","payload_hash","accepted","duplicates","replayed"],"title":"BatchAck"},"Body_checkout_v1_billing_checkout_post":{"properties":{"plan":{"type":"string","maxLength":32,"minLength":1,"title":"Plan"},"confirmation":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Confirmation"}},"type":"object","required":["plan"],"title":"Body_checkout_v1_billing_checkout_post"},"Body_claim_sample_v1_public_sample_claim_post":{"properties":{"sample_key":{"anyOf":[{"type":"string","maxLength":200,"minLength":32},{"type":"null"}],"title":"Sample Key"}},"type":"object","title":"Body_claim_sample_v1_public_sample_claim_post"},"Budget":{"properties":{"mode":{"type":"string","enum":["finite","available_balance"],"title":"Mode"},"maximum_credit_units":{"anyOf":[{"type":"integer","maximum":9007199254740991.0,"minimum":1.0},{"type":"null"}],"title":"Maximum Credit Units"}},"additionalProperties":false,"type":"object","required":["mode","maximum_credit_units"],"title":"Budget"},"CampaignCursorPage":{"properties":{"items":{"items":{"$ref":"#/components/schemas/CampaignRecord"},"type":"array","title":"Items"},"next_cursor":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Next Cursor"}},"type":"object","required":["items","next_cursor"],"title":"CampaignCursorPage"},"CampaignProgress":{"properties":{"website_count":{"type":"integer","title":"Website Count"},"processed_count":{"type":"integer","title":"Processed Count"},"pending_count":{"type":"integer","title":"Pending Count"},"unavailable_count":{"type":"integer","title":"Unavailable Count"}},"type":"object","required":["website_count","processed_count","pending_count","unavailable_count"],"title":"CampaignProgress"},"CampaignRecord":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"source":{"type":"string","enum":["extension","dashboard","api","mcp"],"title":"Source"},"campaign_kind":{"type":"string","enum":["maps","extension_sync","external_import"],"title":"Campaign Kind"},"pricing_contract":{"type":"string","enum":["legacy_v1","combined_v2","maps_v2","enrichment_v2"],"title":"Pricing Contract","default":"legacy_v1","readOnly":true},"status":{"type":"string","enum":["running","needs_attention","completed","partial","failed","cancelled"],"title":"Status"},"name":{"type":"string","title":"Name"},"query":{"type":"string","title":"Query"},"result_mode":{"anyOf":[{"type":"string","enum":["leads","emails","all"]},{"type":"null"}],"title":"Result Mode"},"target_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Target Count"},"only_with_email":{"type":"boolean","title":"Only With Email","default":false},"stop_reason":{"anyOf":[{"type":"string","enum":["target","budget","coverage"]},{"type":"null"}],"title":"Stop Reason"},"source_limited":{"type":"boolean","title":"Source Limited","default":false,"readOnly":true},"retryable_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Retryable Count","readOnly":true},"extension_running":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Extension Running","readOnly":true},"enrichable_websites":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Enrichable Websites","readOnly":true},"country_code":{"type":"string","title":"Country Code"},"result_cap":{"type":"integer","title":"Result Cap"},"enrichment_requested":{"type":"boolean","title":"Enrichment Requested"},"maximum_credit_units":{"type":"integer","title":"Maximum Credit Units"},"delivered_count":{"type":"integer","title":"Delivered Count"},"email_count":{"type":"integer","title":"Email Count"},"issue_count":{"type":"integer","title":"Issue Count"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"updated_at":{"type":"string","format":"date-time","title":"Updated At"},"completed_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Completed At"},"progress":{"anyOf":[{"$ref":"#/components/schemas/CampaignProgress"},{"type":"null"}]},"keywords":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Keywords"},"geographies":{"anyOf":[{"items":{"$ref":"#/components/schemas/SearchGeography"},"type":"array"},{"type":"null"}],"title":"Geographies"},"locations":{"items":{"type":"string"},"type":"array","title":"Locations"},"category_selection":{"anyOf":[{"$ref":"#/components/schemas/CategorySelection"},{"type":"null"}]}},"type":"object","required":["id","source","campaign_kind","status","name","query","country_code","result_cap","enrichment_requested","maximum_credit_units","delivered_count","email_count","issue_count","created_at","updated_at","completed_at","locations"],"title":"CampaignRecord"},"CampaignSummary":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"source":{"type":"string","enum":["extension","dashboard","api","mcp"],"title":"Source"},"campaign_kind":{"type":"string","enum":["maps","extension_sync","external_import"],"title":"Campaign Kind"},"pricing_contract":{"type":"string","enum":["legacy_v1","combined_v2","maps_v2","enrichment_v2"],"title":"Pricing Contract","default":"legacy_v1","readOnly":true},"status":{"type":"string","enum":["running","needs_attention","completed","partial","failed","cancelled"],"title":"Status"},"name":{"type":"string","title":"Name"},"query":{"type":"string","title":"Query"},"result_mode":{"anyOf":[{"type":"string","enum":["leads","emails","all"]},{"type":"null"}],"title":"Result Mode"},"target_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Target Count"},"only_with_email":{"type":"boolean","title":"Only With Email","default":false},"stop_reason":{"anyOf":[{"type":"string","enum":["target","budget","coverage"]},{"type":"null"}],"title":"Stop Reason"},"source_limited":{"type":"boolean","title":"Source Limited","default":false,"readOnly":true},"retryable_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Retryable Count","readOnly":true},"extension_running":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Extension Running","readOnly":true},"enrichable_websites":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Enrichable Websites","readOnly":true},"country_code":{"type":"string","title":"Country Code"},"result_cap":{"type":"integer","title":"Result Cap"},"enrichment_requested":{"type":"boolean","title":"Enrichment Requested"},"maximum_credit_units":{"type":"integer","title":"Maximum Credit Units"},"delivered_count":{"type":"integer","title":"Delivered Count"},"email_count":{"type":"integer","title":"Email Count"},"issue_count":{"type":"integer","title":"Issue Count"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"updated_at":{"type":"string","format":"date-time","title":"Updated At"},"completed_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Completed At"},"progress":{"anyOf":[{"$ref":"#/components/schemas/CampaignProgress"},{"type":"null"}]}},"type":"object","required":["id","source","campaign_kind","status","name","query","country_code","result_cap","enrichment_requested","maximum_credit_units","delivered_count","email_count","issue_count","created_at","updated_at","completed_at"],"title":"CampaignSummary"},"CampaignSummaryPage":{"properties":{"items":{"items":{"$ref":"#/components/schemas/CampaignSummary"},"type":"array","title":"Items"},"next_cursor":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Next Cursor"}},"type":"object","required":["items","next_cursor"],"title":"CampaignSummaryPage"},"CanonicalProposal":{"properties":{"category_nodes":{"anyOf":[{"items":{"type":"string","pattern":"^(?:gcid|group|branch):[a-z0-9_:-]+$"},"type":"array","maxItems":1000},{"type":"null"}],"title":"Category Nodes"},"target":{"anyOf":[{"$ref":"#/components/schemas/Target"},{"type":"null"}]},"enrichment":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Enrichment"},"only_with_email":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Only With Email"},"budget":{"anyOf":[{"$ref":"#/components/schemas/Budget"},{"type":"null"}]}},"additionalProperties":false,"type":"object","required":["category_nodes","target","enrichment","only_with_email","budget"],"title":"CanonicalProposal"},"CanonicalState":{"properties":{"catalog_version":{"type":"string","pattern":"^[a-f0-9]{16}$","title":"Catalog Version"},"proposal":{"$ref":"#/components/schemas/CanonicalProposal"},"location_scopes":{"items":{"$ref":"#/components/schemas/CatalogScope"},"type":"array","maxItems":100,"title":"Location Scopes"}},"additionalProperties":false,"type":"object","required":["catalog_version","proposal","location_scopes"],"title":"CanonicalState"},"CatalogScope":{"properties":{"country_code":{"type":"string","pattern":"^[A-Z]{2}$","title":"Country Code"},"kind":{"type":"string","enum":["country","region","city"],"title":"Kind"},"name":{"type":"string","maxLength":100,"minLength":1,"pattern":"^[^\\x00-\\x1f\\x7f:\\\\@]+$","title":"Name"},"coverage":{"anyOf":[{"type":"string","enum":["recommended","all"]},{"type":"null"}],"title":"Coverage"},"exclude":{"type":"boolean","title":"Exclude"},"location_id":{"anyOf":[{"type":"string","pattern":"^[A-Z]{2}:[A-Za-z0-9_-]+$"},{"type":"null"}],"title":"Location Id"},"region":{"anyOf":[{"type":"string","maxLength":100,"minLength":1,"pattern":"^[^\\x00-\\x1f\\x7f:\\\\@]+$"},{"type":"null"}],"title":"Region"}},"additionalProperties":false,"type":"object","required":["country_code","kind","name","coverage","exclude","location_id","region"],"title":"CatalogScope"},"CategorySelection":{"properties":{"version":{"type":"string","pattern":"^[a-f0-9]{16}$","title":"Version"},"nodes":{"items":{"type":"string"},"type":"array","maxItems":1000,"minItems":1,"title":"Nodes"}},"additionalProperties":false,"type":"object","required":["version","nodes"],"title":"CategorySelection"},"Clarification":{"properties":{"field":{"type":"string","enum":["business","location","target","enrichment","budget"],"title":"Field"},"question":{"type":"string","maxLength":280,"minLength":1,"pattern":"^[^\\x00-\\x08\\x0b-\\x1f\\x7f]+$","title":"Question"},"options":{"items":{"type":"string","maxLength":120,"minLength":1,"pattern":"^[^\\x00-\\x08\\x0b-\\x1f\\x7f]+$"},"type":"array","maxItems":3,"title":"Options"}},"additionalProperties":false,"type":"object","required":["field","question","options"],"title":"Clarification"},"EmailEvidence":{"properties":{"address":{"type":"string","format":"email","title":"Address"},"source_url":{"type":"string","maxLength":2083,"minLength":1,"format":"uri","title":"Source Url"},"excerpt":{"type":"string","maxLength":500,"minLength":1,"title":"Excerpt"},"evidence_hash":{"type":"string","pattern":"^[0-9a-f]{64}$","title":"Evidence Hash"},"captured_at":{"type":"string","format":"date-time","title":"Captured At"},"mx_status":{"type":"string","enum":["valid","null_mx","invalid","unknown"],"title":"Mx Status"},"marketing_permission":{"type":"string","const":"unknown","title":"Marketing Permission","default":"unknown"}},"type":"object","required":["address","source_url","excerpt","evidence_hash","captured_at","mx_status"],"title":"EmailEvidence"},"EnrichRequest":{"properties":{"maximum_credit_units":{"anyOf":[{"type":"integer","maximum":9007199254740991.0,"minimum":1.0},{"type":"null"}],"title":"Maximum Credit Units"}},"type":"object","title":"EnrichRequest"},"EnrichedCampaign":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"source":{"type":"string","enum":["extension","dashboard","api","mcp"],"title":"Source"},"campaign_kind":{"type":"string","enum":["maps","extension_sync","external_import"],"title":"Campaign Kind"},"pricing_contract":{"type":"string","enum":["legacy_v1","combined_v2","maps_v2","enrichment_v2"],"title":"Pricing Contract","default":"legacy_v1","readOnly":true},"status":{"type":"string","enum":["running","needs_attention","completed","partial","failed","cancelled"],"title":"Status"},"name":{"type":"string","title":"Name"},"query":{"type":"string","title":"Query"},"result_mode":{"anyOf":[{"type":"string","enum":["leads","emails","all"]},{"type":"null"}],"title":"Result Mode"},"target_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Target Count"},"only_with_email":{"type":"boolean","title":"Only With Email","default":false},"stop_reason":{"anyOf":[{"type":"string","enum":["target","budget","coverage"]},{"type":"null"}],"title":"Stop Reason"},"source_limited":{"type":"boolean","title":"Source Limited","default":false,"readOnly":true},"retryable_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Retryable Count","readOnly":true},"extension_running":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Extension Running","readOnly":true},"enrichable_websites":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Enrichable Websites","readOnly":true},"country_code":{"type":"string","title":"Country Code"},"result_cap":{"type":"integer","title":"Result Cap"},"enrichment_requested":{"type":"boolean","title":"Enrichment Requested"},"maximum_credit_units":{"type":"integer","title":"Maximum Credit Units"},"delivered_count":{"type":"integer","title":"Delivered Count"},"email_count":{"type":"integer","title":"Email Count"},"issue_count":{"type":"integer","title":"Issue Count"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"updated_at":{"type":"string","format":"date-time","title":"Updated At"},"completed_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Completed At"},"progress":{"anyOf":[{"$ref":"#/components/schemas/CampaignProgress"},{"type":"null"}]},"keywords":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Keywords"},"geographies":{"anyOf":[{"items":{"$ref":"#/components/schemas/SearchGeography"},"type":"array"},{"type":"null"}],"title":"Geographies"},"locations":{"items":{"type":"string"},"type":"array","title":"Locations"},"category_selection":{"anyOf":[{"$ref":"#/components/schemas/CategorySelection"},{"type":"null"}]},"enrichment_pass":{"anyOf":[{"$ref":"#/components/schemas/EnrichmentPass"},{"type":"null"}]}},"type":"object","required":["id","source","campaign_kind","status","name","query","country_code","result_cap","enrichment_requested","maximum_credit_units","delivered_count","email_count","issue_count","created_at","updated_at","completed_at","locations"],"title":"EnrichedCampaign"},"EnrichmentPass":{"properties":{"websites":{"type":"integer","title":"Websites"},"queued":{"type":"integer","title":"Queued"}},"type":"object","required":["websites","queued"],"title":"EnrichmentPass"},"ExportRequest":{"properties":{"formats":{"items":{"type":"string","enum":["csv","json","xlsx"]},"type":"array","title":"Formats","default":["csv","json","xlsx"]},"has_email":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Has Email"}},"type":"object","title":"ExportRequest"},"ExtensionCampaignCreate":{"properties":{"local_campaign_id":{"type":"string","format":"uuid","title":"Local Campaign Id"},"name":{"type":"string","maxLength":160,"minLength":1,"title":"Name"},"query":{"type":"string","maxLength":300,"minLength":1,"title":"Query"},"country_code":{"type":"string","pattern":"^[A-Z]{2}$","title":"Country Code"},"locations":{"items":{"type":"string"},"type":"array","maxItems":100000,"minItems":1,"title":"Locations"},"keywords":{"anyOf":[{"items":{"type":"string"},"type":"array","maxItems":1000},{"type":"null"}],"title":"Keywords"},"enrichment":{"type":"boolean","title":"Enrichment","default":false},"maximum_credit_units":{"type":"integer","maximum":100000.0,"minimum":0.0,"title":"Maximum Credit Units","default":100000},"category_selection":{"anyOf":[{"$ref":"#/components/schemas/CategorySelection"},{"type":"null"}]},"extra_keyword":{"type":"string","maxLength":100,"title":"Extra Keyword","default":""}},"type":"object","required":["local_campaign_id","name","query","country_code","locations"],"title":"ExtensionCampaignCreate"},"ExternalImportBatch":{"properties":{"batch_id":{"type":"string","format":"uuid","title":"Batch Id"},"sequence":{"type":"integer","exclusiveMinimum":0.0,"title":"Sequence"},"payload_hash":{"type":"string","pattern":"^[0-9a-f]{64}$","title":"Payload Hash"},"rows":{"items":{"$ref":"#/components/schemas/ExternalImportRow"},"type":"array","maxItems":1000,"minItems":1,"title":"Rows"}},"type":"object","required":["batch_id","sequence","payload_hash","rows"],"title":"ExternalImportBatch"},"ExternalImportComplete":{"properties":{"last_sequence":{"type":"integer","exclusiveMinimum":0.0,"title":"Last Sequence"},"total_rows":{"type":"integer","maximum":100000.0,"minimum":1.0,"title":"Total Rows"},"content_hash":{"type":"string","pattern":"^[0-9a-f]{64}$","title":"Content Hash"}},"type":"object","required":["last_sequence","total_rows","content_hash"],"title":"ExternalImportComplete"},"ExternalImportCreate":{"properties":{"name":{"type":"string","maxLength":160,"minLength":1,"title":"Name"},"source_sha256":{"type":"string","pattern":"^[0-9a-f]{64}$","title":"Source Sha256"},"expected_rows":{"type":"integer","maximum":100000.0,"minimum":1.0,"title":"Expected Rows"},"maximum_credit_units":{"type":"integer","maximum":100000.0,"minimum":0.0,"title":"Maximum Credit Units"}},"type":"object","required":["name","source_sha256","expected_rows","maximum_credit_units"],"title":"ExternalImportCreate"},"ExternalImportRow":{"properties":{"categories":{"items":{"type":"string","maxLength":300},"type":"array","maxItems":30,"title":"Categories"},"domain":{"anyOf":[{"type":"string","maxLength":300},{"type":"null"}],"title":"Domain"},"street":{"anyOf":[{"type":"string","maxLength":300},{"type":"null"}],"title":"Street"},"municipality":{"anyOf":[{"type":"string","maxLength":300},{"type":"null"}],"title":"Municipality"},"region":{"anyOf":[{"type":"string","maxLength":300},{"type":"null"}],"title":"Region"},"postal_code":{"anyOf":[{"type":"string","maxLength":300},{"type":"null"}],"title":"Postal Code"},"country_code":{"anyOf":[{"type":"string","pattern":"^[A-Z]{2}$"},{"type":"null"}],"title":"Country Code"},"description":{"anyOf":[{"type":"string","maxLength":5000},{"type":"null"}],"title":"Description"},"claimed":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Claimed"},"price_level":{"anyOf":[{"type":"integer","maximum":4.0,"minimum":0.0},{"type":"null"}],"title":"Price Level"},"plus_code":{"anyOf":[{"type":"string","maxLength":300},{"type":"null"}],"title":"Plus Code"},"time_zone":{"anyOf":[{"type":"string","maxLength":300},{"type":"null"}],"title":"Time Zone"},"review_count":{"anyOf":[{"type":"integer","maximum":9007199254740991.0,"minimum":0.0},{"type":"null"}],"title":"Review Count"},"rating":{"anyOf":[{"type":"number","maximum":5.0,"minimum":0.0},{"type":"null"}],"title":"Rating"},"review_url":{"anyOf":[{"type":"string","maxLength":4000},{"type":"null"}],"title":"Review Url"},"knowledge_url":{"anyOf":[{"type":"string","maxLength":2000},{"type":"null"}],"title":"Knowledge Url"},"opening_hours":{"items":{"type":"string","maxLength":300},"type":"array","maxItems":14,"title":"Opening Hours"},"fid":{"anyOf":[{"type":"string","maxLength":300},{"type":"null"}],"title":"Fid"},"cid":{"anyOf":[{"type":"string","maxLength":300},{"type":"null"}],"title":"Cid"},"kgmid":{"anyOf":[{"type":"string","maxLength":300},{"type":"null"}],"title":"Kgmid"},"business_status":{"anyOf":[{"type":"string","maxLength":300},{"type":"null"}],"title":"Business Status"},"derived_fields":{"items":{"type":"string","const":"knowledge_url"},"type":"array","maxItems":1,"title":"Derived Fields"},"external_id":{"type":"string","maxLength":300,"minLength":1,"title":"External Id"},"name":{"anyOf":[{"type":"string","maxLength":500},{"type":"null"}],"title":"Name"},"website_url":{"type":"string","maxLength":2000,"minLength":1,"title":"Website Url"},"category":{"anyOf":[{"type":"string","maxLength":300},{"type":"null"}],"title":"Category"},"address":{"anyOf":[{"type":"string","maxLength":1000},{"type":"null"}],"title":"Address"},"phone":{"anyOf":[{"type":"string","maxLength":100},{"type":"null"}],"title":"Phone"},"place_id":{"anyOf":[{"type":"string","maxLength":300},{"type":"null"}],"title":"Place Id"},"latitude":{"anyOf":[{"type":"number","maximum":90.0,"minimum":-90.0},{"type":"null"}],"title":"Latitude"},"longitude":{"anyOf":[{"type":"number","maximum":180.0,"minimum":-180.0},{"type":"null"}],"title":"Longitude"}},"additionalProperties":false,"type":"object","required":["external_id","website_url"],"title":"ExternalImportRow"},"GridTerritory":{"properties":{"mode":{"type":"string","const":"grid","title":"Mode"},"cells":{"items":{"$ref":"#/components/schemas/TerritoryCell"},"type":"array","maxItems":1000,"minItems":1,"title":"Cells"}},"type":"object","required":["mode","cells"],"title":"GridTerritory"},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"LeadCursorPage":{"properties":{"items":{"items":{"$ref":"#/components/schemas/LeadRecord"},"type":"array","title":"Items"},"next_cursor":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Next Cursor"}},"type":"object","required":["items"],"title":"LeadCursorPage"},"LeadInput":{"properties":{"categories":{"items":{"type":"string","maxLength":300},"type":"array","maxItems":30,"title":"Categories"},"domain":{"anyOf":[{"type":"string","maxLength":300},{"type":"null"}],"title":"Domain"},"street":{"anyOf":[{"type":"string","maxLength":300},{"type":"null"}],"title":"Street"},"municipality":{"anyOf":[{"type":"string","maxLength":300},{"type":"null"}],"title":"Municipality"},"region":{"anyOf":[{"type":"string","maxLength":300},{"type":"null"}],"title":"Region"},"postal_code":{"anyOf":[{"type":"string","maxLength":300},{"type":"null"}],"title":"Postal Code"},"country_code":{"anyOf":[{"type":"string","pattern":"^[A-Z]{2}$"},{"type":"null"}],"title":"Country Code"},"description":{"anyOf":[{"type":"string","maxLength":5000},{"type":"null"}],"title":"Description"},"claimed":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Claimed"},"price_level":{"anyOf":[{"type":"integer","maximum":4.0,"minimum":0.0},{"type":"null"}],"title":"Price Level"},"plus_code":{"anyOf":[{"type":"string","maxLength":300},{"type":"null"}],"title":"Plus Code"},"time_zone":{"anyOf":[{"type":"string","maxLength":300},{"type":"null"}],"title":"Time Zone"},"review_count":{"anyOf":[{"type":"integer","minimum":0.0},{"type":"null"}],"title":"Review Count"},"rating":{"anyOf":[{"type":"number","maximum":5.0,"minimum":0.0},{"type":"null"}],"title":"Rating"},"review_url":{"anyOf":[{"type":"string","maxLength":4000},{"type":"null"}],"title":"Review Url"},"knowledge_url":{"anyOf":[{"type":"string","maxLength":2000},{"type":"null"}],"title":"Knowledge Url"},"opening_hours":{"items":{"type":"string","maxLength":300},"type":"array","maxItems":14,"title":"Opening Hours"},"fid":{"anyOf":[{"type":"string","maxLength":300},{"type":"null"}],"title":"Fid"},"cid":{"anyOf":[{"type":"string","maxLength":300},{"type":"null"}],"title":"Cid"},"kgmid":{"anyOf":[{"type":"string","maxLength":300},{"type":"null"}],"title":"Kgmid"},"business_status":{"anyOf":[{"type":"string","maxLength":300},{"type":"null"}],"title":"Business Status"},"derived_fields":{"items":{"type":"string","const":"knowledge_url"},"type":"array","maxItems":1,"title":"Derived Fields"},"identity_key":{"type":"string","maxLength":300,"minLength":8,"title":"Identity Key"},"place_id":{"anyOf":[{"type":"string","maxLength":300},{"type":"null"}],"title":"Place Id"},"name":{"type":"string","maxLength":500,"minLength":1,"title":"Name"},"category":{"anyOf":[{"type":"string","maxLength":300},{"type":"null"}],"title":"Category"},"address":{"anyOf":[{"type":"string","maxLength":1000},{"type":"null"}],"title":"Address"},"phone":{"anyOf":[{"type":"string","maxLength":100},{"type":"null"}],"title":"Phone"},"website_url":{"anyOf":[{"type":"string","maxLength":2000},{"type":"null"}],"title":"Website Url"},"latitude":{"anyOf":[{"type":"number","maximum":90.0,"minimum":-90.0},{"type":"null"}],"title":"Latitude"},"longitude":{"anyOf":[{"type":"number","maximum":180.0,"minimum":-180.0},{"type":"null"}],"title":"Longitude"},"observed_at":{"type":"string","format":"date-time","title":"Observed At"},"maps_url":{"type":"string","maxLength":4000,"minLength":1,"title":"Maps Url"}},"type":"object","required":["identity_key","name","observed_at","maps_url"],"title":"LeadInput"},"LeadRecord":{"properties":{"categories":{"items":{"type":"string","maxLength":300},"type":"array","maxItems":30,"title":"Categories"},"domain":{"anyOf":[{"type":"string","maxLength":300},{"type":"null"}],"title":"Domain"},"street":{"anyOf":[{"type":"string","maxLength":300},{"type":"null"}],"title":"Street"},"municipality":{"anyOf":[{"type":"string","maxLength":300},{"type":"null"}],"title":"Municipality"},"region":{"anyOf":[{"type":"string","maxLength":300},{"type":"null"}],"title":"Region"},"postal_code":{"anyOf":[{"type":"string","maxLength":300},{"type":"null"}],"title":"Postal Code"},"country_code":{"anyOf":[{"type":"string","pattern":"^[A-Z]{2}$"},{"type":"null"}],"title":"Country Code"},"description":{"anyOf":[{"type":"string","maxLength":5000},{"type":"null"}],"title":"Description"},"claimed":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Claimed"},"price_level":{"anyOf":[{"type":"integer","maximum":4.0,"minimum":0.0},{"type":"null"}],"title":"Price Level"},"plus_code":{"anyOf":[{"type":"string","maxLength":300},{"type":"null"}],"title":"Plus Code"},"time_zone":{"anyOf":[{"type":"string","maxLength":300},{"type":"null"}],"title":"Time Zone"},"review_count":{"anyOf":[{"type":"integer","minimum":0.0},{"type":"null"}],"title":"Review Count"},"rating":{"anyOf":[{"type":"number","maximum":5.0,"minimum":0.0},{"type":"null"}],"title":"Rating"},"review_url":{"anyOf":[{"type":"string","maxLength":4000},{"type":"null"}],"title":"Review Url"},"knowledge_url":{"anyOf":[{"type":"string","maxLength":2000},{"type":"null"}],"title":"Knowledge Url"},"opening_hours":{"items":{"type":"string","maxLength":300},"type":"array","maxItems":14,"title":"Opening Hours"},"fid":{"anyOf":[{"type":"string","maxLength":300},{"type":"null"}],"title":"Fid"},"cid":{"anyOf":[{"type":"string","maxLength":300},{"type":"null"}],"title":"Cid"},"kgmid":{"anyOf":[{"type":"string","maxLength":300},{"type":"null"}],"title":"Kgmid"},"business_status":{"anyOf":[{"type":"string","maxLength":300},{"type":"null"}],"title":"Business Status"},"derived_fields":{"items":{"type":"string","const":"knowledge_url"},"type":"array","maxItems":1,"title":"Derived Fields"},"identity_key":{"type":"string","maxLength":300,"minLength":8,"title":"Identity Key"},"place_id":{"anyOf":[{"type":"string","maxLength":300},{"type":"null"}],"title":"Place Id"},"name":{"type":"string","maxLength":500,"minLength":1,"title":"Name"},"category":{"anyOf":[{"type":"string","maxLength":300},{"type":"null"}],"title":"Category"},"address":{"anyOf":[{"type":"string","maxLength":1000},{"type":"null"}],"title":"Address"},"phone":{"anyOf":[{"type":"string","maxLength":100},{"type":"null"}],"title":"Phone"},"website_url":{"anyOf":[{"type":"string","maxLength":2000},{"type":"null"}],"title":"Website Url"},"latitude":{"anyOf":[{"type":"number","maximum":90.0,"minimum":-90.0},{"type":"null"}],"title":"Latitude"},"longitude":{"anyOf":[{"type":"number","maximum":180.0,"minimum":-180.0},{"type":"null"}],"title":"Longitude"},"observed_at":{"type":"string","format":"date-time","title":"Observed At"},"id":{"type":"string","format":"uuid","title":"Id"},"campaign_id":{"type":"string","format":"uuid","title":"Campaign Id"},"provenance":{"type":"string","enum":["extension","hosted","external"],"title":"Provenance"},"enrichment_state":{"type":"string","enum":["not_requested","queued","running","completed","unavailable"],"title":"Enrichment State"},"emails":{"items":{"$ref":"#/components/schemas/EmailEvidence"},"type":"array","title":"Emails"},"website_context":{"anyOf":[{"$ref":"#/components/schemas/WebsiteContext"},{"type":"null"}]},"social_profiles":{"items":{"$ref":"#/components/schemas/SocialProfile"},"type":"array","maxItems":30,"title":"Social Profiles"},"enrichment_outcome":{"anyOf":[{"type":"string","enum":["email_ready","no_accepted_email","policy_denied","website_unavailable"]},{"type":"null"}],"title":"Enrichment Outcome"},"main_category":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Main Category"},"subcategory_1":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Subcategory 1"},"subcategory_2":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Subcategory 2"}},"type":"object","required":["identity_key","name","observed_at","id","campaign_id","provenance","enrichment_state","emails","website_context"],"title":"LeadRecord"},"Location":{"properties":{"country_code":{"type":"string","pattern":"^[A-Z]{2}$","title":"Country Code"},"kind":{"type":"string","enum":["country","region","city"],"title":"Kind"},"name":{"type":"string","maxLength":100,"minLength":1,"pattern":"^[^\\x00-\\x1f\\x7f:\\\\@]+$","title":"Name"},"coverage":{"anyOf":[{"type":"string","enum":["recommended","all"]},{"type":"null"}],"title":"Coverage"},"exclude":{"type":"boolean","title":"Exclude","default":false}},"additionalProperties":false,"type":"object","required":["country_code","kind","name"],"title":"Location"},"OptionValue":{"properties":{"category_nodes":{"anyOf":[{"items":{"type":"string"},"type":"array","maxItems":1000},{"type":"null"}],"title":"Category Nodes"},"location_scopes":{"items":{"$ref":"#/components/schemas/CatalogScope"},"type":"array","maxItems":100,"title":"Location Scopes"}},"additionalProperties":false,"type":"object","required":["category_nodes","location_scopes"],"title":"OptionValue"},"PlanningResponse":{"properties":{"proposal":{"$ref":"#/components/schemas/Proposal"},"location_scopes":{"items":{"$ref":"#/components/schemas/Location"},"type":"array","maxItems":5,"title":"Location Scopes"},"category_candidates":{"items":{"type":"string","maxLength":100,"minLength":1,"pattern":"^[^\\x00-\\x1f\\x7f:\\\\@]+$"},"type":"array","maxItems":8,"title":"Category Candidates"},"assistant_message":{"type":"string","maxLength":600,"minLength":1,"pattern":"^[^\\x00-\\x08\\x0b-\\x1f\\x7f]+$","title":"Assistant Message","default":""},"clarification":{"anyOf":[{"$ref":"#/components/schemas/Clarification"},{"type":"null"}]},"location_action":{"anyOf":[{"type":"string","enum":["keep","replace","extend"]},{"type":"null"}],"title":"Location Action"},"provider":{"type":"string","const":"openrouter","title":"Provider","default":"openrouter"},"model":{"type":"string","enum":["openai/gpt-6-luna","xiaomi/mimo-v2.6-flash"],"title":"Model","default":"xiaomi/mimo-v2.6-flash"},"usage":{"$ref":"#/components/schemas/Usage"},"upstream_metadata":{"anyOf":[{"$ref":"#/components/schemas/UpstreamMetadata"},{"type":"null"}]}},"additionalProperties":false,"type":"object","required":["proposal","location_scopes","category_candidates","usage"],"title":"PlanningResponse"},"PlanningResponseV2":{"properties":{"protocol_version":{"type":"integer","const":2,"title":"Protocol Version","default":2},"kind":{"type":"string","enum":["information","clarification","proposal"],"title":"Kind"},"draft":{"$ref":"#/components/schemas/CanonicalState"},"category_action":{"type":"string","enum":["keep","replace"],"title":"Category Action"},"location_action":{"type":"string","enum":["keep","replace","extend"],"title":"Location Action"},"assistant_message":{"type":"string","maxLength":2000,"minLength":1,"pattern":"^[^\\x00-\\x08\\x0b-\\x1f\\x7f]+$","title":"Assistant Message"},"clarification":{"anyOf":[{"$ref":"#/components/schemas/ResponseQuestion"},{"type":"null"}]},"provider":{"type":"string","const":"openrouter","title":"Provider","default":"openrouter"},"model":{"type":"string","enum":["openai/gpt-6-luna","xiaomi/mimo-v2.6-flash"],"title":"Model"},"usage":{"$ref":"#/components/schemas/Usage"},"upstream_metadata":{"anyOf":[{"$ref":"#/components/schemas/UpstreamMetadata"},{"type":"null"}]}},"additionalProperties":false,"type":"object","required":["kind","draft","category_action","location_action","assistant_message","clarification","model","usage"],"title":"PlanningResponseV2"},"Proposal":{"properties":{"category_terms":{"anyOf":[{"items":{"type":"string","maxLength":100,"minLength":1,"pattern":"^[^\\x00-\\x1f\\x7f:\\\\@]+$"},"type":"array","maxItems":100,"minItems":1},{"type":"null"}],"title":"Category Terms"},"target":{"anyOf":[{"$ref":"#/components/schemas/Target"},{"type":"null"}]},"enrichment":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Enrichment"},"only_with_email":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Only With Email"},"budget":{"anyOf":[{"$ref":"#/components/schemas/Budget"},{"type":"null"}]}},"additionalProperties":false,"type":"object","required":["category_terms","target","enrichment","only_with_email","budget"],"title":"Proposal"},"PublicSampleCreate":{"properties":{"query":{"type":"string","maxLength":300,"minLength":1,"title":"Query"},"location":{"type":"string","maxLength":160,"title":"Location","default":""},"country_code":{"type":"string","pattern":"^[A-Z]{2}$","title":"Country Code","default":"ZZ"},"latitude":{"anyOf":[{"type":"number","maximum":90.0,"minimum":-90.0},{"type":"null"}],"title":"Latitude"},"longitude":{"anyOf":[{"type":"number","maximum":180.0,"minimum":-180.0},{"type":"null"}],"title":"Longitude"}},"additionalProperties":false,"type":"object","required":["query"],"title":"PublicSampleCreate"},"PublicSampleItem":{"properties":{"categories":{"items":{"type":"string","maxLength":300},"type":"array","maxItems":30,"title":"Categories"},"domain":{"anyOf":[{"type":"string","maxLength":300},{"type":"null"}],"title":"Domain"},"street":{"anyOf":[{"type":"string","maxLength":300},{"type":"null"}],"title":"Street"},"municipality":{"anyOf":[{"type":"string","maxLength":300},{"type":"null"}],"title":"Municipality"},"region":{"anyOf":[{"type":"string","maxLength":300},{"type":"null"}],"title":"Region"},"postal_code":{"anyOf":[{"type":"string","maxLength":300},{"type":"null"}],"title":"Postal Code"},"country_code":{"anyOf":[{"type":"string","pattern":"^[A-Z]{2}$"},{"type":"null"}],"title":"Country Code"},"description":{"anyOf":[{"type":"string","maxLength":5000},{"type":"null"}],"title":"Description"},"claimed":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Claimed"},"price_level":{"anyOf":[{"type":"integer","maximum":4.0,"minimum":0.0},{"type":"null"}],"title":"Price Level"},"plus_code":{"anyOf":[{"type":"string","maxLength":300},{"type":"null"}],"title":"Plus Code"},"time_zone":{"anyOf":[{"type":"string","maxLength":300},{"type":"null"}],"title":"Time Zone"},"review_count":{"anyOf":[{"type":"integer","minimum":0.0},{"type":"null"}],"title":"Review Count"},"rating":{"anyOf":[{"type":"number","maximum":5.0,"minimum":0.0},{"type":"null"}],"title":"Rating"},"review_url":{"anyOf":[{"type":"string","maxLength":4000},{"type":"null"}],"title":"Review Url"},"knowledge_url":{"anyOf":[{"type":"string","maxLength":2000},{"type":"null"}],"title":"Knowledge Url"},"opening_hours":{"items":{"type":"string","maxLength":300},"type":"array","maxItems":14,"title":"Opening Hours"},"fid":{"anyOf":[{"type":"string","maxLength":300},{"type":"null"}],"title":"Fid"},"cid":{"anyOf":[{"type":"string","maxLength":300},{"type":"null"}],"title":"Cid"},"kgmid":{"anyOf":[{"type":"string","maxLength":300},{"type":"null"}],"title":"Kgmid"},"business_status":{"anyOf":[{"type":"string","maxLength":300},{"type":"null"}],"title":"Business Status"},"derived_fields":{"items":{"type":"string","const":"knowledge_url"},"type":"array","maxItems":1,"title":"Derived Fields"},"name":{"type":"string","title":"Name"},"category":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Category"},"address":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Address"},"phone":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Phone"},"website_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Website Url"},"latitude":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Latitude"},"longitude":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Longitude"}},"type":"object","required":["name"],"title":"PublicSampleItem"},"PublicSampleResponse":{"properties":{"status":{"type":"string","enum":["running","completed","partial","failed"],"title":"Status"},"retry_after":{"anyOf":[{"type":"integer","const":1},{"type":"null"}],"title":"Retry After"},"items":{"items":{"$ref":"#/components/schemas/PublicSampleItem"},"type":"array","maxItems":100,"title":"Items"}},"type":"object","required":["status","items"],"title":"PublicSampleResponse"},"ResponseOption":{"properties":{"label":{"type":"string","maxLength":120,"minLength":1,"pattern":"^[^\\x00-\\x08\\x0b-\\x1f\\x7f]+$","title":"Label"},"value":{"anyOf":[{"$ref":"#/components/schemas/OptionValue"},{"type":"null"}]},"id":{"type":"string","pattern":"^[a-f0-9]{32}$","title":"Id"}},"additionalProperties":false,"type":"object","required":["label","value","id"],"title":"ResponseOption"},"ResponseQuestion":{"properties":{"field":{"type":"string","enum":["business","location","target","enrichment","budget"],"title":"Field"},"question":{"type":"string","maxLength":280,"minLength":1,"pattern":"^[^\\x00-\\x08\\x0b-\\x1f\\x7f]+$","title":"Question"},"options":{"items":{"$ref":"#/components/schemas/ResponseOption"},"type":"array","maxItems":3,"title":"Options"},"id":{"type":"string","pattern":"^[a-f0-9]{32}$","title":"Id"}},"additionalProperties":false,"type":"object","required":["field","question","options","id"],"title":"ResponseQuestion"},"SearchCreate":{"properties":{"name":{"type":"string","maxLength":160,"minLength":1,"title":"Name"},"query":{"type":"string","maxLength":300,"minLength":1,"title":"Query"},"country_code":{"type":"string","pattern":"^[A-Z]{2}$","title":"Country Code"},"locations":{"items":{"type":"string"},"type":"array","maxItems":100,"minItems":1,"title":"Locations"},"result_cap":{"anyOf":[{"type":"integer","maximum":2147483647.0,"minimum":1.0},{"type":"null"}],"title":"Result Cap"},"enrichment":{"type":"boolean","title":"Enrichment","default":false},"maximum_credit_units":{"anyOf":[{"type":"integer","maximum":9007199254740991.0,"minimum":0.0},{"type":"null"}],"title":"Maximum Credit Units"},"latitude":{"anyOf":[{"type":"number","maximum":90.0,"minimum":-90.0},{"type":"null"}],"title":"Latitude"},"longitude":{"anyOf":[{"type":"number","maximum":180.0,"minimum":-180.0},{"type":"null"}],"title":"Longitude"},"radius_meters":{"anyOf":[{"type":"integer","const":37500},{"type":"null"}],"title":"Radius Meters"},"territory":{"anyOf":[{"$ref":"#/components/schemas/GridTerritory"},{"type":"null"}]},"keywords":{"anyOf":[{"items":{"type":"string"},"type":"array","maxItems":1000},{"type":"null"}],"title":"Keywords"},"geographies":{"anyOf":[{"items":{"$ref":"#/components/schemas/SearchGeography"},"type":"array","maxItems":50000,"minItems":1},{"type":"null"}],"title":"Geographies"},"result_mode":{"anyOf":[{"type":"string","enum":["leads","emails","all"]},{"type":"null"}],"title":"Result Mode"},"only_with_email":{"type":"boolean","title":"Only With Email","default":false},"category_selection":{"anyOf":[{"$ref":"#/components/schemas/CategorySelection"},{"type":"null"}]},"extra_keyword":{"type":"string","maxLength":100,"title":"Extra Keyword","default":""}},"additionalProperties":false,"type":"object","required":["name","query","country_code","locations","result_cap","maximum_credit_units"],"title":"SearchCreate"},"SearchGeography":{"properties":{"country_code":{"type":"string","pattern":"^[A-Z]{2}$","title":"Country Code"},"location":{"type":"string","maxLength":300,"minLength":1,"title":"Location"},"latitude":{"type":"number","maximum":90.0,"minimum":-90.0,"title":"Latitude"},"longitude":{"type":"number","maximum":180.0,"minimum":-180.0,"title":"Longitude"}},"additionalProperties":false,"type":"object","required":["country_code","location","latitude","longitude"],"title":"SearchGeography"},"SocialProfile":{"properties":{"platform":{"type":"string","enum":["facebook","instagram","linkedin","x","youtube","tiktok","pinterest","threads","yelp"],"title":"Platform"},"url":{"type":"string","maxLength":2000,"title":"Url"},"source_url":{"type":"string","maxLength":2000,"title":"Source Url"}},"type":"object","required":["platform","url","source_url"],"title":"SocialProfile"},"SyncBatch":{"properties":{"batch_id":{"type":"string","format":"uuid","title":"Batch Id"},"sequence":{"type":"integer","exclusiveMinimum":0.0,"title":"Sequence"},"payload_hash":{"type":"string","pattern":"^[0-9a-f]{64}$","title":"Payload Hash"},"leads":{"items":{"$ref":"#/components/schemas/LeadInput"},"type":"array","maxItems":1000,"title":"Leads"}},"type":"object","required":["batch_id","sequence","payload_hash","leads"],"title":"SyncBatch"},"Target":{"properties":{"mode":{"type":"string","enum":["leads","emails","all"],"title":"Mode"},"count":{"anyOf":[{"type":"integer","maximum":2147483647.0,"minimum":1.0},{"type":"null"}],"title":"Count"}},"additionalProperties":false,"type":"object","required":["mode","count"],"title":"Target"},"TerritoryCell":{"properties":{"cell_id":{"type":"string","maxLength":120,"minLength":1,"pattern":"^[A-Za-z0-9](?:[A-Za-z0-9._:-]{0,118}[A-Za-z0-9])?$","title":"Cell Id"},"label":{"anyOf":[{"type":"string","maxLength":160,"minLength":1},{"type":"null"}],"title":"Label"},"center":{"$ref":"#/components/schemas/TerritoryCenter"}},"type":"object","required":["cell_id","center"],"title":"TerritoryCell"},"TerritoryCenter":{"properties":{"latitude":{"type":"number","maximum":90.0,"minimum":-90.0,"title":"Latitude"},"longitude":{"type":"number","maximum":180.0,"minimum":-180.0,"title":"Longitude"},"radius_meters":{"type":"integer","const":37500,"title":"Radius Meters"}},"type":"object","required":["latitude","longitude","radius_meters"],"title":"TerritoryCenter"},"UpstreamMetadata":{"properties":{"generation_id":{"anyOf":[{"type":"string","maxLength":128,"pattern":"^(?:gen|chatcmpl)-[A-Za-z0-9_-]+$"},{"type":"null"}],"title":"Generation Id"},"inference_host":{"anyOf":[{"type":"string","enum":["Azure","DeepInfra","InferenceNet"]},{"type":"null"}],"title":"Inference Host"}},"additionalProperties":false,"type":"object","title":"UpstreamMetadata"},"Usage":{"properties":{"input_tokens":{"anyOf":[{"type":"integer","maximum":1000000.0,"minimum":0.0},{"type":"null"}],"title":"Input Tokens"},"output_tokens":{"anyOf":[{"type":"integer","maximum":1000000.0,"minimum":0.0},{"type":"null"}],"title":"Output Tokens"}},"additionalProperties":false,"type":"object","required":["input_tokens","output_tokens"],"title":"Usage"},"UsageRecord":{"properties":{"entitlement":{"type":"string","enum":["free","paid"],"title":"Entitlement"},"credit_balance_units":{"type":"integer","title":"Credit Balance Units"},"settled":{"type":"integer","title":"Settled"},"reserved":{"type":"integer","title":"Reserved"},"displayed_credits":{"type":"number","title":"Displayed Credits"},"period_settled":{"type":"integer","title":"Period Settled"},"period_start":{"type":"string","format":"date-time","title":"Period Start"},"period_end":{"type":"string","format":"date-time","title":"Period End"},"period_basis":{"type":"string","enum":["subscription","calendar_month_utc"],"title":"Period Basis"}},"type":"object","required":["entitlement","credit_balance_units","settled","reserved","displayed_credits","period_settled","period_start","period_end","period_basis"],"title":"UsageRecord"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"},"input":{"title":"Input"},"ctx":{"type":"object","title":"Context"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"},"WebsiteContext":{"properties":{"status":{"type":"string","enum":["sufficient","insufficient"],"title":"Status"},"text":{"type":"string","maxLength":5000,"title":"Text"},"source_urls":{"items":{"type":"string","maxLength":2083,"minLength":1,"format":"uri"},"type":"array","maxItems":20,"title":"Source Urls"},"insufficiency_reason":{"anyOf":[{"type":"string","maxLength":200},{"type":"null"}],"title":"Insufficiency Reason"},"captured_at":{"type":"string","format":"date-time","title":"Captured At"}},"type":"object","required":["status","text","source_urls","captured_at"],"title":"WebsiteContext"}},"securitySchemes":{"MapBulkBearer":{"type":"http","description":"MapBulk API key or account access token. Endpoint scopes, plan access and account-session requirements still apply.","scheme":"bearer"}}}}