Inflow and outflow totals for the same filters

Its own route: an aggregate is never folded into a page.

GET /transactions/summary

Inflow and outflow totals for the same filters

cURL

curl --request GET \
  --url https://api.hevn.finance/dapi/v1/transactions/summary \
  --header 'Authorization: Bearer <token>'

200

{
  "inflowUsd": "500.00",
  "inflowCount": 123,
  "outflowUsd": "500.00",
  "outflowCount": 123,
  "pendingInflowUsd": "500.00",
  "pendingInflowCount": 123,
  "pendingOutflowUsd": "500.00",
  "pendingOutflowCount": 123
}

Authorizations

Authorization · string · header · required

Platform access token from POST /auth/token, carrying the platform audience and the developer_key_id of the registration that minted it. It acts as your own account; name a client you created with X-Hevn-Account: cl_…. Every request re-checks that the registration is still active and that the caller's source IP is inside its allowlist. A token is valid only against the server that issued it, so sandbox tokens are refused in production and production tokens in the sandbox.

Headers

X-Hevn-Account · string | null

The client account to act for, as a cl_… id. Omit it to act as yourself.

Example:

"cl_9f2c1ab84d7e4f1fa3c65b0e7d9a2c41"

x-api-key · string | null

Query Parameters

type · string | null

Comma-separated transaction types

status · string | null

Comma-separated statuses

tag · string | null

Comma-separated tags

contactId · string | null

bankId · string | null

incomeOnly · boolean | null

q · string | null

Minimum string length: 2

from · string<date-time> | null

to · string<date-time> | null

Response

200

application/json

Successful Response

inflowUsd · string · required

Settled incoming value converted to USD for the selected period.

Example:

"500.00"

inflowCount · integer · required

Number of settled incoming transactions in the selected period.

outflowUsd · string · required

Settled outgoing value converted to USD for the selected period.

Example:

"500.00"

outflowCount · integer · required

Number of settled outgoing transactions in the selected period.

pendingInflowUsd · string · required

Pending incoming value converted to USD.

Example:

"500.00"

pendingInflowCount · integer · required

Number of pending incoming transactions.

pendingOutflowUsd · string · required

Pending outgoing value converted to USD.

Example:

"500.00"

pendingOutflowCount · integer · required

Number of pending outgoing transactions.