Documentation Index Fetch the complete documentation index at: https://docs.finhub.cloud/llms.txt
Use this file to discover all available pages before exploring further.
SCT03 - Country of Operation
A foundational core capability that defines where a tenant can operate and is used by all other capabilities. Each tenant can configure which countries they can operate in per capability.
Overview
This capability forms the foundation of your API integration’s geographic scope, enabling you to define allowed and restricted countries for operations, with localized compliance for each market.
Features
Feature Description Allowed Country Lists Countries where operations are permitted Denied Country Lists Countries where operations are restricted Country-Specific Compliance Regional regulatory requirements Regional Payment Methods Local payment rails and methods Local Currency Support Native currency handling per country Country-Specific Reporting Regulatory reports per jurisdiction
Per-Capability Configuration
Configuration Description Capability-Specific Countries Enable specific capabilities in specific countries Differentiated Compliance Different compliance requirements per country Gradual Rollout Phase capabilities into new countries over time
Configuration Options
Level Scope Features Single One country Full compliance for single market Regional Multiple countries in region (EU, APAC) Regional compliance framework Global Worldwide operation Country-specific compliance per market
API Usage
Get Tenant Country Configuration
GET /api/v1/configuration/countries
Authorization: Bearer {access_token}
Response:
{
"allowed_countries" : [ "GB" , "DE" , "FR" , "NL" , "BE" ],
"denied_countries" : [ "KP" , "IR" , "CU" ],
"default_country" : "GB" ,
"capabilities_by_country" : {
"GB" : [ "SCT03" , "SCT04" , "SCT09" , "SCT11" , "SCT12" ],
"DE" : [ "SCT03" , "SCT04" , "SCT11" ],
"FR" : [ "SCT03" , "SCT04" , "SCT11" ]
}
}
Validate Country for Operation
POST /api/v1/configuration/countries/validate
Content-Type: application/json
Authorization: Bearer {access_token}
{
"country_code" : "DE",
"capability" : "SCT04"
}
Integration with Other Capabilities
Capability Integration SCT04 - Instant Payment Available payment schemes per country SCT09 - Multi-Currency Available currencies per country SCT11 - Compliance Country-specific KYC/AML rules SCT12 - Financial Network Network access per country
Configuration APIs View detailed API specifications
Subscription Tier Availability
Tier Configuration Level Starter Single Professional Regional Enterprise Global Custom Configurable