Skip to content
On this page

What you need to know about requests

All requests must be made using the HTTPS protocol. The request body must be sent in JSON format, or multipar/form-data for file upload.

Example:

http
POST /api/v1/shipments HTTP/1.1
Host: sandbox.tristarexpress.com
Content-Type: application/json
Accept: application/json
# Other headers
# Accept-Encoding: gzip, deflate
# User-Agent: ...
# Content-Length: ...

Responses in the desired format

To receive the responses in JSON, you must send the header Accept: application/xml in the request.

http
POST /api/v1/shipments HTTP/1.1
Host: sandbox.tristarexpress.com
Content-Type: application/json
Accept: application/json

Responses in other languages

For default responses will be in English, but you can change the response language by sending the Accept-Language header in the request. So error messages and other texts will be returned in the desired language.

http
POST /v1/shipments HTTP/1.1
Host: sandbox.tristarexpress.com
Content-Type: application/json
Accept: application/json
Accept-Language: pt-BR

Some times the desired language may not be available at the moment, in this case the response will be returned in the default language (en-US).

Date and time format

Our API uses the ISO 8601 format for dates and times. Example: 2023-01-01T00:00:00Z.