Skip to main content

Person Creation

To create people for their respective accounts, segregation between the natural_person_account and legal_person_account endpoints must be maintained.

To request the creation of a person for an account, simply send a Person object to one of the following endpoints, respecting the segregation defined during account creation.

Individual Account (Natural Person)​

Natural Person Creation​

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

Example

{
    "id": "cc2f97ba-08c8-4a91-8d0d-49313a6c1245",
    "registration_date": "2024-11-04T13:37:00Z",
    "data": {
        "name": "John Doe",
        "document_number": "123.456.789-09",
        "birthdate": "2000-07-13"
    }
}
  • Natural Person Creation

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

Example

{
    "id": "cc2f97ba-08c8-4a91-8d0d-49313a6c1245",
    "registration_date": "2024-11-04T13:37:00Z",
    "data": {
        "name": "John Doe",
        "document_number": "123.456.789-09",
        "birthdate": "2000-07-13"
    }
}

The birthdate field is mandatory only for accounts that have status monitoring with the Brazilian Federal Revenue Service. It is required to query individuals under 18 years old.

  • Legal Person Creation

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

Example

{
    "id": "cc2f97ba-08c8-4a91-8d0d-49313a6c1245",
    "registration_date": "2024-11-04T13:37:00Z",
    "data": {
        "name": "Empresa das Tampas",
        "document_number": "12.482.243/0001-34"
    }
}

Person Deactivation and Reactivation​

The deactivation and reactivation of people follows the same logic used for accounts, using the endpoints below.

Natural Person Account​

  • Natural Person

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

Example

{
    "new_person_status" : "deactivated"
}
  • Natural Person

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

Example

{
    "new_person_status" : "deactivated"
}
  • Legal Person

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

Example

{
    "new_person_status" : "deactivated"
}

To reactivate previously deactivated people, the operation is the same as the one used to deactivate people, but sending new_person_status as active to the following endpoints:

Natural Person Account​

  • Natural Person

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

Example

{
    "new_person_status" : "active"
}
  • Natural Person

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

Example

{
    "new_person_status" : "active"
}
  • Legal Person

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

Example

{
    "new_person_status" : "active"
}