{"contract_version":"2026-10-27.1","content_type":"application/problem+json","errors":[{"code":"invalid_api_key","http_status":401,"title":"Invalid API key","detail":"Provide a valid API key using the Authorization: Bearer header.","retryable":false,"charged":false},{"code":"invalid_field","http_status":400,"title":"Invalid include","detail":"One or more requested fields do not exist.","retryable":false,"charged":false},{"code":"field_not_available_for_capability","http_status":400,"title":"Field not available","detail":"A known field is not exposed by this capability. Use the domain endpoint for the complete company record.","retryable":false,"charged":false},{"code":"unsupported_parameter","http_status":400,"title":"Unsupported parameter","detail":"The products parameter was removed. Fields no longer have separate prices.","retryable":false,"charged":false},{"code":"lead_requires_enrich","http_status":400,"title":"Lead enrichment required","detail":"Registry and contact fields require explicit enrich=true on a paid account.","retryable":false,"charged":false},{"code":"max_credits_exceeded","http_status":400,"title":"Maximum credits exceeded","detail":"The requested record and optional lead add-on can cost more than the caller-approved maximum.","retryable":false,"charged":false},{"code":"invalid_filter","http_status":400,"title":"Invalid filter","detail":"One or more requested filters are not available in the Semantil catalog.","retryable":false,"charged":false},{"code":"invalid_filter_value","http_status":400,"title":"Invalid filter value","detail":"A country filter could not be resolved to a canonical country name or ISO code.","retryable":false,"charged":false},{"code":"invalid_request","http_status":400,"title":"Invalid request","detail":"The request parameters could not be parsed.","retryable":false,"charged":false},{"code":"invalid_exclude_domains","http_status":400,"title":"Invalid exclude_domains","detail":"exclude_domains must be a valid JSON array containing at most 20,000 domains or HTTP(S) URLs.","retryable":false,"charged":false},{"code":"upgrade_required","http_status":403,"title":"Upgrade required","detail":"The current plan does not include this operation or field. Open upgrade_url from the response to see the plan that does.","retryable":false,"charged":false},{"code":"insufficient_credits","http_status":402,"title":"Insufficient credits","detail":"This request needs more credits than remain. Credits renew on usage.resets_at; request fewer rows or upgrade at https://semantil.com/pricing.","retryable":false,"charged":false},{"code":"api_key_restricted","http_status":403,"title":"API key restricted","detail":"This API key is not permitted to perform the requested action. Create a key with the default access at https://semantil.com/api#api-keys.","retryable":false,"charged":false},{"code":"access_scope_restricted","http_status":403,"title":"Access scope restricted","detail":"The account access does not include this capability, for example semantic search. Contact Semantil to extend the access.","retryable":false,"charged":false},{"code":"domain_not_found","http_status":200,"title":"Domain not found","detail":"Domain lookup and lookalike return found=false and spend no credits when the seed is absent from the Semantil catalog.","retryable":false,"charged":false},{"code":"seed_profile_unavailable","http_status":200,"title":"Similarity profile unavailable","detail":"The website is present in the Semantil catalog, but similarity search is not currently available for it. No credits are spent.","retryable":false,"charged":false},{"code":"no_similar_companies","http_status":200,"title":"No similar companies","detail":"Lookalike returns found=false and spends no credits when the seed exists but no suitable candidates are available.","retryable":false,"charged":false},{"code":"temporarily_unavailable","http_status":503,"title":"Lookalike temporarily unavailable","detail":"Similar-company retrieval is temporarily unavailable. Retry the same request.","retryable":true,"charged":false},{"code":"unsupported_media_type","http_status":415,"title":"Unsupported media type","detail":"POST /api/search requires Content-Type: application/json.","retryable":false,"charged":false},{"code":"request_too_large","http_status":413,"title":"Request too large","detail":"The JSON request body exceeds the 5 MB limit.","retryable":false,"charged":false},{"code":"rate_limited","http_status":429,"title":"Rate limited","detail":"Too many requests were sent in a short time window. Retry after the seconds in the Retry-After header (also retry_after in the body).","retryable":true,"charged":false},{"code":"access_grant_limit","http_status":429,"title":"Evaluation limit reached","detail":"The evaluation access has used its request or credit allowance. Contact Semantil to continue.","retryable":false,"charged":false},{"code":"search_capacity_exceeded","http_status":429,"title":"Search capacity exceeded","detail":"Search capacity is temporarily exhausted.","retryable":true,"charged":false},{"code":"catalog_generation_mismatch","http_status":409,"title":"Catalog generation mismatch","detail":"The catalog changed after a preceding related result. Restart the related analysis from its first request.","retryable":false,"charged":false},{"code":"exclusion_filter_mismatch","http_status":503,"title":"Exclusion verification failed","detail":"The search was not returned or charged because exclusion verification detected an inconsistent backend result.","retryable":true,"charged":false},{"code":"catalog_refresh_in_progress","http_status":503,"title":"Catalog refresh in progress","detail":"The catalog changed during the request. Retry the same operation.","retryable":true,"charged":false},{"code":"search_unavailable","http_status":503,"title":"Search temporarily unavailable","detail":"The search service is temporarily unavailable.","retryable":true,"charged":false},{"code":"search_capability_unavailable","http_status":503,"title":"Search capability unavailable","detail":"A required search capability is temporarily unavailable.","retryable":true,"charged":false},{"code":"search_timeout","http_status":504,"title":"Search timeout","detail":"The search did not finish within its bounded execution time.","retryable":true,"charged":false},{"code":"search_limit_exceeded","http_status":422,"title":"Search limit exceeded","detail":"The requested search exceeds a bounded engine limit.","retryable":false,"charged":false},{"code":"empty_cohort","http_status":422,"title":"Empty cohort","detail":"The requested cohort has no matching companies in the selected scope. Check exact filter values or broaden the cohort.","retryable":false,"charged":false},{"code":"search_contract_error","http_status":502,"title":"Search contract error","detail":"The application generated a request that the search contract rejected.","retryable":false,"charged":false},{"code":"search_upstream_error","http_status":502,"title":"Search upstream error","detail":"The search service could not complete the request.","retryable":true,"charged":false},{"code":"internal_error","http_status":500,"title":"Internal error","detail":"The request failed before completion.","retryable":true,"charged":false}]}