/
36 - Taxpayer registration information

36 - Taxpayer registration information


Service for obtaining information on the registration of an entity with tax authorities as a taxpayer or as a single tax payer.


The report contains the following components:

Http Method

POST

Request XML
( ** parameters are passed optionally)

{

"doc": {

"ubki": {

"req_envelope": {

"req_xml": {

"request": {

"i": {

"ident": {

"okpo": "Taxpayer Identification Number (TIN) /USREOU",

"lname": "**Last name",

"fname": "**First name",

"mname": "**Middle name",

"bdate": "**Date of birth"

},

"additionaldata": {

"source": "**Name of the register for verification (fiskregistration - Register of Taxpayers, edpod - Register of Single Taxpayers, bpartner - Tax Debt Check)"

},

"reqlng": "Search criteria language (code from ref.23)"

},

"version": "1.0",

"reqtype": "Template code (code from ref.49): Taxpayer registration information' - 36",

"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": {

"taxagent": {

"okpo": "Taxpayer Identification Number (TIN) /USREOU",

"found": "Availability of taxpayer registration information, numeric value: -2/-1/0/1",

"foundref": "Availability of taxpayer registration information, text value (code from ref.58)",

"source": "Name of the data source, text value",

"response": "Taxpayer registration information in JSON format"

},

"id": "48",

"descr": "Taxpayer registration information"

}

}

}

Request XML
( ** parameters are passed optionally)

<?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): Taxpayer registration information' - 36"

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="**Tax/Taxpayer Identification Number (INN-RNUKPN)/EDRPOU" 

                     lname="**Last name" 

                     fname="**First name" 

                     mname="**Middle name"

bdate="**Date of birth"/>

</ident>

<!-- Query Parameters: Information on Taxpayer Registration -->

<additionaldata source="**Name of the register for verification (fiskregistration - Register of Taxpayers, edpod - Register of Single Taxpayers, bpartner - Tax Debt Check)"/>

</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>

<!-- Taxpayer registration information -->

<comp id="48" descr="Taxpayer registration information">

<taxagent okpo="Taxpayer Identification Number (TIN) /USREOU"

found="Availability of taxpayer registration information, numeric value: -2/-1/0/1"

foundref="Availability of taxpayer registration information, text value (code from ref.58)"

source="Name of the data source, text value"

response="Taxpayer registration information in JSON format"/>

</comp>

</ubkidata>

Example

Example

Request JSON

{ "doc": { "ubki": { "req_envelope": { "req_xml": { "request": { "i": { "ident": { "okpo": "9876543211" }, "additionaldata": { "source": "fiskregistration" }, "reqlng": "4" }, "version": "1.0", "reqtype": "36", "reqreason": "2" }, "descr": "Request object" }, "descr": "Request envelope" }, "sessid": "4EC8D647B0DB4D9A862CDC25AB00000F" } } }

Response JSON

{ "ubkidata": { "tech": { "trace": { "step": [ { "name": "build report", "stm": "2025-01-24 13:45:50.011", "ftm": "2025-01-24 13:45:50.168" } ] }, "error": [], "reqinfo": { "reqid": "req2#000003432928" } }, "comp": [ { "id": "48", "descr": "Taxpayer registration information", "taxagent": { "found": "1", "foundref": "Found information", "okpo": "3233312110", "source": "bpartner", "response": "[{\"registry_id\":\"b-partner\",\"registry_name\":\"Дізнайся більше про свого бізнес-партнера\",\"updated_datetime\":null,\"short_info\":\"Дані відсутні - зараз не оновлюються\",\"short_info_color\":\"gray\",\"message\":\"Дані відсутні - зараз не оновлюються\",\"data\":null}]" } } ] } }

Request XML

<doc> <ubki sessid="C1D901B26FFF4277B443FC432791A4B9"> <req_envelope descr="Request object"> <req_xml descr="Request envelope"> <request version="1.0" reqtype="36" reqreason="2" > <i reqlng="1"> <ident okpo="9876543211" /> <additionaldata source="fiskregistration" /> </i> </request> </req_xml> </req_envelope> </ubki> </doc>

Response XML

Test URL

Test data

  • okpo=”2726020593” source="fiskregistration/edpod/bpartner"

  • okpo=”9876543211” source="fiskregistration/edpod/bpartner"

  • okpo=”3233312110” source="fiskregistration/edpod/bpartner"

  • okpo=”1231231231” source="fiskregistration/edpod/bpartner"

  • okpo=”33359334” source="bpartner"