curl --request POST \
--url https://api.example.com/api/v1/ops/transport-operators \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"legalName": "Joao Silva Transportes Ltda",
"document": "12345678000190",
"documentType": "CNPJ",
"tradeName": "Silva Transportes"
}
'import requests
url = "https://api.example.com/api/v1/ops/transport-operators"
payload = {
"legalName": "Joao Silva Transportes Ltda",
"document": "12345678000190",
"documentType": "CNPJ",
"tradeName": "Silva Transportes"
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
legalName: 'Joao Silva Transportes Ltda',
document: '12345678000190',
documentType: 'CNPJ',
tradeName: 'Silva Transportes'
})
};
fetch('https://api.example.com/api/v1/ops/transport-operators', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.example.com/api/v1/ops/transport-operators",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'legalName' => 'Joao Silva Transportes Ltda',
'document' => '12345678000190',
'documentType' => 'CNPJ',
'tradeName' => 'Silva Transportes'
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.example.com/api/v1/ops/transport-operators"
payload := strings.NewReader("{\n \"legalName\": \"Joao Silva Transportes Ltda\",\n \"document\": \"12345678000190\",\n \"documentType\": \"CNPJ\",\n \"tradeName\": \"Silva Transportes\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.example.com/api/v1/ops/transport-operators")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"legalName\": \"Joao Silva Transportes Ltda\",\n \"document\": \"12345678000190\",\n \"documentType\": \"CNPJ\",\n \"tradeName\": \"Silva Transportes\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.example.com/api/v1/ops/transport-operators")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"legalName\": \"Joao Silva Transportes Ltda\",\n \"document\": \"12345678000190\",\n \"documentType\": \"CNPJ\",\n \"tradeName\": \"Silva Transportes\"\n}"
response = http.request(request)
puts response.read_body{
"transportOperatorId": "0195e7a1-8b5c-7d3e-9f4a-2c6b8d0e1f3a",
"cooperativeId": "0195e7a1-8b5c-7d3e-9f4a-2c6b8d0e1f3a",
"legalName": "Joao Silva Transportes Ltda",
"document": "12345678000190",
"documentType": "CNPJ",
"status": "ACTIVE",
"regularityStatus": "REGULAR",
"createdAt": "2026-01-01T00:00:00.000Z",
"updatedAt": "2026-01-01T00:00:00.000Z",
"tradeName": "Silva Transportes",
"blockedReason": null,
"approvedBy": null,
"createdBy": null,
"updatedBy": null,
"deletedBy": null,
"approvedAt": null,
"deletedAt": null
}{
"errors": [
{
"message": "required",
"path": "name"
}
],
"message": "Bad Request Error",
"statusCode": 400
}{
"message": "Missing or invalid access token",
"statusCode": 401
}{
"message": "Insufficient permissions",
"statusCode": 403
}{
"message": "Internal Server Error",
"statusCode": 500
}Define Transport Operator
Defines a transport operator.
curl --request POST \
--url https://api.example.com/api/v1/ops/transport-operators \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"legalName": "Joao Silva Transportes Ltda",
"document": "12345678000190",
"documentType": "CNPJ",
"tradeName": "Silva Transportes"
}
'import requests
url = "https://api.example.com/api/v1/ops/transport-operators"
payload = {
"legalName": "Joao Silva Transportes Ltda",
"document": "12345678000190",
"documentType": "CNPJ",
"tradeName": "Silva Transportes"
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
legalName: 'Joao Silva Transportes Ltda',
document: '12345678000190',
documentType: 'CNPJ',
tradeName: 'Silva Transportes'
})
};
fetch('https://api.example.com/api/v1/ops/transport-operators', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.example.com/api/v1/ops/transport-operators",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'legalName' => 'Joao Silva Transportes Ltda',
'document' => '12345678000190',
'documentType' => 'CNPJ',
'tradeName' => 'Silva Transportes'
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.example.com/api/v1/ops/transport-operators"
payload := strings.NewReader("{\n \"legalName\": \"Joao Silva Transportes Ltda\",\n \"document\": \"12345678000190\",\n \"documentType\": \"CNPJ\",\n \"tradeName\": \"Silva Transportes\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.example.com/api/v1/ops/transport-operators")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"legalName\": \"Joao Silva Transportes Ltda\",\n \"document\": \"12345678000190\",\n \"documentType\": \"CNPJ\",\n \"tradeName\": \"Silva Transportes\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.example.com/api/v1/ops/transport-operators")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"legalName\": \"Joao Silva Transportes Ltda\",\n \"document\": \"12345678000190\",\n \"documentType\": \"CNPJ\",\n \"tradeName\": \"Silva Transportes\"\n}"
response = http.request(request)
puts response.read_body{
"transportOperatorId": "0195e7a1-8b5c-7d3e-9f4a-2c6b8d0e1f3a",
"cooperativeId": "0195e7a1-8b5c-7d3e-9f4a-2c6b8d0e1f3a",
"legalName": "Joao Silva Transportes Ltda",
"document": "12345678000190",
"documentType": "CNPJ",
"status": "ACTIVE",
"regularityStatus": "REGULAR",
"createdAt": "2026-01-01T00:00:00.000Z",
"updatedAt": "2026-01-01T00:00:00.000Z",
"tradeName": "Silva Transportes",
"blockedReason": null,
"approvedBy": null,
"createdBy": null,
"updatedBy": null,
"deletedBy": null,
"approvedAt": null,
"deletedAt": null
}{
"errors": [
{
"message": "required",
"path": "name"
}
],
"message": "Bad Request Error",
"statusCode": 400
}{
"message": "Missing or invalid access token",
"statusCode": 401
}{
"message": "Insufficient permissions",
"statusCode": 403
}{
"message": "Internal Server Error",
"statusCode": 500
}Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Query Parameters
Comma-separated list of fields to include in the response. Supports dot notation for nested projection (e.g. id,name,user.email,trips.route.id). Unknown fields are silently dropped.
Body
Define transport operator payload
Response
Created
Transport operator
Transport operator identifier
"0195e7a1-8b5c-7d3e-9f4a-2c6b8d0e1f3a"
Cooperative identifier
"0195e7a1-8b5c-7d3e-9f4a-2c6b8d0e1f3a"
Legal name
"Joao Silva Transportes Ltda"
Document
"12345678000190"
Document type
CPF, CNPJ "CNPJ"
Transport operator status
PENDING_APPROVAL, ACTIVE, INACTIVE, BLOCKED, REJECTED "ACTIVE"
Regularity status
PENDING_REVIEW, REGULAR, IRREGULAR "REGULAR"
Created at
"2026-01-01T00:00:00.000Z"
Updated at
"2026-01-01T00:00:00.000Z"
Trade name
"Silva Transportes"
Blocked reason
null
Approved by
null
Created by
null
Updated by
null
Deleted by
null
Approved at
null
Deleted at
null