FNS Check
Check counterparties by INN or OGRN via the Federal Tax Service API
fn
ФНС Проверка (Federal Tax Service Check) provides API access to the Russian Federal Tax Service (ФНС) database for verifying legal entities and individual entrepreneurs by their INN (taxpayer number) or OGRN (state registration number).
With the FNS Check integration in AACFlow, you can:
- Check by INN: Retrieve company details (name, address, status, management) by INN
- Check by OGRN: Look up an organization using its OGRN registration number
This integration is essential for counterparty due diligence, KYC, and onboarding automation in Russian business workflows.
Usage Instructions
Integrate FNS Check into the workflow. Requires an API key from api-fns.ru. Register and obtain the key in your account dashboard.
Tools
fns_check_inn
Check organization by INN
Input
| Parameter | Type | Required | Description |
|---|---|---|---|
apiKey | string | Yes | FNS API key |
inn | string | Yes | INN number (10 or 12 digits) |
Output
| Parameter | Type | Description |
|---|---|---|
name | string | Organization full name |
shortName | string | Short name |
ogrn | string | OGRN number |
status | string | Organization status (active, liquidated, etc.) |
address | string | Legal address |
kpp | string | KPP code |
success | boolean | Whether the request succeeded |
fns_check_ogrn
Check organization by OGRN
Input
| Parameter | Type | Required | Description |
|---|---|---|---|
apiKey | string | Yes | FNS API key |
ogrn | string | Yes | OGRN or OGRNIP number |
Output
| Parameter | Type | Description |
|---|---|---|
name | string | Organization full name |
inn | string | INN number |
status | string | Organization status |
address | string | Legal address |
success | boolean | Whether the request succeeded |
Links
- Official API: https://api-fns.ru/docs
- AACFlow block source: apps/aacflow/blocks/blocks/fns_check.ts