55 - Constituent documents of the company
The report contains the founding documents of a legal entity and is intended for verifying the company’s legal status, management structure, and assessing potential legal risks in cooperation.
The report contains the following components:
Http Method | POST |
---|---|
Request URL | https://secure.ubki.ua/b2_api_xml/ubki/xml |
Request JSON{ "doc": { "ubki": { "req_envelope": { "req_xml": { "request": { "i": { "ident": { "okpo": "EDRPOU" }, "additionaldata": { "decode": "An optional parameter that defines the response data format: true — the response returns individual files extracted from the archive; false (default) — the response contains a single archive encoded in Base64 format.", "contentMode": "Optional parameter that determines which report component is requested: statutory — only component 86 - Legal Entity Incorporation Documents, structure — only component 87 - Legal Entity Ownership Structure, all — both components simultaneously (default). If multiple requests for the same subject are made during a calendar day, billing occurs only once." }, "reqlng": "Search criteria language (code from ref.23)" }, "version": "1.0", "reqtype": "Template code (code from ref.49): 'Statutory Documents of the Company' - 55", "reqreason": "Request objective (code from ref.24)" }, "descr": "Request object" }, "descr": "Request envelope" }, "sessid": "Session key (obtained from the authorization API)" } } |
Response JSON{ "ubkidata": { "tech": { "trace": { "step": { "name": "Step name", "stm": "Step start stamp date", "ftm": "Step finish stamp date" } }, "error": { "errtype": "Error code (code from ref.0)", "errtext": "Error text (value from ref.0)" }, "reqinfo": { "reqid": "Outgoing request ID generated by UBKI" }, "billing": { "balance": { "value": "Total assets", "date": "Date", "time": "Time" }, "billdetails": { "freemon": "Sign of free of charge according to the request type ‘Monitoring the client of the organization’ (reqreason=1), code (0 - No, 1 - Yes)", "freemonref": "Sign of free of charge according to the request type ‘Monitoring the client of the organization‘ (reqreason=1), value (0 - No, 1 - Yes)" } } }, "comp": [ { "id": "86", "descr": "Statutory Documents of the Company", "statutoryinfo": { "edrpou": "EDRPOU code used for the request", "found": "0 – Information not found, 1 – Information found", "foundref": "Information not found / Information found", "filesDescription": { "code": "EDRPOU code used for the search in the EDR", "name": "Company name ", "absentReason": "Reason for the absence of scanned copies of statutory documents", "documents": [ { "docName": "Document name ", "fileType": "Document file type (PDF or TIFF) ", "docSize": "Document file size", "number": "Document number", "dateFrom": "Document date" } ] }, "documentFile": [ { "fileName": "File name", "fileType": "File type", "fileData": "Base64-encoded file content" } ], "documentZipFile": { "fileData": "Base64-encoded ZIP archive content" } } }, { "id": "87", "descr": "Ownership structure of the legal entity", "statutoryinfo": { "edrpou": "EDRPOU code used for the request", "found": "0 – Information not found, 1 – Information found", "foundref": "Information not found / Information found", "filesDescription": { "code": "EDRPOU code used for the search in the EDR", "name": "Company name ", "absentReason": "Reason for the absence of scanned copies of the ownership structure", "documents": [ { "docName": "Document name ", "fileType": "Document file type (PDF or TIFF) ", "docSize": "Document file size", "number": "Document number", "dateFrom": "Document date" } ] }, "documentFile": [ { "fileName": "File name", "fileType": "File type", "fileData": "Base64-encoded file content" } ], "documentZipFile": { "fileData": "Base64-encoded ZIP archive content" } } } ] } } |
Request XML<?xml version="1.0" encoding="utf-8"?> <doc> <ubki sessid="Session key (obtained from the authorization API)"> <req_envelope descr="Request envelope"> <req_xml descr="Request object"> <!-- Request parameters --> <request version="1.0" reqtype="Template code (code from ref.49): 'Statutory Documents of the Company' - 55" reqreason="Request objective (code from ref.24)"> <!-- Parameters describing search criteria--> <i reqlng="Search criteria language (code from ref.23)"> <!-- Subject identification parameters--> <ident okpo="EDRPOU" /> <!-- Response configuration parameters --> <additionaldata decode="An optional parameter that defines the response data format: true — the response returns individual files extracted from the archive; false (default) — the response contains a single archive encoded in Base64 format." contentMode="Optional parameter that determines which report component is requested: statutory — only component 86 - Legal Entity Incorporation Documents, structure — only component 87 - Legal Entity Ownership Structure, all — both components simultaneously (default). If multiple requests for the same subject are made during a calendar day, billing occurs only once." /> </i> </request> </req_xml> </req_envelope> </ubki> </doc> |
Response XML<?xml version="1.0" encoding="utf-8"?> <ubkidata> <!-- System information part --> <tech> <trace> <step name="Step name" stm="Step start stamp date" ftm="Step finish stamp date"> <!-- The trace part contains timing metrics of components generation steps --> </step> </trace> <error errtype="Error code (code from ref.0)" errtext="Error text (value from ref.0)"> </error> <reqinfo reqid="Outgoing request ID generated by UBKI"> </reqinfo> <!-- Information about the current status of the prepaid account part--> <billing> <balance value="Total assets" date="Date" time="Time" /> <billdetails freemon="Sign of free of charge according to the request type 'Monitoring the client of the organization' (reqreason=1), code (0 - No, 1 - Yes)" freemonref="Sign of free of charge according to the request type 'Monitoring the client of the organization' (reqreason=1), value (0 - No, 1 - Yes)"/> </billing> </tech> </tech> <!-- Section containing information about the founding documents --> <comp id="86" descr="Statutory Documents of the Company"> <statutoryinfo edrpou="EDRPOU code used for the request" found="0 – Information not found, 1 – Information found " foundref="Information not found/Information found"> <filesDescription code="EDRPOU code used for the search in the EDR" name="Company name " absentReason="Reason for the absence of scanned copies of statutory documents"> <documents docName="Document name " fileType="Document file type (PDF or TIFF)" docSize="Document file size" number="Document number" dateFrom="Document date"/> </filesDescription> <!-- For mode true: block with Base64-encoded individual files extracted from the archive --> <documentFile fileName="File name" fileType="File type" fileData="Base64-encoded file content"/> <!-- For mode false (default): block with a Base64-encoded archive --> <documentZipFile fileData="Base64-encoded ZIP archive content"/> </statutoryinfo> </comp> <!-- Ownership structure information block --> <comp id="87" descr="Ownership structure of the legal entity"> <statutoryinfo edrpou="EDRPOU code used for the request" found="0 – Information not found, 1 – Information found " foundref="Information not found/Information found"> <filesDescription code="EDRPOU code used for the search in the EDR" name="Company name " absentReason="Reason for the absence of scanned copies of ownership structure documents"> <documents docName="Document name " fileType="Document file type (PDF or TIFF)" docSize="Document file size" number="Document number" dateFrom="Document date"/> </filesDescription> <!-- For mode true: block with Base64-encoded individual files extracted from the archive --> <documentFile fileName="File name" fileType="File type" fileData="Base64-encoded file content"/> <!-- For mode false (default): block with a Base64-encoded archive --> <documentZipFile fileData="Base64-encoded ZIP archive content"/> </statutoryinfo> </comp> </ubkidata> |
Example |
---|
Request JSON | {
"doc": {
"ubki": {
"req_envelope": {
"req_xml": {
"request": {
"i": {
"ident": {
"okpo": "12345632"
},
"additionaldata": {
"decode": "true",
"contentMode": "statutory"
},
"reqlng": "1"
},
"version": "1.0",
"reqtype": "55",
"reqreason": "2"
},
"descr": ""
},
"descr": ""
},
"sessid": "776DF1F9A72A4749B6AF76BEFA111111"
}
}
} |
Response JSON | {
"ubkidata": {
"tech": {
"trace": {
"step": [
{
"name": "build report",
"stm": "2025-05-29 10:11:22.91",
"ftm": "2025-05-29 10:11:23.834"
}
]
},
"error": [],
"reqinfo": {
"reqid": "req2#001122197352"
}
},
"comp": [
{
"id": "86",
"descr": "Statutory Documents of the Company",
"statutoryinfo": {
"edrpou": "12345632",
"found": "1",
"foundref": "Information found",
"filesDescription": {
"code": "12345632",
"name": "ТОВАРИСТВО З ОБМЕЖЕНОЮ ВІДПОВІДАЛЬНІСТЮ "ХІМПОБУТ"",
"absentReason": "",
"documents": [
{
"docName": "Статут (нова редакція)",
"fileType": "PDF",
"docSize": 12977333,
"number": "б/н",
"dateFrom": "2021-06-07T00:00:00.000Z"
}
]
},
"documentZipFile": {
"fileData": "UEsDBBQACAgIAOdJvVoAAAAAAAAAAAAAAAA...."
}
}
}
]
}
} |
Request XML | <?xml version="1.0" encoding="UTF-8"?>
<doc>
<ubki sessid="776DF1F9A72A4749B6AF76BEFA111111">
<req_envelope descr="">
<req_xml descr="">
<request version="1.0" reqtype="55" reqreason="2">
<i reqlng="4">
<ident okpo="12345632" />
<additionaldata decode="true" contentMode="statutory"/>
</i>
</request>
</req_xml>
</req_envelope>
</ubki>
</doc> |
Response XML | <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<ubkidata>
<tech>
<trace>
<step name="build report" stm="2025-05-29 10:26:03.417" ftm="2025-05-29 10:26:06.168"/>
</trace>
<reqinfo reqid="req2#001122197352"/>
</tech>
<comp id="86" descr="Statutory Documents of the Company">
<statutoryinfo edrpou="12345632" found="1" foundref="Information found">
<filesDescription code="12345632" name="ТОВАРИСТВО З ОБМЕЖЕНОЮ ВІДПОВІДАЛЬНІСТЮ "ЕПІЦЕНТР К"" absentReason="">
<documents docName="Статут (нова редакція)" fileType="PDF" docSize="12977333" number="б/н" dateFrom="2021-06-07T00:00:00.000Z"/>
</filesDescription>
<documentFile fileName="Статут (нова редакція)_1" fileType="pdf" fileData="UEsDBBQACAgIAOdJvVoAAAAAAAAAAAAAAAA...."/>
</statutoryinfo>
</comp>
</ubkidata> |
XSD Schema request | |
---|---|
XSD Schema response | https://secure.ubki.ua/b2/js/xsd/response55.xsd |
Test URL | |
---|---|
Test data |
|