Skip to main content

Standards

To simplify integration and ensure data integrity, some standards have been defined and are followed throughout the API.

Monetary Values​

Examples:

10000
12345
98741
1223
1
0

Values must be sent as integers in cents.

Date and Time with Timezone​

Some examples:

2019-10-15T22:35:12-03:00
2018-05-01T13:32:11+00:00
2019-05-01T00:00:00+00:00

It is represented according to the ISO 8601 standard. In this case, the timezone is placed immediately after the time and should represent the timezone of the location where that data will be valid. For example, if a rental is scheduled to start at 09:30 at Brasília airport, the time sent should be represented as 09:30-03:00; if the rental is scheduled to start at 09:30 in Manaus, it should be represented as 09:30-04:00.

The validation mask is as follows:

YYYY-MM-ddThh:mm:ss±hh:mm

Date and Time without Timezone​

Some examples:

2019-10-15T22:35:12Z
2018-05-01T13:32:11Z
2019-05-01T00:00:00Z

It is represented according to the ISO 8601 standard. Data that is independent of timezones should be sent without one, always in UTC, using the letter Z to indicate that the data is in UTC. Therefore, the following format will be validated:

YYYY-MM-ddThh:mm:ssZ

Date​

Some examples:

2019-10-15
2019-01-01
2017-03-20

For fields that only receive a date—such as a birthdate—only the date, without any time, should be sent in the following format:

YYYY-MM-dd