curl --request POST \
--url https://api.example.com/api/v1/bko/transport-operator-subsidy-settlements/{transportOperatorSubsidySettlementId}/approve \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.example.com/api/v1/bko/transport-operator-subsidy-settlements/{transportOperatorSubsidySettlementId}/approve"
headers = {"Authorization": "Bearer <token>"}
response = requests.post(url, headers=headers)
print(response.text)const options = {method: 'POST', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.example.com/api/v1/bko/transport-operator-subsidy-settlements/{transportOperatorSubsidySettlementId}/approve', 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/bko/transport-operator-subsidy-settlements/{transportOperatorSubsidySettlementId}/approve",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.example.com/api/v1/bko/transport-operator-subsidy-settlements/{transportOperatorSubsidySettlementId}/approve"
req, _ := http.NewRequest("POST", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
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/bko/transport-operator-subsidy-settlements/{transportOperatorSubsidySettlementId}/approve")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.example.com/api/v1/bko/transport-operator-subsidy-settlements/{transportOperatorSubsidySettlementId}/approve")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"transportOperatorSubsidySettlementId": "01980d37-a8dc-755a-8a7c-27372a096a7b",
"cooperativeId": "0197a800-24e6-76a2-90ed-ff0f6fba7b0c",
"cooperative": {
"cooperativeId": "0195e7a1-8b5c-7d3e-9f4a-2c6b8d0e1f3a",
"organizationId": "0195e7a1-8b5c-7d3e-9f4a-2c6b8d0e1f3a",
"organization": {
"document": "45.723.174/0001-10",
"documentType": "CNPJ",
"name": "Cooperativa Metropolitana",
"organizationId": "0195e7a1-8b5c-7d3e-9f4a-2c6b8d0e1f3a",
"type": "COOPERATIVE",
"email": "contato@estrela.com",
"legalName": "Cooperativa Metropolitana de Transporte Ltda.",
"logo": "organizations/0195e7a1-8b5c-7d3e-9f4a-2c6b8d0e1f3a/logo/0195e7b2-4a3c-7d3e-9f4a-2c6b8d0e1f3b.png",
"tradeName": "Metropolitana"
}
},
"transportOperatorId": "01980d30-6a3c-7a42-9182-17ad6324d3aa",
"transportOperator": {
"document": "12345678000190",
"documentType": "CNPJ",
"legalName": "Joao Silva Transportes Ltda",
"transportOperatorId": "0195e7a1-8b5c-7d3e-9f4a-2c6b8d0e1f3a",
"tradeName": "Silva Transportes"
},
"transportOperatorRoutePolicyId": "01980d36-4381-7c81-8786-230f12cb35c0",
"tripCount": 1,
"auditedDistanceKm": 18,
"amountPerKm": 200,
"grossAmount": 3600,
"status": "PENDING",
"createdAt": "2026-07-04T13:30:00.000Z",
"periodEnd": "2026-07-04T12:30:00.000Z",
"periodStart": "2026-07-04T08:00:00.000Z",
"trip": {
"status": "SCHEDULED",
"tripId": "0195e7a1-8b5c-7d3e-9f4a-2c6b8d0e1f3a",
"departureAt": "2023-11-07T05:31:56Z",
"estimatedArrivalAt": "2023-11-07T05:31:56Z"
},
"updatedAt": "2026-07-04T14:00:00.000Z",
"routeId": "0197a80c-4204-7b77-9005-48cc23677587",
"tripId": "0197a80f-2d8f-7710-b243-b67fb477a1c0",
"approvedBy": null,
"paidBy": null,
"createdBy": null,
"updatedBy": null,
"approvedAt": null,
"paidAt": 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
}Approve Transport Operator Subsidy Settlement
Approves a transport operator subsidy settlement.
curl --request POST \
--url https://api.example.com/api/v1/bko/transport-operator-subsidy-settlements/{transportOperatorSubsidySettlementId}/approve \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.example.com/api/v1/bko/transport-operator-subsidy-settlements/{transportOperatorSubsidySettlementId}/approve"
headers = {"Authorization": "Bearer <token>"}
response = requests.post(url, headers=headers)
print(response.text)const options = {method: 'POST', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.example.com/api/v1/bko/transport-operator-subsidy-settlements/{transportOperatorSubsidySettlementId}/approve', 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/bko/transport-operator-subsidy-settlements/{transportOperatorSubsidySettlementId}/approve",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.example.com/api/v1/bko/transport-operator-subsidy-settlements/{transportOperatorSubsidySettlementId}/approve"
req, _ := http.NewRequest("POST", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
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/bko/transport-operator-subsidy-settlements/{transportOperatorSubsidySettlementId}/approve")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.example.com/api/v1/bko/transport-operator-subsidy-settlements/{transportOperatorSubsidySettlementId}/approve")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"transportOperatorSubsidySettlementId": "01980d37-a8dc-755a-8a7c-27372a096a7b",
"cooperativeId": "0197a800-24e6-76a2-90ed-ff0f6fba7b0c",
"cooperative": {
"cooperativeId": "0195e7a1-8b5c-7d3e-9f4a-2c6b8d0e1f3a",
"organizationId": "0195e7a1-8b5c-7d3e-9f4a-2c6b8d0e1f3a",
"organization": {
"document": "45.723.174/0001-10",
"documentType": "CNPJ",
"name": "Cooperativa Metropolitana",
"organizationId": "0195e7a1-8b5c-7d3e-9f4a-2c6b8d0e1f3a",
"type": "COOPERATIVE",
"email": "contato@estrela.com",
"legalName": "Cooperativa Metropolitana de Transporte Ltda.",
"logo": "organizations/0195e7a1-8b5c-7d3e-9f4a-2c6b8d0e1f3a/logo/0195e7b2-4a3c-7d3e-9f4a-2c6b8d0e1f3b.png",
"tradeName": "Metropolitana"
}
},
"transportOperatorId": "01980d30-6a3c-7a42-9182-17ad6324d3aa",
"transportOperator": {
"document": "12345678000190",
"documentType": "CNPJ",
"legalName": "Joao Silva Transportes Ltda",
"transportOperatorId": "0195e7a1-8b5c-7d3e-9f4a-2c6b8d0e1f3a",
"tradeName": "Silva Transportes"
},
"transportOperatorRoutePolicyId": "01980d36-4381-7c81-8786-230f12cb35c0",
"tripCount": 1,
"auditedDistanceKm": 18,
"amountPerKm": 200,
"grossAmount": 3600,
"status": "PENDING",
"createdAt": "2026-07-04T13:30:00.000Z",
"periodEnd": "2026-07-04T12:30:00.000Z",
"periodStart": "2026-07-04T08:00:00.000Z",
"trip": {
"status": "SCHEDULED",
"tripId": "0195e7a1-8b5c-7d3e-9f4a-2c6b8d0e1f3a",
"departureAt": "2023-11-07T05:31:56Z",
"estimatedArrivalAt": "2023-11-07T05:31:56Z"
},
"updatedAt": "2026-07-04T14:00:00.000Z",
"routeId": "0197a80c-4204-7b77-9005-48cc23677587",
"tripId": "0197a80f-2d8f-7710-b243-b67fb477a1c0",
"approvedBy": null,
"paidBy": null,
"createdBy": null,
"updatedBy": null,
"approvedAt": null,
"paidAt": 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.
Path Parameters
Subsidy settlement identifier
"01980d37-a8dc-755a-8a7c-27372a096a7b"
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.
Response
OK
Transport operator subsidy settlement
Subsidy settlement identifier
"01980d37-a8dc-755a-8a7c-27372a096a7b"
Cooperative identifier
"0197a800-24e6-76a2-90ed-ff0f6fba7b0c"
Cooperative
Show child attributes
Show child attributes
Transport operator identifier
"01980d30-6a3c-7a42-9182-17ad6324d3aa"
Transport operator
Show child attributes
Show child attributes
Route policy identifier
"01980d36-4381-7c81-8786-230f12cb35c0"
Audited trip count
1
Audited distance in kilometers
x >= 018
Amount per kilometer in cents
200
Gross amount in cents
3600
Transport operator subsidy settlement status
PENDING, UNDER_REVIEW, APPROVED, REJECTED, PAID "PENDING"
Created at
"2026-07-04T13:30:00.000Z"
Period end
"2026-07-04T12:30:00.000Z"
Period start
"2026-07-04T08:00:00.000Z"
Show child attributes
Show child attributes
Updated at
"2026-07-04T14:00:00.000Z"
Route identifier
"0197a80c-4204-7b77-9005-48cc23677587"
Trip identifier
"0197a80f-2d8f-7710-b243-b67fb477a1c0"
Approved by
null
Paid by
null
Created by
null
Updated by
null
Approved at
null
Paid at
null