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
ID of the financial monitoring entity (assigned during registration of the financial monitoring entity in the “FinAP CheckLists” system). Sent to the email address of the responsible person.
tokken
string
required
Unique user key of the financial monitoring entity (assigned during registration of the financial monitoring entity in the “FinAP CheckLists” system). Sent to the email address of the responsible person.

Main

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

Additional

IDinternal
string
Internal unique request ID (generated on the side of the financial monitoring entity)
DateRequest
datetime
Date and time of request generation (generated on the side of the financial monitoring entity) in the format “YYYY-MM-DD hh:mm:ss”
IDuserPC
string
ID of the workstation of the financial monitoring entity (assigned on the side of the financial monitoring entity)
listdata
numeric
default:"-1"
A number whose each bit, when converted to binary format, determines the list of databases (lists) in which the search must be performed (or the sum of numbers corresponding to search lists). For example, for searching in active sanction lists, “listdata”: 127 — “0000 0000 0000 0111 1111”. See Table 2. By default, the value corresponding to a request across all service registers is used.
Match search method across registers (1 — full-text (default), 2 — with error correction). Default is 1.
lowranklimit
numeric
default:"0"
A number defining the lower threshold of name or full name matches in percent
namelat
string
Surname, first name, patronymic, or name in Latin script. By default, it is generated from the name field using the transliteration algorithm.
nonrezedentcode
string
Non-resident code
city
string
Name of the locality. Used to search for entrepreneurs in the Register of Legal Entities and Individual Entrepreneurs by place of registration, as well as in the tax debtors register by tax authority affiliation.
doctype
numeric
default:"0"
Document type. Possible values: 1 (Passport of a Citizen of Ukraine, including ID card), 2 (Passport of a Citizen of Ukraine for travel abroad), 0 — both types. Default is 0.
edrchangesfrom
date
default:"1991-08-24"
Start date of the period of changes in the EDR (for analysis) in the format “YYYY-MM-DD”
edrchangesto
date
default:"now()"
End date of the period of changes in the EDR (for analysis) in the format “YYYY-MM-DD”
arrayedrpou
string[]
List (array) of EDRPOU codes for which changes in the EDR are analyzed during the specified period
onlyactual
boolean
default:"true"
This parameter specifies whether to return only the current record or all records available in the register (true — current only, false — all). Default is current only.