Get accruals

GET /api/check
Returns a list of accruals by organization TIN and personal account. The response is always an array if accruals are found, otherwise a 404 error is returned..

🔐Authentication

Query parameters

ParameterType/FormatRequiredDescriptionExample
tinstring<10 to 12 characters>✅Organization TIN7712345678
accountstring<1 to 100 characters>✅Personal account numberЛС-1234567890

Request example

GET /api/check?tin=9731062087&account=ЛС-1234567890

Response

ParameterType/FormatRequiredDescriptionExample
idstring<uuid>✅Unique accrual identifier75b12bb4-a87b-4c5d-8e4d-900802c67ed3
categorystring✅Accrual categoryКвартплата, Электроэнергия
accountstring✅Payer's personal accountЛС-1234567890
toPaystring✅Amount to pay15620.50
periodstring<YYYY-MM-01>✅Accrual period2025-08-01
addressstring✅Property addressг Москва, ул Тверская, д 15, кв 42
addressKeystring<uuid>✅The unique Address ID0c5b2444-70a0-4932-980c-b4dc0d3f02b5
unitTypestring❌Unit typeflat, parking, commercial
unitNamestring❌Unit number/name42, 123А
organizationstring✅Recipient organization nameООО УК "Столичный дом"
tinstring✅Organization TIN7712345678
iecstring❌Organization IEC (Tax Registration Reason Code)770101001
routingNumberstring✅Recipient bank BIC (Bank Identification Code)044525555
bankAccountstring✅Organization bank account40702810500000001234
receiptFileUrlstring❌Link to the receipthttps://example.com/receipt.pdf
purposestring✅Payment purpose for bank transferКвартплата за август 2025 г. по лицевому счету ЛС-1234567890

Response example

json
{ "data": [ { "id": "c7f3a892-e5b1-4d6c-8a9f-1234567890ab", "category": "Квартплата", "account": "ЛС-7845123690", "toPay": "15620.50", "period": "2025-08-01", "address": "г Москва, ул Тверская, д 15, кв 42", "addressKey": "0c5b2444-70a0-4932-980c-b4dc0d3f02b5", "unitType": "flat", "unitName": "42", "organization": "ООО УК \"Столичный дом\"", "tin": "7712345678", "iec": "770101001", "routingNumber": "044525555", "bankAccount": "40702810500000001234", "receiptFileUrl": "https://teststorage.com/receipts/august-2025.pdf", "purpose": "Оплата жилищно-коммунальных услуг за август 2025" }, ] }

Error Codes

Код ошибкиHTTP статусСообщениеПричинаРешение
VALIDATION_FAILED400Invalid format of inputParameter validation errorCheck the parameter format
ACCOUNT_NOT_FOUND404Account number is not foundAccrual for this account not foundVerify the account number
INTERNAL_SERVER_ERROR500Internal server errorInternal server errorTry again later or contact support