Get Transaction

GET /api/v1/transactions/:id

Returns a single transaction by ID.

Path Parameters

ParameterTypeDescription
idstringTransaction ID

Query Parameters

ParameterTypeDefaultDescription
fieldsstringallComma-separated field names

Example Request

curl -X GET "https://statements.finopsbricks.com/api/v1/transactions/abc123xyz789" \
  -H "api-key: fob_stm_xxxxxxxxxxxx" \
  -H "api-secret: xxxxxxxxxxxxxxxx"

Example: Select Specific Fields

curl -X GET "https://statements.finopsbricks.com/api/v1/transactions/abc123xyz789?fields=id,date,inflow,outflow,entity" \
  -H "api-key: fob_stm_xxxxxxxxxxxx" \
  -H "api-secret: xxxxxxxxxxxxxxxx"

Response

{
  "data": {
    "id": "abc123xyz789",
    "date": "2025-01-05",
    "particulars": "Payment received",
    "inflow": 1000500,
    "outflow": 0,
    "balance": 5000000,
    "entity": "Customer Inc",
    "category": "income",
    "type": "income",
    "po": null,
    "comments": null,
    "account_id": "acc123",
    "account_name": "Main Account",
    "statement": "stmt123"
  }
}

Note: Monetary values are integers in milli-units. Divide by 1000 for display.

Response Fields

See Transaction Object for field descriptions.

Errors

CodeDescription
401Invalid or missing API credentials
403API key lacks transactions:read permission
404Transaction not found