API key as a bearer token: Authorization: Bearer filk_…. Keys are created in the FIL portal (Keys page) and shown once at creation; your organisation's tier and limits travel with the key server-side. Health and the OpenAPI document are the only unauthenticated operations.
Makes retries safe: the same key and byte-identical body within 24 hours returns the original response and isn't charged again. 1 to 128 characters, scoped to the API key. See Idempotency above.
Capabilities that answered this request on reduced evidence — the same names as components[].component and the health endpoint's capabilities map. Empty means every evaluated capability answered at full fidelity.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"FIL Scoring API","colors":{"primary":"#18181B","light":"#E4E4E7","dark":"#18181B"},"logo":{"light":"https://mintcdn.com/fraud-intelligence-limited/MeCyhWrDx88YIznQ/logo/light.svg?fit=max\u0026auto=format\u0026n=MeCyhWrDx88YIznQ\u0026q=85\u0026s=95e635040d77e447b70579555987f28a","dark":"https://mintcdn.com/fraud-intelligence-limited/MeCyhWrDx88YIznQ/logo/dark.svg?fit=max\u0026auto=format\u0026n=MeCyhWrDx88YIznQ\u0026q=85\u0026s=b2627efefb2c1acffdd7c2ca606c0826"},"favicon":"https://mintcdn.com/fraud-intelligence-limited/MeCyhWrDx88YIznQ/favicon.png?fit=max\u0026auto=format\u0026n=MeCyhWrDx88YIznQ\u0026q=85\u0026s=5d0f0ad2b8303063e94f311c6a52fa8b","navbar":{"links":[{"href":"mailto:register@fraudintelligencelimited.com","label":"Contact"}],"primary":{"type":"button","label":"Portal","href":"https://portal.fraudintelligencelimited.com"}},"contextual":{"options":["copy","view","chatgpt","claude","perplexity","mcp","cursor","vscode"],"display":"header"},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"fraud-intelligence-limited","hasAudioNarration":false,"actualSubdomain":"fraud-intelligence-limited","customDomains":["docs.fraudintelligencelimited.com"],"gitSource":{"type":"github","owner":"fraud-intelligence-limited","repo":"fil-api-documentation","deployBranch":"master","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"chroma":{"latestBuiltDeploymentHistoryId":"6ae3030f61e5d1a3d5238bb5","collectionId":"970ab42e-39cb-4b5a-a834-70de069c0254","liveDeploymentHistoryId":"6ae3030f61e5d1a3d5238bb5","schemaVersion":"v3"},"entitlements":{"AI_CHAT":{"status":"DISABLED"},"WEB_MCP":{"status":"DISABLED"},"NARRATION":{"status":"DISABLED"}},"buildId":"6ae31252f23a51dd552f2b78","clientVersion":"0.0.4006","searchFilterCounts":[{"language":"default","tag":"Guides","count":5},{"language":"default","tag":"API reference","count":5},{"language":"default","tag":"API Reference","count":5},{"language":"default","tag":"Getting started","count":3},{"language":"default","tag":"Understanding results","count":2}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"pause-universal-search-reconcile","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"per-site-search-delta","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-private-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"byok-sep-25","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-updated-9-15","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api-reference/score-a-subject-phone-andor-ip-synchronously","slug":"/api-reference/score-a-subject-phone-andor-ip-synchronously","pageMetadata":{"title":"Score a subject (phone and/or IP) synchronously","description":null,"deprecated":null,"version":null,"openapi":"https://2npugbuiw5.execute-api.eu-central-1.amazonaws.com/v1/openapi.yaml post /v1/score","href":"/api-reference/score-a-subject-phone-andor-ip-synchronously","autogeneratedByOpenApi":true},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Score a subject (phone and/or IP) synchronously","description":null,"deprecated":null,"version":null,"openapi":"https://2npugbuiw5.execute-api.eu-central-1.amazonaws.com/v1/openapi.yaml post /v1/score","href":"/api-reference/score-a-subject-phone-andor-ip-synchronously","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"operationId":"score","summary":"Score a subject (phone and/or IP) synchronously","parameters":["248c74c3-8cd2-42b0-a622-efaadd8df367"],"requestBody":"cdfad810-ad7e-4e52-a1dd-e4a368613fbb","responses":{"200":"2a0caa09-ecfe-453c-8be6-21a650c97011","400":"5fc54f55-2648-4976-9c02-d561afe1f000","402":"c496fe6f-77d0-4a7d-ad5b-5cc38fd837fe","403":"893dd83c-f2c6-4106-9557-710b0146bd13","409":"970f8e38-628b-4371-83d6-59ad6c729df1","422":"0c149d82-2f74-4886-a420-cb95c3c7ab59","429":"1a917973-ada3-452f-9247-0373b40503d0"},"method":"post","type":"path","servers":["8a3ce0b6-0e4d-4d8f-bf8c-3250c38e6645"],"security":["bb5f48de-85e4-4231-a737-6aba1a79638d"],"path":"/v1/score","baseUrlOptions":["https://api.fraudintelligencelimited.com"],"title":"Score a subject (phone and/or IP) synchronously","description":"","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"248c74c3-8cd2-42b0-a622-efaadd8df367":{"name":"Idempotency-Key","in":"header","required":false,"description":"Makes retries safe: the same key and byte-identical body within 24 hours returns the original response and isn't charged again. 1 to 128 characters, scoped to the API key. See Idempotency above.","schema":{"type":"string","minLength":1,"maxLength":128,"isRequired":false,"description":"Makes retries safe: the same key and byte-identical body within 24 hours returns the original response and isn't charged again. 1 to 128 characters, scoped to the API key. See Idempotency above.","uniqueKey":"","typeLabel":"string"}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["subject"],"properties":{"subject":{"type":"object","minProperties":1,"properties":{"phone_number":{"type":"string","description":"E.164","uniqueKey":"subject.phone_number","typeLabel":"string"},"ip_address":{"type":"string","description":"IPv4 or IPv6 literal","uniqueKey":"subject.ip_address","typeLabel":"string"}},"isRequired":true,"uniqueKey":"subject","typeLabel":"object"},"context_id":{"type":"string","uniqueKey":"context_id","typeLabel":"string"},"context":{"type":"object","required":["sector","geography","collection_point"],"properties":{"sector":{"type":"string","isRequired":true,"uniqueKey":"context.sector","typeLabel":"string"},"geography":{"type":"object","properties":{"operating_countries":{"type":"array","items":{"type":"string","uniqueKey":"context.geography.operating_countries.items.[INDEX]","typeLabel":"string"},"uniqueKey":"context.geography.operating_countries","typeLabel":"string[]"},"expected_corridors":{"type":"array","items":{"type":"string","uniqueKey":"context.geography.expected_corridors.items.[INDEX]","typeLabel":"string"},"uniqueKey":"context.geography.expected_corridors","typeLabel":"string[]"},"diaspora_corridors":{"type":"array","items":{"type":"string","uniqueKey":"context.geography.diaspora_corridors.items.[INDEX]","typeLabel":"string"},"uniqueKey":"context.geography.diaspora_corridors","typeLabel":"string[]"}},"isRequired":true,"uniqueKey":"context.geography","typeLabel":"object"},"collection_point":{"type":"object","properties":{"channel":{"type":"string","enum":["voice_call_centre","web","mobile_app","ussd","chat","ivr"],"uniqueKey":"context.collection_point.channel","typeLabel":"enum\u003cstring>"},"direction":{"type":"string","enum":["inbound","outbound"],"uniqueKey":"context.collection_point.direction","typeLabel":"enum\u003cstring>"},"moment":{"type":"string","enum":["onboarding","authentication","payment","profile_change","support"],"uniqueKey":"context.collection_point.moment","typeLabel":"enum\u003cstring>"}},"isRequired":true,"uniqueKey":"context.collection_point","typeLabel":"object"},"risk_posture":{"type":"string","enum":["recall_weighted","balanced","precision_weighted"],"uniqueKey":"context.risk_posture","typeLabel":"enum\u003cstring>"},"action_policy":{"type":"object","additionalProperties":{"type":"string","uniqueKey":"context.action_policy.additionalProperties","typeLabel":"string"},"uniqueKey":"context.action_policy","typeLabel":"object"}},"uniqueKey":"context","typeLabel":"object"},"client_reference":{"type":"string","maxLength":256,"description":"Your own reference for the request, echoed back in the response.","uniqueKey":"client_reference","typeLabel":"string"},"options":{"type":"object","properties":{"explain":{"type":"boolean","default":true,"uniqueKey":"options.explain","typeLabel":"boolean"},"max_latency_ms":{"type":"integer","minimum":50,"description":"Upper bound on time spent waiting for evidence sources; past it, the score is computed without them and marked degraded.","uniqueKey":"options.max_latency_ms","typeLabel":"integer"},"shadow_version":{"type":"string","uniqueKey":"options.shadow_version","typeLabel":"string"}},"uniqueKey":"options","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"subject":{"phone_number":"\u003cstring>","ip_address":"\u003cstring>"},"context_id":"\u003cstring>","client_reference":"\u003cstring>","options":{"explain":true,"max_latency_ms":51,"shadow_version":"\u003cstring>"}}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{"2a0caa09-ecfe-453c-8be6-21a650c97011":{"description":"Scored (possibly degraded — see degraded_sources; never 5xx for upstream outages)","content":{"application/json":{"schema":{"type":"object","required":["score_id","tier","score_version","score","score_type","band","recommended_action","disclosure","suppressed","degraded_sources"],"properties":{"score_id":{"type":"string","description":"Opaque score identifier, \"sc_\" followed by 32 lowercase hex characters. The prefix is pinned (v1.0.3) — clients may rely on it.","isRequired":true,"uniqueKey":"score_id","typeLabel":"string"},"tier":{"type":"string","enum":["verify","assess","bureau"],"isRequired":true,"uniqueKey":"tier","typeLabel":"enum\u003cstring>"},"score_version":{"type":"string","isRequired":true,"uniqueKey":"score_version","typeLabel":"string"},"score":{"type":"integer","minimum":0,"maximum":100,"isRequired":true,"uniqueKey":"score","typeLabel":"integer"},"score_type":{"type":"string","const":"ranking","isRequired":true,"uniqueKey":"score_type","typeLabel":"string"},"band":{"type":"string","enum":["minimal","low","medium","high","critical"],"isRequired":true,"uniqueKey":"band","typeLabel":"enum\u003cstring>"},"recommended_action":{"type":"string","enum":["allow","watch","investigate","step_up_auth","challenge","block"],"isRequired":true,"uniqueKey":"recommended_action","typeLabel":"enum\u003cstring>"},"suppressed":{"type":"array","items":{"type":"object","required":["component","available_in"],"properties":{"component":{"type":"string","description":"Component key from entitlements/tiers.json or a response-field path","isRequired":true,"uniqueKey":"suppressed.items.[INDEX].component","typeLabel":"string"},"available_in":{"type":"string","enum":["assess","bureau"],"isRequired":true,"uniqueKey":"suppressed.items.[INDEX].available_in","typeLabel":"enum\u003cstring>"}},"uniqueKey":"suppressed.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"suppressed","typeLabel":"object[]"},"disclosure":{"type":"string","isRequired":true,"uniqueKey":"disclosure","typeLabel":"string"},"degraded_sources":{"type":"array","description":"Capabilities that answered this request on reduced evidence — the same names as components[].component and the health endpoint's capabilities map. Empty means every evaluated capability answered at full fidelity.","items":{"type":"string","uniqueKey":"degraded_sources.items.[INDEX]","typeLabel":"string"},"isRequired":true,"uniqueKey":"degraded_sources","typeLabel":"string[]"},"score_basis":{"type":"string","uniqueKey":"score_basis","typeLabel":"string"},"coverage":{"type":"string","enum":["strong","partial","thin"],"description":"Reporting-density context, never a score modifier — see scoring/COVERAGE.md","uniqueKey":"coverage","typeLabel":"enum\u003cstring>"},"subject":{"type":"object","description":"Identity resolution of network assets only — never subscriber identity (RSP-4)","properties":{"phone_number":{"type":"object","properties":{"e164":{"type":"string","uniqueKey":"subject.phone_number.e164","typeLabel":"string"},"valid":{"type":"boolean","uniqueKey":"subject.phone_number.valid","typeLabel":"boolean"},"country_code":{"type":"string","uniqueKey":"subject.phone_number.country_code","typeLabel":"string"},"ndc":{"type":"string","uniqueKey":"subject.phone_number.ndc","typeLabel":"string"},"operator":{"type":"string","uniqueKey":"subject.phone_number.operator","typeLabel":"string"},"line_type":{"type":"string","uniqueKey":"subject.phone_number.line_type","typeLabel":"string"},"allocated":{"type":"boolean","uniqueKey":"subject.phone_number.allocated","typeLabel":"boolean"}},"uniqueKey":"subject.phone_number","typeLabel":"object"},"ip_address":{"type":"object","properties":{"asn":{"type":"string","uniqueKey":"subject.ip_address.asn","typeLabel":"string"},"as_name":{"type":"string","uniqueKey":"subject.ip_address.as_name","typeLabel":"string"},"as_type":{"type":"string","uniqueKey":"subject.ip_address.as_type","typeLabel":"string"},"country_code":{"type":"string","uniqueKey":"subject.ip_address.country_code","typeLabel":"string"},"continent":{"type":"string","uniqueKey":"subject.ip_address.continent","typeLabel":"string"},"hosting":{"type":"boolean","uniqueKey":"subject.ip_address.hosting","typeLabel":"boolean"},"vpn":{"type":"boolean","uniqueKey":"subject.ip_address.vpn","typeLabel":"boolean"},"proxy":{"type":"boolean","uniqueKey":"subject.ip_address.proxy","typeLabel":"boolean"},"tor":{"type":"boolean","uniqueKey":"subject.ip_address.tor","typeLabel":"boolean"},"bogon":{"type":"boolean","uniqueKey":"subject.ip_address.bogon","typeLabel":"boolean"}},"uniqueKey":"subject.ip_address","typeLabel":"object"}},"uniqueKey":"subject","typeLabel":"object"},"components":{"type":"array","items":{"type":"object","required":["component","verdict","contribution"],"properties":{"component":{"type":"string","description":"Key from entitlements/tiers.json components","isRequired":true,"uniqueKey":"components.items.[INDEX].component","typeLabel":"string"},"verdict":{"type":"string","enum":["clean","neutral","elevated","adverse","no_match","unavailable"],"isRequired":true,"uniqueKey":"components.items.[INDEX].verdict","typeLabel":"enum\u003cstring>"},"contribution":{"type":"integer","isRequired":true,"uniqueKey":"components.items.[INDEX].contribution","typeLabel":"integer"},"detail":{"type":"string","uniqueKey":"components.items.[INDEX].detail","typeLabel":"string"},"status":{"type":"string","enum":["beta"],"description":"Present only on beta components (SEMANTICS.md OUT). A beta component informs and never scores: its contribution is always 0 and it cannot change score, band or recommended_action. Its method may change between model releases without a score_version change.","uniqueKey":"components.items.[INDEX].status","typeLabel":"enum\u003cstring>"},"model_release":{"type":"string","description":"The model release that produced this component's verdict (beta range_outlook only, SEMANTICS.md OUT-4): the year and month FIL released the model, formatted YYYY-MM, e.g. \"2026-10\". A new value means the model was updated. Compare it for equality only.","uniqueKey":"components.items.[INDEX].model_release","typeLabel":"string"}},"uniqueKey":"components.items.[INDEX]","typeLabel":"object"},"uniqueKey":"components","typeLabel":"object[]"},"primary_risk_factor":{"type":"object","required":["code"],"properties":{"code":{"type":"string","description":"From SEMANTICS.md reason-code registry","isRequired":true,"uniqueKey":"primary_risk_factor.code","typeLabel":"string"},"narrative":{"type":"string","uniqueKey":"primary_risk_factor.narrative","typeLabel":"string"}},"uniqueKey":"primary_risk_factor","typeLabel":"object"},"benign_exclusions":{"type":"array","items":{"type":"string","uniqueKey":"benign_exclusions.items.[INDEX]","typeLabel":"string"},"uniqueKey":"benign_exclusions","typeLabel":"string[]"},"context_applied":{"type":"object","properties":{"context_id":{"type":"string","uniqueKey":"context_applied.context_id","typeLabel":"string"},"effect":{"type":"string","enum":["band_elevated","band_reduced","none"],"uniqueKey":"context_applied.effect","typeLabel":"enum\u003cstring>"},"reason":{"type":"string","uniqueKey":"context_applied.reason","typeLabel":"string"}},"uniqueKey":"context_applied","typeLabel":"object"},"shadow":{"type":"object","description":"Present only when shadow_version requested (VER-2)","properties":{"score_version":{"type":"string","uniqueKey":"shadow.score_version","typeLabel":"string"},"score":{"type":"integer","uniqueKey":"shadow.score","typeLabel":"integer"},"band":{"type":"string","uniqueKey":"shadow.band","typeLabel":"string"}},"uniqueKey":"shadow","typeLabel":"object"},"client_reference":{"type":"string","uniqueKey":"client_reference","typeLabel":"string"},"cluster_id":{"type":"string","description":"Bureau tier only — stable infrastructure-cluster id (spec 4.3)","uniqueKey":"cluster_id","typeLabel":"string"},"latency_ms":{"type":"integer","uniqueKey":"latency_ms","typeLabel":"integer"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"score_id":"\u003cstring>","tier":"verify","score_version":"\u003cstring>","score":50,"score_type":"ranking","band":"minimal","recommended_action":"allow","suppressed":[{"component":"\u003cstring>","available_in":"assess"}],"disclosure":"\u003cstring>","degraded_sources":["\u003cstring>"],"score_basis":"\u003cstring>","coverage":"strong","subject":{"phone_number":{"e164":"\u003cstring>","valid":true,"country_code":"\u003cstring>","ndc":"\u003cstring>","operator":"\u003cstring>","line_type":"\u003cstring>","allocated":true},"ip_address":{"asn":"\u003cstring>","as_name":"\u003cstring>","as_type":"\u003cstring>","country_code":"\u003cstring>","continent":"\u003cstring>","hosting":true,"vpn":true,"proxy":true,"tor":true,"bogon":true}},"components":[{"component":"\u003cstring>","verdict":"clean","contribution":123,"detail":"\u003cstring>","status":"beta","model_release":"\u003cstring>"}],"primary_risk_factor":{"code":"\u003cstring>","narrative":"\u003cstring>"},"benign_exclusions":["\u003cstring>"],"context_applied":{"context_id":"\u003cstring>","effect":"band_elevated","reason":"\u003cstring>"},"shadow":{"score_version":"\u003cstring>","score":123,"band":"\u003cstring>"},"client_reference":"\u003cstring>","cluster_id":"\u003cstring>","latency_ms":123}}},"exampleType":"generated"}},"exampleType":"generated"},"5fc54f55-2648-4976-9c02-d561afe1f000":{"description":"The request is malformed before its body can be validated: the body isn't JSON (E_REQUEST_INVALID_JSON) or the Idempotency-Key header is longer than 128 characters (E_IDEMPOTENCY_KEY_INVALID).","content":{"application/json":{"schema":{"type":"object","required":["errors"],"properties":{"errors":{"type":"array","minItems":1,"items":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","description":"From errors/ERRORS.md","isRequired":true,"uniqueKey":"errors.items.[INDEX].code","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"errors.items.[INDEX].message","typeLabel":"string"},"field":{"type":"string","uniqueKey":"errors.items.[INDEX].field","typeLabel":"string"}},"uniqueKey":"errors.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"errors","typeLabel":"object[]"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"errors":[{"code":"\u003cstring>","message":"\u003cstring>","field":"\u003cstring>"}]}}},"exampleType":"generated"}},"exampleType":"generated"},"c496fe6f-77d0-4a7d-ad5b-5cc38fd837fe":{"description":"This request's credits would take the organisation past its credit allowance for the month, or it has no allowance (E_CREDITS_EXHAUSTED) — top up or wait for the 1st (UTC), when the allowance renews. There is no overdraft by default. Distinct from 429 by design: 429 means wait a moment, 402 means the account needs attention. Refused requests are never billed and never scored. Test-mode keys are never refused for credits.","content":{"application/json":{"schema":{"type":"object","required":["errors"],"properties":{"errors":{"type":"array","minItems":1,"items":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","description":"From errors/ERRORS.md","isRequired":true,"uniqueKey":"errors.items.[INDEX].code","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"errors.items.[INDEX].message","typeLabel":"string"},"field":{"type":"string","uniqueKey":"errors.items.[INDEX].field","typeLabel":"string"}},"uniqueKey":"errors.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"errors","typeLabel":"object[]"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"errors":[{"code":"\u003cstring>","message":"\u003cstring>","field":"\u003cstring>"}]}}},"exampleType":"generated"}},"exampleType":"generated"},"893dd83c-f2c6-4106-9557-710b0146bd13":{"description":"Tier/entitlement violation","content":{"application/json":{"schema":{"type":"object","required":["errors"],"properties":{"errors":{"type":"array","minItems":1,"items":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","description":"From errors/ERRORS.md","isRequired":true,"uniqueKey":"errors.items.[INDEX].code","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"errors.items.[INDEX].message","typeLabel":"string"},"field":{"type":"string","uniqueKey":"errors.items.[INDEX].field","typeLabel":"string"}},"uniqueKey":"errors.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"errors","typeLabel":"object[]"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"errors":[{"code":"\u003cstring>","message":"\u003cstring>","field":"\u003cstring>"}]}}},"exampleType":"generated"}},"exampleType":"generated"},"970f8e38-628b-4371-83d6-59ad6c729df1":{"description":"E_IDEMPOTENCY_REPLAY_MISMATCH: the Idempotency-Key was used with a different body in the last 24 hours. E_IDEMPOTENCY_IN_PROGRESS: the original request with this key is still being scored; retry after Retry-After with the same key and body. E_SCORE_VERSION_RETIRED: the pinned score_version is past its deprecation window.","headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds to wait before retrying (E_IDEMPOTENCY_IN_PROGRESS only)"}},"content":{"application/json":{"schema":{"type":"object","required":["errors"],"properties":{"errors":{"type":"array","minItems":1,"items":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","description":"From errors/ERRORS.md","isRequired":true,"uniqueKey":"errors.items.[INDEX].code","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"errors.items.[INDEX].message","typeLabel":"string"},"field":{"type":"string","uniqueKey":"errors.items.[INDEX].field","typeLabel":"string"}},"uniqueKey":"errors.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"errors","typeLabel":"object[]"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"errors":[{"code":"\u003cstring>","message":"\u003cstring>","field":"\u003cstring>"}]}}},"exampleType":"generated"}},"exampleType":"generated"},"0c149d82-2f74-4886-a420-cb95c3c7ab59":{"description":"Full violation set, one pass (see errors/ERRORS.md)","content":{"application/json":{"schema":{"type":"object","required":["errors"],"properties":{"errors":{"type":"array","minItems":1,"items":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","description":"From errors/ERRORS.md","isRequired":true,"uniqueKey":"errors.items.[INDEX].code","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"errors.items.[INDEX].message","typeLabel":"string"},"field":{"type":"string","uniqueKey":"errors.items.[INDEX].field","typeLabel":"string"}},"uniqueKey":"errors.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"errors","typeLabel":"object[]"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"errors":[{"code":"\u003cstring>","message":"\u003cstring>","field":"\u003cstring>"}]}}},"exampleType":"generated"}},"exampleType":"generated"},"1a917973-ada3-452f-9247-0373b40503d0":{"description":"Rate limit exceeded (E_RATE_LIMITED): the organisation's requests this second, across all its keys, passed its tier's limit. Wait Retry-After seconds. X-RateLimit-Limit and X-RateLimit-Remaining describe the window. Refused requests are never scored or charged.","headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds to wait before retrying"},"X-RateLimit-Limit":{"schema":{"type":"integer"},"description":"Requests permitted per second at this tier"},"X-RateLimit-Remaining":{"schema":{"type":"integer"},"description":"Requests left in the current window"}},"content":{"application/json":{"schema":{"type":"object","required":["errors"],"properties":{"errors":{"type":"array","minItems":1,"items":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","description":"From errors/ERRORS.md","isRequired":true,"uniqueKey":"errors.items.[INDEX].code","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"errors.items.[INDEX].message","typeLabel":"string"},"field":{"type":"string","uniqueKey":"errors.items.[INDEX].field","typeLabel":"string"}},"uniqueKey":"errors.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"errors","typeLabel":"object[]"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"errors":[{"code":"\u003cstring>","message":"\u003cstring>","field":"\u003cstring>"}]}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"bb5f48de-85e4-4231-a737-6aba1a79638d":{"bearerAuth":{"type":"http","scheme":"bearer","description":"API key as a bearer token: `Authorization: Bearer filk_…`. Keys are created in the FIL portal (Keys page) and shown once at creation; your organisation's tier and limits travel with the key server-side. Health and the OpenAPI document are the only unauthenticated operations.","scopes":[],"schemeName":"bearerAuth"}}},"servers":{"8a3ce0b6-0e4d-4d8f-bf8c-3250c38e6645":{"url":"https://api.fraudintelligencelimited.com"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","description":"API key as a bearer token: `Authorization: Bearer filk_…`. Keys are created in the FIL portal (Keys page) and shown once at creation; your organisation's tier and limits travel with the key server-side. Health and the OpenAPI document are the only unauthenticated operations.","scopes":[],"schemeName":"bearerAuth"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"API key as a bearer token: `Authorization: Bearer filk_…`. Keys are created in the FIL portal (Keys page) and shown once at creation; your organisation's tier and limits travel with the key server-side. Health and the OpenAPI document are the only unauthenticated operations.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"bearerAuth","name":"Authorization"}],"title":"bearerAuth"}]},"originalFileLocation":"https://2npugbuiw5.execute-api.eu-central-1.amazonaws.com/v1/openapi.yaml"},"subdomain":"fraud-intelligence-limited","siteName":"FIL Scoring API","title":"Score a subject (phone and/or IP) synchronously - FIL Scoring API","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-29T09:31:01.979Z","originalFileLocation":"api-reference/score-a-subject-phone-andor-ip-synchronously.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"application-name\" content=\"FIL Scoring API\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/fraud-intelligence-limited/exVSIFNM1ntR8vYr/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/fraud-intelligence-limited/exVSIFNM1ntR8vYr/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/fraud-intelligence-limited/exVSIFNM1ntR8vYr/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/fraud-intelligence-limited/exVSIFNM1ntR8vYr/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/fraud-intelligence-limited/exVSIFNM1ntR8vYr/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/fraud-intelligence-limited/exVSIFNM1ntR8vYr/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/fraud-intelligence-limited/exVSIFNM1ntR8vYr/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/fraud-intelligence-limited/exVSIFNM1ntR8vYr/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/fraud-intelligence-limited/exVSIFNM1ntR8vYr/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Score a subject (phone and/or IP) synchronously - FIL Scoring API\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"FIL Scoring API\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.fraudintelligencelimited.com/api-reference/score-a-subject-phone-andor-ip-synchronously\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://fraud-intelligence-limited.mintlify.app/_mintlify/api/og/v2?division=API+Reference\u0026amp;title=Score+a+subject+%28phone+and%2For+IP%29+synchronously\u0026amp;theme=8d22743de92537675d0857a6\u0026amp;signature=15106158f10183c231558c6378bead8f2c112c69d7fdd4ba63abb990f0e70cd8\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Score a subject (phone and/or IP) synchronously - FIL Scoring API\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://fraud-intelligence-limited.mintlify.app/_mintlify/api/og/v2?division=API+Reference\u0026amp;title=Score+a+subject+%28phone+and%2For+IP%29+synchronously\u0026amp;theme=8d22743de92537675d0857a6\u0026amp;signature=15106158f10183c231558c6378bead8f2c112c69d7fdd4ba63abb990f0e70cd8\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/fraud-intelligence-limited/exVSIFNM1ntR8vYr/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"FIL Scoring API\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#18181B\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.fraudintelligencelimited.com/api-reference/score-a-subject-phone-andor-ip-synchronously\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/score-a-subject-phone-andor-ip-synchronously.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.fraudintelligencelimited.com/#organization\",\"name\":\"FIL Scoring API\",\"url\":\"https://docs.fraudintelligencelimited.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/fraud-intelligence-limited/MeCyhWrDx88YIznQ/logo/light.svg?fit=max\u0026auto=format\u0026n=MeCyhWrDx88YIznQ\u0026q=85\u0026s=95e635040d77e447b70579555987f28a\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.fraudintelligencelimited.com#website\",\"name\":\"FIL Scoring API\",\"url\":\"https://docs.fraudintelligencelimited.com\",\"publisher\":{\"@id\":\"https://docs.fraudintelligencelimited.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.fraudintelligencelimited.com/api-reference/score-a-subject-phone-andor-ip-synchronously#webpage\",\"url\":\"https://docs.fraudintelligencelimited.com/api-reference/score-a-subject-phone-andor-ip-synchronously\",\"name\":\"Score a subject (phone and/or IP) synchronously\",\"dateModified\":\"2026-10-29T09:31:01.979Z\",\"isPartOf\":{\"@id\":\"https://docs.fraudintelligencelimited.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.fraudintelligencelimited.com/api-reference/score-a-subject-phone-andor-ip-synchronously#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.fraudintelligencelimited.com/api-reference/score-a-subject-phone-andor-ip-synchronously#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"FIL Scoring API\",\"item\":\"https://docs.fraudintelligencelimited.com\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Score a subject (phone and/or IP) synchronously\",\"item\":\"https://docs.fraudintelligencelimited.com/api-reference/score-a-subject-phone-andor-ip-synchronously\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.fraudintelligencelimited.com/api-reference/score-a-subject-phone-andor-ip-synchronously#apireference\",\"headline\":\"Score a subject (phone and/or IP) synchronously\",\"name\":\"Score a subject (phone and/or IP) synchronously\",\"url\":\"https://docs.fraudintelligencelimited.com/api-reference/score-a-subject-phone-andor-ip-synchronously\",\"mainEntityOfPage\":{\"@id\":\"https://docs.fraudintelligencelimited.com/api-reference/score-a-subject-phone-andor-ip-synchronously#webpage\"},\"dateModified\":\"2026-10-29T09:31:01.979Z\",\"publisher\":{\"@id\":\"https://docs.fraudintelligencelimited.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.fraudintelligencelimited.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"FIL Scoring API\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"FIL Scoring API","nav":{"global":null,"tabs":[{"tab":"Guides","pages":[{"title":"Guides","href":""}]},{"tab":"API reference","groups":[{"group":"API Reference","pages":[{"title":"Score a subject (phone and/or IP) synchronously","deprecated":null,"version":null,"openapi":"https://2npugbuiw5.execute-api.eu-central-1.amazonaws.com/v1/openapi.yaml post /v1/score","href":"/api-reference/score-a-subject-phone-andor-ip-synchronously"},{"title":"Full evidence record for a past score (13-month retention)","description":null,"deprecated":null,"version":null,"openapi":"https://2npugbuiw5.execute-api.eu-central-1.amazonaws.com/v1/openapi.yaml get /v1/explain/{score_id}","href":"/api-reference/full-evidence-record-for-a-past-score-13-month-retention"},{"title":"Self-serve metering view for the calling credential","deprecated":null,"version":null,"openapi":"https://2npugbuiw5.execute-api.eu-central-1.amazonaws.com/v1/openapi.yaml get /v1/usage","href":"/api-reference/self-serve-metering-view-for-the-calling-credential"},{"title":"Service and per-upstream-source availability","deprecated":null,"version":null,"openapi":"https://2npugbuiw5.execute-api.eu-central-1.amazonaws.com/v1/openapi.yaml get /v1/health","href":"/api-reference/service-and-per-upstream-source-availability"},{"title":"This contract, as served — the machine-readable API definition","deprecated":null,"version":null,"openapi":"https://2npugbuiw5.execute-api.eu-central-1.amazonaws.com/v1/openapi.yaml get /v1/openapi.yaml","href":"/api-reference/this-contract-as-served-—-the-machine-readable-api-definition"}]}]}]},"title":"Score a subject (phone and/or IP) synchronously - FIL Scoring API","buildId":"dpl_2xiSHD9XEvLsPGPcfoMtkLTB3dy9","deploymentId":"dpl_2xiSHD9XEvLsPGPcfoMtkLTB3dy9","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-DmVyH30O.js","utils-BHQqGGOd.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-CD-E4BIt.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-Bp5Lq9Ds.js","snippetPresets-C4xAVCFP.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-CgXVLxUC.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-BF8I5oUf.js","shallow-Byd0lWnC.js","getApiPlaygroundDisplay-BGOZG1OK.js","CodeSnippet-CpvQL0CY.js","CodeSnippets-B8wkBKXa.js","Page-CBCH2P7b.js","getPastedJson-Ry3scI3Y.js","icon-D7a9HcdD.js","MethodPill-CJ8pmHhz.js","DuplicateIcon-rh1HJF0t.js","createIcon-DvGznqYs.js","DynamicMarkdown-Cc6AuSHS.js","SectionHeading-B4A0S-ep.js","axios-vUo_bRtp.js","Markdown-Cc16CX65.js","clsx-Cs6nMGht.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-zbf22OZA.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-C_fs-y5n.js"]}