Skip to main content

Account Creation

The Account Monitoring Product is divided into Individual Accounts (Natural Person) and Corporate Accounts (Legal Person). An Individual Account may contain only natural persons, while a Corporate Account may contain both legal entities and natural persons. To create an account, simply send an object of type Account to one of the following endpoints:

  • Individual Account (Natural Person)

POST https://api.caas.qitech.app/account_monitoring/natural_person_account

Example

{
    "account_id": "5ce7fab5-8165-44a5-9b89-bb2d6d61e4f4",
    "registration_date": "2019-12-20T15:23:12"
}
  • Corporate Account (Legal Person)

POST https://api.caas.qitech.app/account_monitoring/legal_person_account

Example

{
    "account_id": "5ce7fab5-8165-44a5-9b89-bb2d6d61e4f4",
    "registration_date": "2019-12-20T15:23:12"
}

All information exchanges related to an account registration use the following object definition. In some cases, to simplify the implementation and reduce data flow between parties, some information may be omitted.

nametypedescription
account_idstringUnique account identifier.
This value must be unique for each request
registration_datestring (ISO 8601)Account registration date and time.

Account Deactivation and Reactivation​

To deactivate an account within the Account Monitoring product, send a request to the following endpoint with the payload below, setting the new_account_status field to deactivated:

  • Individual Account (Natural Person)

PATCH https://api.caas.qitech.app/account_monitoring/natural_person_account/{account_id}

Example

{
    "new_account_status": "deactivated"
}
  • Corporate Account (Legal Person)

PATCH https://api.caas.qitech.app/account_monitoring/legal_person_account/{account_id}

Example

{
    "new_account_status": "deactivated"
}

This will deactivate the account and interrupt its monitoring. To reactivate an account — and consequently resume its monitoring — send a request to the same endpoint, now setting new_account_status to active:

  • Individual Account (Natural Person)

PATCH https://api.caas.qitech.app/account_monitoring/natural_person_account/{account_id}

Example

{
    "new_account_status": "active"
}
  • Corporate Account (Legal Person)

PATCH https://api.caas.qitech.app/account_monitoring/legal_person_account/{account_id}

Example

{
    "new_account_status": "active"
}

When an account is reactivated, the monitoring intervals for all account topics are reset. For example, if all topics are monitored every 24 hours, after reactivation the updates will occur 24 hours after the account is reactivated.