SDigital2SDigital2
TransactionsId

Get transaction by ID

Retrieve a specific transaction by its UUID

GET
/v1/transactions/{id}
AuthorizationBearer <token>

In: header

Path Parameters

idstring

UUID identifier

Formatuuid

Response Body

curl -X GET "https://api.sandbox.sdigital2.com/v1/transactions/3190d115-987f-402f-b558-0316d3a22ebd"
{
  "id": "1d59b344-ea39-4e1e-9360-c90486cd9b8e",
  "type": "ON_RAMP",
  "customerId": "1d59b344-ea39-4e1e-9360-c90486cd9b8e",
  "sourceAmount": "100.50",
  "source": {
    "currency": "BRL",
    "paymentRail": "ETHEREUM"
  },
  "destination": {
    "currency": "BRL",
    "paymentRail": "PIX",
    "bankAccountId": "2eeff026-fddb-4649-8f5b-90b27fc2e75e"
  },
  "purpose": "INVESTMENT",
  "createdAt": "2024-01-01T00:00:00.000Z",
  "updatedAt": "2024-01-01T00:00:00.000Z",
  "status": "PENDING",
  "depositInstructions": {
    "paymentRail": "PIX",
    "brCode": "00020126580014br.gov.bcb.pix..."
  },
  "receipt": {
    "sourceCurrency": "USDT",
    "sourceAmount": "100.50",
    "destinationCurrency": "BRL",
    "destinationAmount": "100.50",
    "grossDestinationAmount": "100.50",
    "baseExchangeRate": "1.00",
    "appliedExchangeRate": "1.00",
    "fees": {
      "bps": "10",
      "flatAmount": "1",
      "totalAmount": "11",
      "currency": "USDC"
    }
  }
}
{
  "status": 401,
  "title": "Unauthorized",
  "detail": "Authentication credentials are missing or invalid",
  "code": "UNAUTHORIZED",
  "instance": "/api/v1/transactions",
  "correlationId": "2065cb12-a9fe-42f9-8c75-d63257b3844a"
}
{
  "status": 403,
  "title": "Forbidden",
  "detail": "You do not have permission to access this resource",
  "code": "FORBIDDEN",
  "instance": "/api/v1/transactions",
  "correlationId": "2065cb12-a9fe-42f9-8c75-d63257b3844a"
}
{
  "status": 404,
  "title": "Not Found",
  "detail": "The requested resource could not be found",
  "code": "RESOURCE_NOT_FOUND",
  "instance": "/api/v1/transactions/f133bef1-226c-458a-b6d9-8312edb8d77a",
  "correlationId": "2065cb12-a9fe-42f9-8c75-d63257b3844a"
}
{
  "status": 422,
  "title": "Validation Error",
  "detail": "The request contains invalid data",
  "code": "VALIDATION_ERROR",
  "instance": "/api/v1/transactions",
  "correlationId": "2065cb12-a9fe-42f9-8c75-d63257b3844a",
  "errors": [
    {
      "detail": "sourceAmount must be a positive number",
      "pointer": "/sourceAmount"
    },
    {
      "detail": "destination.currency is required when providing sourceAmount",
      "pointer": "/destination/currency"
    }
  ]
}
{
  "status": 500,
  "title": "Internal Server Error",
  "detail": "An unexpected error occurred while processing your request",
  "code": "INTERNAL_SERVER_ERROR",
  "instance": "/api/v1/transactions",
  "correlationId": "2065cb12-a9fe-42f9-8c75-d63257b3844a"
}