curl --request GET \
--url https://api.sandbox.tesouro.com/finops/v1/approval-requests/{approval_request_id} \
--header 'Authorization: Bearer <token>' \
--header 'x-finops-version: <x-finops-version>' \
--header 'x-organization-id: <x-organization-id>'import requests
url = "https://api.sandbox.tesouro.com/finops/v1/approval-requests/{approval_request_id}"
headers = {
"x-finops-version": "<x-finops-version>",
"x-organization-id": "<x-organization-id>",
"Authorization": "Bearer <token>"
}
response = requests.get(url, headers=headers)
print(response.text)const options = {
method: 'GET',
headers: {
'x-finops-version': '<x-finops-version>',
'x-organization-id': '<x-organization-id>',
Authorization: 'Bearer <token>'
}
};
fetch('https://api.sandbox.tesouro.com/finops/v1/approval-requests/{approval_request_id}', 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.sandbox.tesouro.com/finops/v1/approval-requests/{approval_request_id}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"x-finops-version: <x-finops-version>",
"x-organization-id: <x-organization-id>"
],
]);
$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.sandbox.tesouro.com/finops/v1/approval-requests/{approval_request_id}"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("x-finops-version", "<x-finops-version>")
req.Header.Add("x-organization-id", "<x-organization-id>")
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.get("https://api.sandbox.tesouro.com/finops/v1/approval-requests/{approval_request_id}")
.header("x-finops-version", "<x-finops-version>")
.header("x-organization-id", "<x-organization-id>")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.sandbox.tesouro.com/finops/v1/approval-requests/{approval_request_id}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["x-finops-version"] = '<x-finops-version>'
request["x-organization-id"] = '<x-organization-id>'
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"created_at": "2023-11-07T05:31:56Z",
"updated_at": "2023-11-07T05:31:56Z",
"approval_type": "user_ids",
"approved_by": [
"3c90c3cc-0d44-4b50-8888-8dd25736052a"
],
"object_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"object_type": "account",
"required_approval_count": 2,
"status": "waiting",
"user_ids": [
"3c90c3cc-0d44-4b50-8888-8dd25736052a"
],
"caller_is_policy_approver": true,
"created_by": "ea837e28-509b-4b6a-a600-d54b6aa0b1f5",
"reject_reason": "<string>",
"rejected_by": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"role_ids": [
"3c90c3cc-0d44-4b50-8888-8dd25736052a"
],
"submitted_by": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}{
"error": {
"message": "<string>"
}
}{
"error": {
"message": "<string>"
}
}{
"error": {
"message": "<string>"
}
}{
"error": {
"message": "<string>"
}
}{
"error": {
"message": "<string>"
}
}{
"error": {
"message": "<string>"
}
}{
"detail": [
{
"loc": [
"<string>"
],
"msg": "<string>",
"type": "<string>"
}
]
}{
"error": {
"message": "<string>"
}
}Get approval request
curl --request GET \
--url https://api.sandbox.tesouro.com/finops/v1/approval-requests/{approval_request_id} \
--header 'Authorization: Bearer <token>' \
--header 'x-finops-version: <x-finops-version>' \
--header 'x-organization-id: <x-organization-id>'import requests
url = "https://api.sandbox.tesouro.com/finops/v1/approval-requests/{approval_request_id}"
headers = {
"x-finops-version": "<x-finops-version>",
"x-organization-id": "<x-organization-id>",
"Authorization": "Bearer <token>"
}
response = requests.get(url, headers=headers)
print(response.text)const options = {
method: 'GET',
headers: {
'x-finops-version': '<x-finops-version>',
'x-organization-id': '<x-organization-id>',
Authorization: 'Bearer <token>'
}
};
fetch('https://api.sandbox.tesouro.com/finops/v1/approval-requests/{approval_request_id}', 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.sandbox.tesouro.com/finops/v1/approval-requests/{approval_request_id}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"x-finops-version: <x-finops-version>",
"x-organization-id: <x-organization-id>"
],
]);
$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.sandbox.tesouro.com/finops/v1/approval-requests/{approval_request_id}"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("x-finops-version", "<x-finops-version>")
req.Header.Add("x-organization-id", "<x-organization-id>")
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.get("https://api.sandbox.tesouro.com/finops/v1/approval-requests/{approval_request_id}")
.header("x-finops-version", "<x-finops-version>")
.header("x-organization-id", "<x-organization-id>")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.sandbox.tesouro.com/finops/v1/approval-requests/{approval_request_id}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["x-finops-version"] = '<x-finops-version>'
request["x-organization-id"] = '<x-organization-id>'
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"created_at": "2023-11-07T05:31:56Z",
"updated_at": "2023-11-07T05:31:56Z",
"approval_type": "user_ids",
"approved_by": [
"3c90c3cc-0d44-4b50-8888-8dd25736052a"
],
"object_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"object_type": "account",
"required_approval_count": 2,
"status": "waiting",
"user_ids": [
"3c90c3cc-0d44-4b50-8888-8dd25736052a"
],
"caller_is_policy_approver": true,
"created_by": "ea837e28-509b-4b6a-a600-d54b6aa0b1f5",
"reject_reason": "<string>",
"rejected_by": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"role_ids": [
"3c90c3cc-0d44-4b50-8888-8dd25736052a"
],
"submitted_by": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}{
"error": {
"message": "<string>"
}
}{
"error": {
"message": "<string>"
}
}{
"error": {
"message": "<string>"
}
}{
"error": {
"message": "<string>"
}
}{
"error": {
"message": "<string>"
}
}{
"error": {
"message": "<string>"
}
}{
"detail": [
{
"loc": [
"<string>"
],
"msg": "<string>",
"type": "<string>"
}
]
}{
"error": {
"message": "<string>"
}
}Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Headers
The ID of the entity that owns the requested resource.
"9d2b4c8f-2087-4738-ba91-7359683c49a4"
Path Parameters
Response
Successful Response
An approval request as seen by one particular caller.
Read endpoints only. The write actions keep returning ApprovalRequestResourceWithMetadata,
so they neither carry a value that is stale by the time it is read nor pay for the lookup.
user_ids, role, reporting_manager account, accounting_config, accounting_tax_rate, approval, approval_request, approval_policy, approval_policy_process, audit_trail, bank_account, comment, cost_center, counterpart, counterpart_address, counterpart_bank_account, counterpart_contact_person, counterpart_partner_metadata, counterpart_tax_id, counterpart_vat_id, delivery_note, einvoicing, entity, entity_bank_account, entity_settings, entity_token, entity_user, entity_user_token, entity_vat_ids, export, ledger_account, mailbox, monitescript_process, ocr_task, onboarding, overdue_reminder, partner, partner_internal_config, partner_settings, partner_token, payable, payable_line_item, payables_credit_note, payables_purchase_order, payment, payment_intent, payment_link, payment_record, payment_reminder, person, product, project, receivable, reconciliation, recurrence, receipt, role, tag, todo_task, todo_task_mute, transaction, transaction_validation, webhook, workflow, workflow_pipeline x >= 1waiting, approved, rejected, canceled Whether the approval policy on this request routes it to the calling user. Answered per caller, so it must not be cached against the approval request id alone. It is also the only thing that governs approving and rejecting here: a caller this reports false for is refused, whatever permissions they hold. Force approve is a separate action on the service that owns the object.
true
ID of the user who created the approval request, or None if it was created by the system (e.g. by an approval policy worker).
"ea837e28-509b-4b6a-a600-d54b6aa0b1f5"
Was this page helpful?