Get an operation

curl --request GET \
  --url https://api.sandbox.tracefinance.com/v1/operations/{operationId} \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://api.sandbox.tracefinance.com/v1/operations/{operationId}"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.sandbox.tracefinance.com/v1/operations/{operationId}', 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.tracefinance.com/v1/operations/{operationId}",
  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>"
  ],
]);

$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.tracefinance.com/v1/operations/{operationId}"

	req, _ := http.NewRequest("GET", 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))

}

require 'uri'
require 'net/http'

url = URI("https://api.sandbox.tracefinance.com/v1/operations/{operationId}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "id": "1f3a8c8d-2e1a-4b3a-9d2e-7c1a4b3a9d2e",
  "externalId": null,
  "customer": {
    "id": "11111111-1111-1111-1111-111111111111"
  },
  "account": {
    "id": "a1b2c3d4-5e6f-7890-abcd-ef1234567890",
    "owner": "Acme Importação Ltda"
  },
  "sourceAmount": {
    "value": "500.00",
    "asset": "BRL",
    "decimals": 2
  },
  "targetAmount": {
    "value": "500.00",
    "asset": "BRL",
    "decimals": 2
  },
  "fees": [
    {
      "amount": {
        "value": "2.50",
        "asset": "BRL",
        "decimals": 2
      },
      "source": "PLATFORM"
    }
  ],
  "transactions": [
    {
      "id": "E0036030520260425024100000000001",
      "direction": "DEBIT",
      "amount": {
        "value": "500.00",
        "asset": "BRL",
        "decimals": 2
      },
      "status": "CONFIRMED"
    }
  ],
  "tags": [
    {
      "key": "psp",
      "value": "Amazon"
    },
    {
      "key": "compliance-tier",
      "value": "high"
    }
  ],
  "currentState": {
    "status": "COMPLETED",
    "createdAt": "2026-04-25T02:41:03Z"
  },
  "intent": {
    "type": "WITHDRAWAL",
    "beneficiary": {
      "id": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
      "entity": {
        "type": "INDIVIDUAL",
        "firstName": "John",
        "lastName": "Doe",
        "identificationDocument": {
          "value": "52998224725",
          "type": "CPF"
        },
        "birthDate": "1990-01-15",
        "address": {
          "addressLine1": "Rua Augusta, 500",
          "addressLine2": null,
          "city": "Sao Paulo",
          "state": "SP",
          "country": "BR",
          "postalCode": "01304-001"
        }
      },
      "paymentInstruction": {
        "id": "c3d4e5f6-a7b8-9012-cdef-1234567890ab",
        "rail": "PIX_KEY",
        "keyType": "CPF",
        "key": "12345678901"
      }
    }
  },
  "quote": {
    "id": "d4e5f6a7-b8c9-0123-defa-2345678901bc",
    "effectiveRate": {
      "value": "1.00",
      "base": "BRL",
      "quote": "BRL"
    },
    "expiresAt": "2026-04-25T02:39:47Z"
  },
  "refund": null,
  "createdAt": "2026-04-25T02:39:17Z",
  "updatedAt": "2026-04-25T02:41:03Z"
}

GET

operations

{operationId}

Get an operation

curl --request GET \
  --url https://api.sandbox.tracefinance.com/v1/operations/{operationId} \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://api.sandbox.tracefinance.com/v1/operations/{operationId}"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.sandbox.tracefinance.com/v1/operations/{operationId}', 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.tracefinance.com/v1/operations/{operationId}",
  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>"
  ],
]);

$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.tracefinance.com/v1/operations/{operationId}"

	req, _ := http.NewRequest("GET", 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))

}

require 'uri'
require 'net/http'

url = URI("https://api.sandbox.tracefinance.com/v1/operations/{operationId}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "id": "1f3a8c8d-2e1a-4b3a-9d2e-7c1a4b3a9d2e",
  "externalId": null,
  "customer": {
    "id": "11111111-1111-1111-1111-111111111111"
  },
  "account": {
    "id": "a1b2c3d4-5e6f-7890-abcd-ef1234567890",
    "owner": "Acme Importação Ltda"
  },
  "sourceAmount": {
    "value": "500.00",
    "asset": "BRL",
    "decimals": 2
  },
  "targetAmount": {
    "value": "500.00",
    "asset": "BRL",
    "decimals": 2
  },
  "fees": [
    {
      "amount": {
        "value": "2.50",
        "asset": "BRL",
        "decimals": 2
      },
      "source": "PLATFORM"
    }
  ],
  "transactions": [
    {
      "id": "E0036030520260425024100000000001",
      "direction": "DEBIT",
      "amount": {
        "value": "500.00",
        "asset": "BRL",
        "decimals": 2
      },
      "status": "CONFIRMED"
    }
  ],
  "tags": [
    {
      "key": "psp",
      "value": "Amazon"
    },
    {
      "key": "compliance-tier",
      "value": "high"
    }
  ],
  "currentState": {
    "status": "COMPLETED",
    "createdAt": "2026-04-25T02:41:03Z"
  },
  "intent": {
    "type": "WITHDRAWAL",
    "beneficiary": {
      "id": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
      "entity": {
        "type": "INDIVIDUAL",
        "firstName": "John",
        "lastName": "Doe",
        "identificationDocument": {
          "value": "52998224725",
          "type": "CPF"
        },
        "birthDate": "1990-01-15",
        "address": {
          "addressLine1": "Rua Augusta, 500",
          "addressLine2": null,
          "city": "Sao Paulo",
          "state": "SP",
          "country": "BR",
          "postalCode": "01304-001"
        }
      },
      "paymentInstruction": {
        "id": "c3d4e5f6-a7b8-9012-cdef-1234567890ab",
        "rail": "PIX_KEY",
        "keyType": "CPF",
        "key": "12345678901"
      }
    }
  },
  "quote": {
    "id": "d4e5f6a7-b8c9-0123-defa-2345678901bc",
    "effectiveRate": {
      "value": "1.00",
      "base": "BRL",
      "quote": "BRL"
    },
    "expiresAt": "2026-04-25T02:39:47Z"
  },
  "refund": null,
  "createdAt": "2026-04-25T02:39:17Z",
  "updatedAt": "2026-04-25T02:41:03Z"
}

Authorizations

Authorization

string

header

required

JWT bearer token. Include as Authorization: Bearer <token>. See the Authentication guide for how to obtain one.

Headers

X-Trace-Version

string

API version. Omit to use the default version.

Example:

"1"

Path Parameters

operationId

string<uuid>

required

UUID of the operation.

Response

Operation details.

A created operation. Withdrawals, swaps, deposits, and transfers share this shape; intent.type identifies which.

string<uuid>

required

read-only

externalId

string | null

required

Your own identifier for the operation. Stored as given and returned on every read and every webhook. Free-form: it is not deduplicated, and the same value may appear on more than one operation. null when none was sent, and on a deposit credited from an incoming payment nobody requested.

Required string length: 1 - 255

Example:

"order-2026-0043"

customer

object

required

Reference to the customer that owns the operation.

Show child attributes

account

object

required

Reference to a customer account, including the registered owner name.

Show child attributes

sourceAmount

object

required

Monetary amount expressed as a decimal string in the asset's canonical scale. Use a decimal-precision library (BigDecimal, Decimal) for arithmetic — never JavaScript Number. Request bodies use the scalar AmountValue instead.

Show child attributes

targetAmount

object

required

Show child attributes

intent

Withdrawal · object

required

Operation intent. Discriminated by type.

Withdrawal
Swap
Deposit
Transfer

Show child attributes

quote

object | null

required

Consumed quote. null for deposits created without a prior quote; present for all other operations.

Show child attributes

refund

object | null

required

The refund you asked for on this deposit. null on every operation nobody asked back, and on a return the payer's bank issued on its own.

Show child attributes

fees

object[]

required

Show child attributes

transactions

object[]

required

Rail-level transactions for the operation. Only confirmed transactions are included; pending or failed rail movements are omitted.

Show child attributes

requirements

object

required

What compliance is waiting on for this operation, read live at request time. All four groups are empty for an operation that never went through a compliance review. An operation in ACTION_REQUIRED is waiting on whatever is in currentlyDue and errors.

Show child attributes

Example:

{
  "currentlyDue": [
    {
      "type": "BENEFICIARY_DOCUMENT",
      "documentType": "CUSTODY_ATTESTATION",
      "anyOf": ["CUSTODY_ATTESTATION"]
    }
  ],
  "pendingVerification": [],
  "errors": [],
  "satisfied": []
}

currentState

object

required

The operation's current state. Carries a status, optional reason, and the time the state was entered.

Show child attributes

createdAt

string<date-time>

required

read-only

updatedAt

string<date-time>

required

read-only

Accounts

Operations

Reports

Quotes

Beneficiaries

Webhooks

Get an operation

Authorizations

Headers

Path Parameters

Response