Skip to main content

API Servers

  • checklists.fin-observe.com
  • res1-checklists.fin-observe.com
  • res2-checklists.fin-observe.com

Request Type

Input Parameters

Required

IDsubjectFM
string
required
FM Subject ID (assigned when registering FM Subject in the “FinAP CheckLists” PC). Received to the email of the responsible person
tokken
string
required
FM Subject Unique User Key (provided when registering FM Subject in the “FinAP CheckLists” PC). Received by email of the responsible person

Main

name
string
Surname, first name, patronymic or name of the person
ipn
string
Individual tax number of the resident individual (most registers do not contain data on the RNOKPP), or EDRPOU of the resident legal entity
date
date
Date of birth of the individual in the format “YYYY-MM-DD”
doc
string
Details of the individual’s document (national passport, ID card or passport for traveling abroad) in the format of series and number, or simply number (if ID card). The presence or absence of a space between the series and the number is not important

Additional

IDinternal
string
Internal unique request ID (generated on the FM subject side)
DateRequest
datetime
Date and time of request generation (generated on the FM subject side) in the format “YYYY-MM-DD hh:mm:ss”
IDuserPC
string
Workstation ID of the FM subject (assigned on the FM subject side)
listdata
numeric
default:"-1"
A number, each bit of which, when converted to binary format, determines the list of databases (lists) in which the search (or the sum of numbers that match the search lists). For example, to search in the current sanctions lists “listdata”: 127 — “0000 0000 0000 0111 1111”. See Table 2. By default, the value that matches the query in all service registries is used
Method for searching for matches in registries (1 — full-text (default), 2 — with error correction). Default is 1
lowranklimit
numeric
default:"0"
A number that defines the lower limit of name or full name matches in percentage
namelat
string
Surname, first name, patronymic or name in Latin. By default, it is generated from the name field based on the results of the transliteration algorithm
nonrezedentcode
string
Non-resident code
city
string
Name of the settlement. Used to search for entrepreneurs in the Register of Legal Entities and Individual Entrepreneurs by place of registration, as well as in the register of tax debtors by tax authority
doctype
numeric
default:"0"
Document type. Can take the values ​​1 (PASSPORT OF A CITIZEN OF UKRAINE including ID cards), 2 (PASSPORT OF A CITIZEN OF UKRAINE FOR TRAVELING ABROAD), 0 – both options. Default is 0
edrchangesfrom
date
default:"1991-08-24"
The start date of the period of changes in the Unified State Register (for Analysis) in the format “YYYY-MM-DD”
edrchangesto
date
default:"now()"
The end date of the period of changes in the Unified State Register (for Analysis) in the format “YYYY-MM-DD”
arrayedrpou
string[]
List (array) of EDRPOU codes for which changes in the Unified State Register are analyzed during the specified period
onlyactual
boolean
default:"true"
This parameter specifies whether to return the current record or all records in the register (true – current, false - all). Default is current.