Here we'll describe the changes and deprecations to our api to help you keep up to date
2023-09-07
We added support for a new faculty on chilean "Empresa en un Día" entities. You can find it alongside all other faculties with the code F053-GFB
and key "sobregirar cuentas corrientes".
2022-11-29
We're pleased to announce that our API can now be used to validate people. This is why we chose to change the "business" model to "entity". This means that some routes changed and some parameters where renamed to make sense in this new context.
What do I have to change exactly?
- Change the path on your api calls from
/api/v1/business_validations/
to/api/v1/entity_validations/
- When creating a new entity validation the body must contain an object called entity_validation instead of business_validation i.e
{
entity_validation: { ... }
}
- When creating an Entity Validation, the parameters from the body
business_tin
andbusiness_country
were renamed totin
andcountry
respectively. - When retrieving a Validation the attributes
business_validation_id
,business_name
,business_tin
andbusiness_country
where renamed toentity_validation_id
,entity_name
,entity_tin
andentity_country
. Also, the "business" object is now called "entity". - The attribute
entity_category
was added to the Validation object. - The attribute
category
was added to the Entity object.
2022-11-16
Re-validations and monitoring are here! Now you're allowed to create a business validation and re-run it whenever you want. We even support automatic re-validations every certain amount of time so you don't have to manually do it.
What changes?
We created a new model called Business Validation and it can have many validations. It acts like a wrapper for all validations of the same business and has a few settings you can use to configure automatic re-validations in case you need it.
This is a new model. For instance, it has a different id than its validations. This id is obtainable when retrieving a validation or creating a new business validation.
The business validation object contains an array with all it's validations ids and date of creation. It also contains a last_validation
object with full details of the last validation. This object is exactly the same than before. Please refer to the Business Validations reference
This introduces a few breaking changes:
- All endpoints under the path
/validations
, exceptGET /validation/:id
, have been deprecated and will be removed by 2023-01-01.
What do I have to change exactly?
- Change the path on your api calls from
/api/v1/validations/
to/api/v1/business_validations/
- When creating a new business validation the body must contain an object called business_validation instead of validation i.e
{
business_validation: { ... }
}
- Now you should store the
business_validation_id
that starts withbval_
instead ofval_
- The information from the validation now it's located in the
last_validation
object inside the business validation. - You can still use the GET
/api/v1/validations/:id
to retrieve a specific validation from the past. - And that's it, the rest remains the same!
2022-11-15
- Added new endpoint
/api/v1/utilities/chile/chilean_id_serial_validation
to verify if a chilean rut and it's serial number match and are active check it out here
2022-10-20
- The field
validation.business.formation.date_of_document
has been deprecated - The field
webhook_url
has been added to the validation object to create webhooks. It will also be present when retrieving a validation. Read mode about webhooks here