Skip to main content
GET
/
v1
/
budgets
/
summary
cURL
curl --request GET \
  --url https://external.vin.gs/api/v1/budgets/summary \
  --header 'Authorization: Bearer <token>'
[
  {
    "total": {
      "amount_cents": 123,
      "currency": "<string>"
    },
    "currency": "<string>",
    "target": {
      "amount_cents": 123,
      "currency": "<string>"
    }
  }
]

Documentation Index

Fetch the complete documentation index at: https://docs.vin.gs/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
Authorization
string
header
required

Vings OAuth access token or personal access token (vng_pat_…). Use Authorization: Bearer ….

Query Parameters

​
month
string
​
year
string

Response

Budget category summary

​
category
required

Expense category name

Available options:
BOOKS,
CINEMA,
CONCERT,
HOBBY,
MUSIC,
NIGHTLIFE,
SPORTS,
SUBSCRIPTIONS,
VACATION,
VIDEO_GAMES
​
total
object
required

Total spending in this category for the specified month/year

​
currency
string
required

Currency code for the amounts

​
target
object

Budget target amount for this category (if set by user)