Search of forms of organization
General information
The directory contains the list of legal forms of organization.
Search of legal forms of organization
Method request
Request structure
Method address: https://api.dellin.ru/v1/references/opf_list.json
{
"appkey":"00000000-0000-0000-0000-000000000000",
"title":"Отк",
"name":"ОАО",
"countryUID":"0x8f51001438c4d49511dbd774581edb7a"
}Method address: https://api.dellin.ru/v1/references/opf_list.xml
<request> <appkey>00000000-0000-0000-0000-000000000000</appkey> <title>Отк</title> <name>ОАО</name> <countryUID>0x8f51001438c4d49511dbd774581edb7a</countryUID> </request>
Description of parameters
| Request | |||
|---|---|---|---|
| Parameter | R* | Type | Description |
| appkey | Yes | string | Application key. To get the key, register |
| title | No* | string | Full legal form name or its fragment. Minimum string length - 3 characters. Search by the beginning and by the end of the string. *Only one of the following parameters can be passed in a request: "title" or "name" |
| name | No* | string | Short name of the legal form (ООО, ОАО, etc.). Search from the beginning of the string, exact match is required. *Only one of the following parameters can be passed in a request: "title" or "name" |
| countryUID | No | string | Country UID, see "Countries search" |
Method response
Response structure
{
"metadata":{
"status":200,
"generated_at":"2015-06-18 12:37:28"
},
"data":[
{
"uid":"0x8390b2048d37e0154b845fb22793e865",
"name":"ОАО",
"juridical":"true",
"title":"Открытое Акционерное Общество",
"innLength":10,
"countryUID":"0x8f51001438c4d49511dbd774581edb7a"
}
]
}<response>
<metadata>
<status>200</status>
<generated_at>2015-06-18 12:37:28</generated_at>
</metadata>
<data>
<uid>0x8390b2048d37e0154b845fb22793e865</uid>
<name>ОАО</name>
<juridical>true</juridical>
<title>Открытое Акционерное Общество</title>
<innLength>10</innLength>
<countryUID>0x8f51001438c4d49511dbd774581edb7a</countryUID>
</data>
</response>Description of parameters
| Response | ||
|---|---|---|
| Parameter | Type | Description |
| metadata | object | System information |
| metadata.status | integer | Emulated status http-code. If successful, code 200 is returned |
| metadata.generated_at | string | Server response date and time. Format: YYYY-MM-DD HH:MM:SS |
| data | array of Data | Information on legal form |
| data.uid | string | Legal form UID |
| data.name | string | Short name of the legal form (ООО, ОАО, etc.) |
| data.juridical | boolean | Legal entity indicator |
| data.title | string | Full legal form name |
| data.innLength | integer | Required number of digits in TIN |
| data.countryUID | string | Country UID, see "Countries search" |
Error handling
The common API errors are used with the method, for errors format description and errors list see Errors of API methods.
