Skip to content

INN Check

Method for checking a self-employed individual's INN in the system. Lets you find out whether the self-employed individual has accepted the invitation from the FNS (Federal Tax Service) and is registered in the system.

URL

Method: GET

  • Production: https://api.baas.kvell.group/v1/smz/inn/check?inn={inn}
  • Stage: https://api.baas.stage.kvell.group/v1/smz/inn/check?inn={inn}

Request parameters

Name Data type Required Description
inn string Yes Self-employed individual's INN

Request headers

Name Data type Required Description
X-Api-Key string Yes Unique shop identifier
X-Signature string Yes Signature

The X-Signature signature is built by concatenating X-Api-Key, inn, and secret_key, then taking sha256 of the resulting string:

sha256({X-Api-Key}{inn}{secret_key})

where secret_key is the secret key found in the merchant's shop settings.

Request response

Example response

{
  "status": "registered",
  "message": "Client registered"
}

{
  "errors": [
    {
      "message": "string",
      "code": 0
    }
  ]
}

Response parameters

  • status — the self-employed individual's status:
    • registered — the self-employed individual is registered in the system, a receipt can be generated.
    • unregistered — the self-employed individual is not registered, an invitation must be sent.
    • pending — the self-employed individual is in the process of registration.
    • error — status check error.
  • message — status message.