SDigital2SDigital2
CustomersIdTransactions

Get customer transactions

Retrieve a paginated list of transactions for a specific customer

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

In: header

Path Parameters

idstring

UUID identifier

Formatuuid

Query Parameters

page?number

Page number for pagination

Default1
Range1 <= value
limit?number

Max number of items per page to fetch (max 100)

Default10
Range1 <= value <= 100

Response Body

curl -X GET "https://api.sandbox.sdigital2.com/v1/customers/3190d115-987f-402f-b558-0316d3a22ebd/transactions?page=1&limit=10"
{
  "data": [
    {
      "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"
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 10
  }
}
{
  "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"
}