Legal entity

list

request
GET /api/v2/legal-entities?searchString=644901490342 HTTP/1.1
Table 192. request description
Parameter Description

searchString

search by inn or shortName all Matches
Example: ?searchString=an

closed

Is legal entity closed? Default value is false

pageable

Pageable description
response
HTTP/1.1 200 OK

{
  "content" : [ {
    "id" : 1,
    "shortName" : "ИП Валеева Людмила Александровна",
    "inn" : "644901490342",
    "kpp" : "0",
    "ogrn" : "304644929900308",
    "okpo" : "0"
  } ],
  "pageable" : {
    "pageNumber" : 0,
    "pageSize" : 10,
    "sort" : {
      "empty" : false,
      "sorted" : true,
      "unsorted" : false
    },
    "offset" : 0,
    "paged" : true,
    "unpaged" : false
  },
  "last" : true,
  "totalElements" : 1,
  "totalPages" : 1,
  "first" : true,
  "size" : 10,
  "number" : 0,
  "sort" : {
    "empty" : false,
    "sorted" : true,
    "unsorted" : false
  },
  "numberOfElements" : 1,
  "empty" : false
}
Table 193. response description
Path Type Description

id

Number

The legal entity’s id

shortName

String

The legal entity’s short name

inn

String

The legal entity’s inn

kpp

String

The legal entity’s kpp

ogrn

String

The legal entity’s ogrn

okpo

String

The legal entity’s okpo

create

request
POST /api/v2/legal-entities HTTP/1.1

{
  "name" : "ПОКРОВСК-ОПТИКА",
  "shortName" : "ООО \"ПОКРОВСК-ОПТИКА ПЛЮС\"",
  "inn" : "2605252913",
  "ogrn" : "1026401985576",
  "kpp" : "6050114874",
  "okpo" : "123",
  "taxScheme" : "SIMPLE",
  "taxDto" : {
    "vat" : "NON_TAXABLE",
    "startOn" : "2025-06-27"
  },
  "priceTag" : "123",
  "checkTag" : null,
  "address" : "894308, Орловская область, город Павловский Посад, спуск Чехова, 73",
  "federalSubjectCode" : null,
  "city" : null,
  "phone" : "3(7497)392-49-56",
  "paymentAccount" : "40817810099910004312",
  "bankName" : "Тинькофф банк",
  "bankIdentificationCode" : "044525974",
  "bankCorrespondentAccount" : "234234324"
}
response
HTTP/1.1 201 Created
Location: /api/v2/legal-entities

{
  "id" : 17,
  "name" : "ПОКРОВСК-ОПТИКА",
  "shortName" : "ООО \"ПОКРОВСК-ОПТИКА ПЛЮС\"",
  "inn" : "2605252913",
  "ogrn" : "1026401985576",
  "kpp" : "6050114874",
  "okpo" : "123",
  "taxScheme" : "SIMPLE",
  "taxDto" : {
    "vat" : "NON_TAXABLE",
    "startOn" : "2025-06-27"
  },
  "priceTag" : "123",
  "checkTag" : null,
  "address" : "894308, Орловская область, город Павловский Посад, спуск Чехова, 73",
  "federalSubjectCode" : null,
  "city" : null,
  "phone" : "3(7497)392-49-56",
  "paymentAccount" : "40817810099910004312",
  "bankName" : "Тинькофф банк",
  "bankIdentificationCode" : "044525974",
  "bankCorrespondentAccount" : "234234324",
  "closed" : false
}

get

request
GET /api/v2/legal-entities/23 HTTP/1.1
Table 195. /api/v2/legal-entities/{legalEntityId}
Parameter Description

legalEntityId

legalEntityId
response
HTTP/1.1 200 OK

{
  "id" : 23,
  "name" : "ПОКРОВСК-ОПТИКА",
  "shortName" : "ООО \"ПОКРОВСК-ОПТИКА ПЛЮС\"",
  "inn" : "7473171750",
  "ogrn" : "1026401985576",
  "kpp" : "4033396386",
  "okpo" : "123",
  "taxScheme" : "SIMPLE",
  "taxDto" : {
    "vat" : "NON_TAXABLE",
    "startOn" : "2025-06-27"
  },
  "priceTag" : "123",
  "checkTag" : null,
  "address" : "894308, Орловская область, город Павловский Посад, спуск Чехова, 73",
  "federalSubjectCode" : null,
  "city" : null,
  "phone" : "3(7497)392-49-56",
  "paymentAccount" : "40817810099910004312",
  "bankName" : "Тинькофф банк",
  "bankIdentificationCode" : "044525974",
  "bankCorrespondentAccount" : "234234324",
  "closed" : false
}

update

request
PUT /api/v2/legal-entities/21 HTTP/1.1

{
  "name" : "ПОКРОВСК-ОПТИКА1",
  "shortName" : "ООО \"ПОКРОВСК-ОПТИКА ПЛЮС1\"",
  "inn" : "0046701692",
  "ogrn" : "1029991985576",
  "kpp" : "8519069823",
  "okpo" : "456",
  "taxScheme" : "PATENT",
  "priceTag" : "4564",
  "checkTag" : null,
  "address" : "555555, Орловская область, город Павловский Посад, спуск Чехова, 73",
  "federalSubjectCode" : null,
  "city" : null,
  "phone" : "3(7497)777-77-77",
  "paymentAccount" : "40777810099910004312",
  "bankName" : "Тинькофф банк2",
  "bankIdentificationCode" : "944525999",
  "bankCorrespondentAccount" : "934234999"
}
Table 196. /api/v2/legal-entities/{legalEntityId}
Parameter Description

legalEntityId

legalEntityId
Path Type Description Constraints

name

String

The legal entity’s name

Must not be blank.
Size must be between 0 and 50 inclusive

shortName

String

The legal entity’s short name

inn

String

The legal entity’s inn

kpp

String

The legal entity’s kpp

ogrn

String

The legal entity’s ogrn

okpo

String

The legal entity’s okpo

taxScheme

String

The legal entity’s tax scheme

priceTag

String

The legal entity’s price tag

checkTag

String

The legal entity’s check tag

checkTag

String

The legal entity’s address

phone

String

The legal entity’s phone

Size must be between 0 and 30 inclusive

paymentAccount

String

The legal entity’s payment account

bankName

String

The legal entity’s bank name

bankIdentificationCode

String

The legal entity’s bank identification code

bankCorrespondentAccount

String

The legal entity’s bank correspondent account
response
HTTP/1.1 200 OK

delete

request
DELETE /api/v2/legal-entities/19 HTTP/1.1
Table 197. /api/v2/legal-entities/{legalEntityId}
Parameter Description

legalEntityId

legalEntityId
response
HTTP/1.1 200 OK

← Previous: Tax Deduction | ↑ Up: Optima2 API v.2 REST | Next: Legal entity - section link →