curl --request POST \
--url https://api.example.com/api/v1/bko/route-approvals/{routeApprovalId}/reject \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"rejectionReason": "Origin and destination need review."
}
'import requests
url = "https://api.example.com/api/v1/bko/route-approvals/{routeApprovalId}/reject"
payload = { "rejectionReason": "Origin and destination need review." }
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({rejectionReason: 'Origin and destination need review.'})
};
fetch('https://api.example.com/api/v1/bko/route-approvals/{routeApprovalId}/reject', 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/route-approvals/{routeApprovalId}/reject",
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([
'rejectionReason' => 'Origin and destination need review.'
]),
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/bko/route-approvals/{routeApprovalId}/reject"
payload := strings.NewReader("{\n \"rejectionReason\": \"Origin and destination need review.\"\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/bko/route-approvals/{routeApprovalId}/reject")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"rejectionReason\": \"Origin and destination need review.\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.example.com/api/v1/bko/route-approvals/{routeApprovalId}/reject")
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 \"rejectionReason\": \"Origin and destination need review.\"\n}"
response = http.request(request)
puts response.read_body{
"routeApprovalId": "0197f150-40d6-7c1a-bdf2-c5884e07d401",
"cooperativeId": "0197a800-24e6-76a2-90ed-ff0f6fba7b0c",
"routeId": "0195e7a1-8b5c-7d3e-9f4a-2c6b8d0e1f3a",
"requestedBy": "0197a7f6-2c4d-74ae-b89b-9d36d9c341f2",
"status": "PENDING",
"createdAt": "2026-01-01T00:00:00.000Z",
"requestedAt": "2026-01-01T00:00:00.000Z",
"updatedAt": "2026-01-01T00:00:00.000Z",
"transportOperatorId": null,
"reviewedBy": null,
"rejectionReason": null,
"createdBy": null,
"updatedBy": null,
"reviewedAt": 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
}Reject Route Approval
Rejects a route approval.
curl --request POST \
--url https://api.example.com/api/v1/bko/route-approvals/{routeApprovalId}/reject \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"rejectionReason": "Origin and destination need review."
}
'import requests
url = "https://api.example.com/api/v1/bko/route-approvals/{routeApprovalId}/reject"
payload = { "rejectionReason": "Origin and destination need review." }
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({rejectionReason: 'Origin and destination need review.'})
};
fetch('https://api.example.com/api/v1/bko/route-approvals/{routeApprovalId}/reject', 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/route-approvals/{routeApprovalId}/reject",
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([
'rejectionReason' => 'Origin and destination need review.'
]),
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/bko/route-approvals/{routeApprovalId}/reject"
payload := strings.NewReader("{\n \"rejectionReason\": \"Origin and destination need review.\"\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/bko/route-approvals/{routeApprovalId}/reject")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"rejectionReason\": \"Origin and destination need review.\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.example.com/api/v1/bko/route-approvals/{routeApprovalId}/reject")
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 \"rejectionReason\": \"Origin and destination need review.\"\n}"
response = http.request(request)
puts response.read_body{
"routeApprovalId": "0197f150-40d6-7c1a-bdf2-c5884e07d401",
"cooperativeId": "0197a800-24e6-76a2-90ed-ff0f6fba7b0c",
"routeId": "0195e7a1-8b5c-7d3e-9f4a-2c6b8d0e1f3a",
"requestedBy": "0197a7f6-2c4d-74ae-b89b-9d36d9c341f2",
"status": "PENDING",
"createdAt": "2026-01-01T00:00:00.000Z",
"requestedAt": "2026-01-01T00:00:00.000Z",
"updatedAt": "2026-01-01T00:00:00.000Z",
"transportOperatorId": null,
"reviewedBy": null,
"rejectionReason": null,
"createdBy": null,
"updatedBy": null,
"reviewedAt": 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
Route approval identifier
"0197f150-40d6-7c1a-bdf2-c5884e07d401"
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
Reject route approval payload
Rejection reason
"Origin and destination need review."
Response
OK
Route approval
Route approval identifier
"0197f150-40d6-7c1a-bdf2-c5884e07d401"
Cooperative identifier
"0197a800-24e6-76a2-90ed-ff0f6fba7b0c"
Route identifier
"0195e7a1-8b5c-7d3e-9f4a-2c6b8d0e1f3a"
Requesting user identifier
"0197a7f6-2c4d-74ae-b89b-9d36d9c341f2"
Route approval status
PENDING, APPROVED, REJECTED "PENDING"
Created at
"2026-01-01T00:00:00.000Z"
Requested at
"2026-01-01T00:00:00.000Z"
Updated at
"2026-01-01T00:00:00.000Z"
Transport operator identifier
null
Reviewing user identifier
null
Rejection reason
null
Created by
null
Updated by
null
Reviewed at
null