Country Support

Overview

Kira supports user creation and identity verification (KYC/KYB) for 222 countries worldwide. 21 countries are restricted due to international sanctions.

This guide covers:

  • Which countries are supported and which are restricted
  • How the system determines what fields to require based on the user's country
  • What document type and tax ID to use for each country
  • Complete example payloads

Audience: This guide is for developers integrating with the Kira API and for business/product teams who need to understand country coverage.


How Country Categories Work

When you create a user, the address_country field determines which category they fall into. There are only two categories:

address_country valueCategoryWhat changes
USAUSARequires SSN (individual) or EIN + representative SSN (business). Does NOT require expected_monthly_payments.
Any other supported codeInternationalRequires tax_id and expected_monthly_payments. Does NOT require SSN/EIN.

All country codes use the ISO 3166-1 alpha-3 format (3-letter codes). For example: USA, MEX, GBR, BRA, NGA.

Key insight: From an API perspective, a user from Mexico, Nigeria, Japan, and Germany are all treated the same way — they all fall under the "International" category with the same required fields. The only country with different requirements is USA.


For complete field descriptions, required fields, payload structures, and identifying_information examples, see the User Management guide.


Supported Countries

The following 222 countries are supported for user creation. They are organized by region.

Table columns:

  • Code — The ISO 3166-1 alpha-3 code to use in address_country, nationality, document_country, and issuing_country fields
  • Country — Country name (for reference)
  • Recommended Doc Type — The document_type value to send. passport works for all countries, but the recommended type is the most commonly used local ID
  • Tax ID type — The type value to send in identifying_information for the tax entry. Always tax_id for international, ssn/ein for USA
  • Local Tax ID Name — What the tax identifier is called locally. This is informational — put the local tax ID value in the number field (not in type)

North America

CodeCountryRecommended Doc TypeTax ID typeLocal Tax ID Name
CANCanadapassporttax_idSIN (Individual) / BN (Business)
MEXMexiconational_idtax_idRFC (Individual) / RFC (Business)
SPMSaint Pierre and Miquelonnational_idtax_idNIF
USAUnited Statespassportssn / einSSN (Individual) / EIN (Business)

Caribbean

CodeCountryRecommended Doc TypeTax ID typeLocal Tax ID Name
ABWArubanational_idtax_idTax ID
AIAAnguillapassporttax_idTax ID
ATGAntigua and Barbudapassporttax_idTIN
BESBonaire, Sint Eustatius and Sabapassporttax_idTax ID
BHSBahamaspassporttax_idTIN
BMUBermudapassporttax_idTax ID
BRBBarbadosnational_idtax_idTIN
CUWCuracaonational_idtax_idTax ID
CYMCayman Islandspassporttax_idTax ID
DMADominicapassporttax_idTIN
DOMDominican Republicnational_idtax_idRNC
GLPGuadeloupenational_idtax_idNIF
GRDGrenadapassporttax_idTIN
HTIHaitipassporttax_idNIF
JAMJamaicapassporttax_idTRN
KNASaint Kitts and Nevispassporttax_idTIN
LCASaint Luciapassporttax_idTIN
MAFSaint Martinnational_idtax_idNIF
MSRMontserratpassporttax_idTax ID
MTQMartiniquenational_idtax_idNIF
PRIPuerto Riconational_idtax_idSSN
SXMSint Maartennational_idtax_idTax ID
TCATurks and Caicos Islandspassporttax_idTax ID
TTOTrinidad and Tobagonational_idtax_idBIR Number
VCTSaint Vincent and the Grenadinespassporttax_idTIN
VGBBritish Virgin Islandspassporttax_idTax ID
VIRU.S. Virgin Islandsnational_idtax_idSSN

Central America

CodeCountryRecommended Doc TypeTax ID typeLocal Tax ID Name
BLZBelizepassporttax_idTIN
CRICosta Ricanational_idtax_idCedula / Cedula Juridica
GTMGuatemalanational_idtax_idNIT
HNDHondurasnational_idtax_idRTN
NICNicaraguanational_idtax_idRUC
PANPanamanational_idtax_idRUC
SLVEl Salvadornational_idtax_idNIT

South America

CodeCountryRecommended Doc TypeTax ID typeLocal Tax ID Name
ARGArgentinanational_idtax_idCUIT
BOLBolivianational_idtax_idNIT
BRABrazilnational_idtax_idCPF (Individual) / CNPJ (Business)
CHLChilenational_idtax_idRUT
COLColombianational_idtax_idNUIP (Individual) / NIT (Business)
ECUEcuadornational_idtax_idRUC
GUFFrench Guiananational_idtax_idNIF
GUYGuyanapassporttax_idTIN
PERPerunational_idtax_idRUC
PRYParaguaynational_idtax_idRUC
SURSurinamenational_idtax_idTax ID
URYUruguaynational_idtax_idRUT

Europe

CodeCountryRecommended Doc TypeTax ID typeLocal Tax ID Name
ALAAland Islandspassporttax_idHETU
ALBAlbanianational_idtax_idNIPT
ANDAndorrapassporttax_idNRT
AUTAustrianational_idtax_idSteuernummer
BELBelgiumnational_idtax_idNN
BGRBulgarianational_idtax_idEGN
BIHBosnia and Herzegovinanational_idtax_idJMBG
BLMSaint Barthelemynational_idtax_idNIF
CHESwitzerlandnational_idtax_idAHV
CYPCyprusnational_idtax_idTIC
CZECzech Republicnational_idtax_idRC
DEUGermanynational_idtax_idSteuer-IdNr
DNKDenmarknational_idtax_idCPR
ESPSpainnational_idtax_idNIF
ESTEstonianational_idtax_idIsikukood
FINFinlandnational_idtax_idHETU
FRAFrancenational_idtax_idNIF
FROFaroe Islandspassporttax_idP-tal
GBRUnited Kingdompassporttax_idNIN
GEOGeorgianational_idtax_idPersonal Number
GGYGuernseypassporttax_idTax ID
GIBGibraltarnational_idtax_idTax ID
GRCGreecenational_idtax_idAFM
GRLGreenlandpassporttax_idCPR
HRVCroatianational_idtax_idOIB
HUNHungarynational_idtax_idAdoazonosito jel
IMNIsle of Manpassporttax_idTax ID
IRLIrelandpassporttax_idPPS Number
ISLIcelandnational_idtax_idKennitala
ITAItalynational_idtax_idCodice Fiscale
JEYJerseypassporttax_idTax ID
LIELiechtensteinnational_idtax_idPEID
LTULithuanianational_idtax_idAsmens kodas
LUXLuxembourgnational_idtax_idMatricule
LVALatvianational_idtax_idPersonas kods
MCOMonaconational_idtax_idNIF
MDAMoldovanational_idtax_idIDNP
MKDNorth Macedonianational_idtax_idEMBG
MLTMaltanational_idtax_idID Card Number
MNEMontenegronational_idtax_idJMBG
NLDNetherlandsnational_idtax_idBSN
NORNorwaynational_idtax_idFodselsnummer
POLPolandnational_idtax_idPESEL
PRTPortugalnational_idtax_idNIF
ROURomanianational_idtax_idCNP
SJMSvalbard and Jan Mayenpassporttax_idFodselsnummer
SMRSan Marinonational_idtax_idCOE
SRBSerbianational_idtax_idJMBG
SVKSlovakianational_idtax_idRC
SVNSlovenianational_idtax_idEMSO
SWESwedennational_idtax_idPersonnummer
VATVatican Citypassporttax_idTax ID
XKKKosovonational_idtax_idPersonal Number

Middle East

CodeCountryRecommended Doc TypeTax ID typeLocal Tax ID Name
AREUnited Arab Emiratesnational_idtax_idTRN
BHRBahrainnational_idtax_idCPR
ISRIsraelnational_idtax_idMispar Zehut
JORJordannational_idtax_idNational Number
KWTKuwaitnational_idtax_idCivil ID
LBNLebanonnational_idtax_idTax ID
OMNOmannational_idtax_idCivil ID
PSEPalestinenational_idtax_idTax ID
QATQatarnational_idtax_idQID
TURTurkeynational_idtax_idTC Kimlik No

Central Asia

CodeCountryRecommended Doc TypeTax ID typeLocal Tax ID Name
ARMArmeniapassporttax_idSSN
AZEAzerbaijannational_idtax_idFIN
KAZKazakhstannational_idtax_idIIN
KGZKyrgyzstanpassporttax_idINN
TJKTajikistanpassporttax_idINN
TKMTurkmenistanpassporttax_idTax ID
UZBUzbekistanpassporttax_idINN

South Asia

CodeCountryRecommended Doc TypeTax ID typeLocal Tax ID Name
BGDBangladeshnational_idtax_idNID
BTNBhutannational_idtax_idCID
INDIndianational_idtax_idPAN
LKASri Lankanational_idtax_idNIC
MDVMaldivesnational_idtax_idNational ID
NPLNepalnational_idtax_idPAN
PAKPakistannational_idtax_idCNIC

East Asia

CodeCountryRecommended Doc TypeTax ID typeLocal Tax ID Name
CHNChinanational_idtax_idShenfenzheng Hao
HKGHong Kongnational_idtax_idHKID
JPNJapannational_idtax_idMy Number
KORSouth Koreanational_idtax_idRRN
MACMacaunational_idtax_idBIR
MNGMongolianational_idtax_idRegister Number
TWNTaiwannational_idtax_idID Number

Southeast Asia

CodeCountryRecommended Doc TypeTax ID typeLocal Tax ID Name
BRNBruneinational_idtax_idIC Number
IDNIndonesianational_idtax_idNIK
KHMCambodiapassporttax_idTax ID
LAOLaospassporttax_idTax ID
MYSMalaysianational_idtax_idMyKad
PHLPhilippinesnational_idtax_idTIN
SGPSingaporenational_idtax_idNRIC
THAThailandnational_idtax_idID Card Number
TLSTimor-Lestepassporttax_idTax ID
VNMVietnamnational_idtax_idCCCD

North Africa

CodeCountryRecommended Doc TypeTax ID typeLocal Tax ID Name
DZAAlgerianational_idtax_idNIN
EGYEgyptnational_idtax_idNational ID
ESHWestern Saharanational_idtax_idCIN
MARMorocconational_idtax_idCIN
TUNTunisianational_idtax_idCIN

West Africa

CodeCountryRecommended Doc TypeTax ID typeLocal Tax ID Name
BENBeninpassporttax_idIFU
BFABurkina Fasonational_idtax_idIFU
CMRCameroonnational_idtax_idCNI
COGRepublic of the Congonational_idtax_idNIF
COMComorospassporttax_idTax ID
CPVCape Verdenational_idtax_idNIF
GABGabonnational_idtax_idNIF
GHAGhananational_idtax_idTIN
GINGuineapassporttax_idNIF
GMBGambianational_idtax_idTIN
GNBGuinea-Bissaupassporttax_idNIF
GNQEquatorial Guineapassporttax_idNIF
MLIMalinational_idtax_idNIF
MRTMauritanianational_idtax_idNIF
NERNigernational_idtax_idNIF
NGANigerianational_idtax_idNIN
SENSenegalnational_idtax_idNINEA
SLESierra Leonepassporttax_idTIN
STPSao Tome and Principepassporttax_idNIF
TCDChadnational_idtax_idNIF
TGOTogonational_idtax_idNIF

Central Africa

CodeCountryRecommended Doc TypeTax ID typeLocal Tax ID Name
AGOAngolanational_idtax_idNIF

East Africa

CodeCountryRecommended Doc TypeTax ID typeLocal Tax ID Name
BDIBurundinational_idtax_idNIF
DJIDjiboutinational_idtax_idNIF
ERIEritreanational_idtax_idTax ID
ETHEthiopianational_idtax_idTIN
KENKenyanational_idtax_idKRA PIN
MDGMadagascarnational_idtax_idNIF
MOZMozambiquenational_idtax_idNUIT
MUSMauritiusnational_idtax_idNIC
MWIMalawinational_idtax_idTPIN
MYTMayottenational_idtax_idNIF
NAMNamibianational_idtax_idTIN
REUReunionnational_idtax_idNIF
RWARwandanational_idtax_idTIN
SHNSaint Helenapassporttax_idTax ID
SSDSouth Sudanpassporttax_idTax ID
SWZEswatininational_idtax_idTIN
SYCSeychellesnational_idtax_idNIN
TZATanzanianational_idtax_idTIN
UGAUgandanational_idtax_idTIN
ZAFSouth Africanational_idtax_idSA ID
ZMBZambianational_idtax_idTPIN

Southern Africa

CodeCountryRecommended Doc TypeTax ID typeLocal Tax ID Name
BWABotswananational_idtax_idTIN
LSOLesothonational_idtax_idTIN

Oceania

CodeCountryRecommended Doc TypeTax ID typeLocal Tax ID Name
ASMAmerican Samoapassporttax_idSSN
AUSAustraliapassporttax_idTFN
CCKCocos (Keeling) Islandspassporttax_idTFN
COKCook Islandspassporttax_idTax ID
CXRChristmas Islandpassporttax_idTFN
FJIFijipassporttax_idTIN
FLKFalkland Islandspassporttax_idTax ID
FSMMicronesiapassporttax_idSSN
GUMGuampassporttax_idSSN
KIRKiribatipassporttax_idTax ID
MHLMarshall Islandspassporttax_idSSN
MNPNorthern Mariana Islandspassporttax_idSSN
NCLNew Caledonianational_idtax_idRIDET
NFKNorfolk Islandpassporttax_idTFN
NIUNiuepassporttax_idTax ID
NRUNaurupassporttax_idTax ID
NZLNew Zealandpassporttax_idIRD Number
PCNPitcairn Islandspassporttax_idTax ID
PLWPalaupassporttax_idSSN
PNGPapua New Guineapassporttax_idTIN
PYFFrench Polynesianational_idtax_idNIF
SLBSolomon Islandspassporttax_idTIN
TKLTokelaupassporttax_idTax ID
TONTongapassporttax_idTIN
TUVTuvalupassporttax_idTax ID
VUTVanuatupassporttax_idTIN
WLFWallis and Futunapassporttax_idTax ID
WSMSamoapassporttax_idTIN

Provider Limitations

While all 222 countries above are supported for user creation via the API, some territories may not be fully supported by the KYC/KYB verification provider. User creation will succeed, but identity verification may fail at the provider level for these countries.

Known unsupported countries:

CodeCountryImpact
BESBonaire, Sint Eustatius and SabaKYC and KYB verification submissions are rejected (Unknown country_code)

This list was validated via E2E testing against the provider sandbox (March 2026). If you encounter similar errors for other countries, please report them so this list can be updated.


Restricted Countries

The following 21 countries are restricted due to international sanctions. Users from these countries cannot access products like USA Virtual Accounts. The API will still create the user, but they will not be eligible for any product.

CodeCountry
AFGAfghanistan
BLRBelarus
CAFCentral African Republic
CIVCote d'Ivoire
CODDemocratic Republic of the Congo
CUBCuba
IRNIran
IRQIraq
LBRLiberia
LBYLibya
MMRMyanmar
PRKNorth Korea
RUSRussia
SAUSaudi Arabia
SDNSudan
SOMSomalia
SYRSyria
UKRUkraine
VENVenezuela
YEMYemen
ZWEZimbabwe

Complete Example Payloads

The following examples show complete POST /v1/users request bodies with all fields needed to trigger automatic verification.

Note: The base64 strings below are minimal valid files for testing. Replace with actual document images in production.

Document types: Only front and file_proof_of_address are required to trigger verification. However, sending all four documents (front, back, selfie, file_proof_of_address) is strongly recommended — the verification provider uses them for facial matching and document authenticity checks, which significantly improves approval rates.

USA Individual

{
  "type": "individual",
  "first_name": "John",
  "last_name": "Doe",
  "birth_date": "1990-01-15",
  "email": "[email protected]",
  "phone": "+12125551234",
  "nationality": "USA",
  "gender": "male",

  "address_street": "123 Main Street",
  "address_city": "New York",
  "address_state": "New York",
  "address_zip_code": "10001",
  "address_country": "USA",

  "document_type": "passport",
  "document_number": "987654321",
  "document_country": "USA",

  "source_of_funds": "salary",
  "account_purpose": "manage_personal_funds",
  "employment_status": "employed",
  "occupation": "Software Engineer",
  "pep_status": false,

  "identifying_information": [
    {
      "type": "passport",
      "issuing_country": "USA",
      "number": "987654321",
      "documents": [
        { "type": "front", "file": "data:image/jpeg;base64,..." },
        { "type": "back", "file": "data:image/jpeg;base64,..." },
        { "type": "selfie", "file": "data:image/jpeg;base64,..." },
        { "type": "file_proof_of_address", "file": "data:image/jpeg;base64,..." }
      ]
    },
    {
      "type": "ssn",
      "issuing_country": "USA",
      "number": "123-45-6789"
    }
  ]
}

International Individual (Mexico)

Uses tax_id with the local RFC value in number, and national_id document type.

{
  "type": "individual",
  "first_name": "Maria",
  "last_name": "Garcia",
  "birth_date": "1988-05-20",
  "email": "[email protected]",
  "phone": "+525512345678",
  "nationality": "MEX",
  "gender": "female",

  "address_street": "Av. Reforma 222",
  "address_city": "Mexico City",
  "address_state": "Ciudad de Mexico",
  "address_zip_code": "06600",
  "address_country": "MEX",

  "document_type": "national_id",
  "document_number": "1234567890123",
  "document_country": "MEX",

  "source_of_funds": "salary",
  "account_purpose": "make_payments",
  "employment_status": "employed",
  "occupation": "Accountant",
  "expected_monthly_payments": "5000_9999",
  "pep_status": false,

  "identifying_information": [
    {
      "type": "national_id",
      "issuing_country": "MEX",
      "number": "1234567890123",
      "documents": [
        { "type": "front", "file": "data:image/jpeg;base64,..." },
        { "type": "back", "file": "data:image/jpeg;base64,..." },
        { "type": "selfie", "file": "data:image/jpeg;base64,..." },
        { "type": "file_proof_of_address", "file": "data:image/jpeg;base64,..." }
      ]
    },
    {
      "type": "tax_id",
      "issuing_country": "MEX",
      "number": "GARM880520XXX"
    }
  ]
}

International Individual (UK)

Uses passport document type and tax_id with the local NIN value.

{
  "type": "individual",
  "first_name": "James",
  "last_name": "Williams",
  "birth_date": "1987-07-14",
  "email": "[email protected]",
  "phone": "+442072345678",
  "nationality": "GBR",
  "gender": "male",

  "address_street": "10 Downing Street",
  "address_city": "London",
  "address_state": "England",
  "address_zip_code": "SW1A 1AA",
  "address_country": "GBR",

  "document_type": "passport",
  "document_number": "533401572",
  "document_country": "GBR",

  "source_of_funds": "salary",
  "account_purpose": "manage_personal_funds",
  "employment_status": "employed",
  "occupation": "Financial Analyst",
  "expected_monthly_payments": "5000_9999",
  "pep_status": false,

  "identifying_information": [
    {
      "type": "passport",
      "issuing_country": "GBR",
      "number": "533401572",
      "documents": [
        { "type": "front", "file": "data:image/jpeg;base64,..." },
        { "type": "back", "file": "data:image/jpeg;base64,..." },
        { "type": "selfie", "file": "data:image/jpeg;base64,..." },
        { "type": "file_proof_of_address", "file": "data:image/jpeg;base64,..." }
      ]
    },
    {
      "type": "tax_id",
      "issuing_country": "GBR",
      "number": "QQ123456A"
    }
  ]
}

USA Business

{
  "type": "business",
  "business_legal_name": "Acme Technology Inc.",
  "doing_business_as": "Acme",
  "email": "[email protected]",
  "phone": "+12125551234",
  "business_type": "corporation",
  "business_description": "Enterprise SaaS platform",
  "business_industry": ["data_processing_hosting_related_services"],
  "business_website": "https://acmetech.com",

  "formation_date": "2018-03-15",
  "formation_state": "DE",

  "address_street": "100 Broadway",
  "address_city": "New York",
  "address_state": "New York",
  "address_zip_code": "10001",
  "address_country": "USA",

  "document_type": "passport",
  "document_number": "EIN123456789",
  "document_country": "USA",

  "representative_first_name": "Robert",
  "representative_last_name": "Smith",
  "representative_title": "CEO",
  "representative_birth_date": "1975-08-22",
  "representative_ssn": "987-65-4321",

  "source_of_funds": "sales_of_goods_and_services",
  "account_purpose": "receive_payments_for_goods_and_services",
  "pep_status": false,

  "identifying_information": [
    {
      "type": "ein",
      "issuing_country": "USA",
      "number": "12-3456789"
    },
    {
      "type": "business_formation",
      "issuing_country": "USA",
      "documents": [
        { "type": "file_business_formation", "file": "data:application/pdf;base64,..." }
      ]
    },
    {
      "type": "proof_of_address",
      "issuing_country": "USA",
      "documents": [
        { "type": "file_proof_of_address", "file": "data:application/pdf;base64,..." }
      ]
    }
  ],

  "associated_persons": [
    {
      "first_name": "Robert",
      "last_name": "Smith",
      "email": "[email protected]",
      "birth_date": "1975-08-22",
      "title": "CEO",
      "identifying_information": [
        {
          "type": "passport",
          "issuing_country": "USA",
          "number": "123456789",
          "documents": [
            { "type": "front", "file": "data:image/jpeg;base64,..." }
          ]
        }
      ]
    }
  ]
}

International Business (Mexico)

Uses tax_id with the local RFC value in number.

{
  "type": "business",
  "business_legal_name": "Tecnologia Avanzada S.A. de C.V.",
  "doing_business_as": "TecAv",
  "email": "[email protected]",
  "phone": "+525598765432",
  "business_type": "corporation",
  "business_description": "Enterprise software development",
  "business_industry": ["data_processing_hosting_related_services"],
  "business_website": "https://tecavanzada.mx",

  "formation_date": "2015-06-01",
  "formation_state": "Ciudad de Mexico",

  "address_street": "Paseo de la Reforma 505",
  "address_city": "Mexico City",
  "address_state": "Ciudad de Mexico",
  "address_zip_code": "06500",
  "address_country": "MEX",

  "document_type": "national_id",
  "document_number": "TAV150601XXX",
  "document_country": "MEX",

  "representative_first_name": "Carlos",
  "representative_last_name": "Hernandez",
  "representative_title": "Director General",
  "representative_birth_date": "1970-02-14",

  "source_of_funds": "sales_of_goods_and_services",
  "account_purpose": "receive_payments_for_goods_and_services",
  "expected_monthly_payments": "10000_49999",
  "pep_status": false,

  "identifying_information": [
    {
      "type": "tax_id",
      "issuing_country": "MEX",
      "number": "TAV150601XXX"
    },
    {
      "type": "business_formation",
      "issuing_country": "MEX",
      "documents": [
        { "type": "file_business_formation", "file": "data:application/pdf;base64,..." }
      ]
    },
    {
      "type": "proof_of_address",
      "issuing_country": "MEX",
      "documents": [
        { "type": "file_proof_of_address", "file": "data:application/pdf;base64,..." }
      ]
    }
  ],

  "associated_persons": [
    {
      "first_name": "Carlos",
      "last_name": "Hernandez",
      "email": "[email protected]",
      "birth_date": "1970-02-14",
      "title": "Director General",
      "identifying_information": [
        {
          "type": "national_id",
          "issuing_country": "MEX",
          "number": "HERC700214HDFRRL01",
          "documents": [
            { "type": "front", "file": "data:image/jpeg;base64,..." }
          ]
        }
      ]
    }
  ]
}

Quick Reference Decision Tree

Step 1: What is the user's address_country?

  • USA → Category: USA
  • Anything else → Category: International

Step 2: What document_type should I use?

  • Check the "Recommended Doc Type" column in the country tables above
  • When in doubt, use passport (accepted everywhere)

Step 3: What tax ID type should I send in identifying_information?

  • USA Individual → ssn (put SSN number in number)
  • USA Business → ein (put EIN number in number)
  • ALL other countries (individual and business) → tax_id (put the local tax ID value in number — e.g., RFC for Mexico, CPF for Brazil, NIN for Nigeria)

Step 4: Do I need expected_monthly_payments?

  • USA → No
  • International → Yes

Related Guides