YNAB API Endpoints

youneedabudget · Finance

Finance No Auth Free & Open financial

Our API uses a REST based design, leverages the JSON data format, and relies upon HTTPS for transport. We respond with meaningful HTTP response codes and if an error occurs, we include error details in the response body. API Documentation is at https://api.youneedabudget.com

Authentication

No authentication requiredFree to use with no key needed.

Sample Requests

GET List budgets

Returns budgets list with summary information

https://api.apis.guru/v2/specs/youneedabudget.com/1.0.0/budgets?include_accounts=true

Hover any highlighted part to learn what it does

curl -X GET "https://api.apis.guru/v2/specs/youneedabudget.com/1.0.0/budgets?include_accounts=true"

import requests
params = {
    "include_accounts": "true"
}
response = requests.get(
    "https://api.apis.guru/v2/specs/youneedabudget.com/1.0.0/budgets",
    params=params,
)
print(response.json())

const url = new URL('https://api.apis.guru/v2/specs/youneedabudget.com/1.0.0/budgets');
url.searchParams.set('include_accounts', 'true');

const response = await fetch(url); 
const data = await response.json();
console.log(data);

package main

import (
	"fmt"
	"io"
	"net/http"
	"net/url"
)

func main() {
	baseURL, _ := url.Parse("https://api.apis.guru/v2/specs/youneedabudget.com/1.0.0/budgets")
	q := baseURL.Query()
	q.Set("include_accounts", "true")
	baseURL.RawQuery = q.Encode()
	targetURL := baseURL.String()
	req, _ := http.NewRequest("GET", targetURL, nil)

	client := &http.Client{}
	resp, _ := client.Do(req)
	defer resp.Body.Close()
	body, _ := io.ReadAll(resp.Body)
	fmt.Println(string(body))
}

require "net/http"
require "json"

uri = URI("https://api.apis.guru/v2/specs/youneedabudget.com/1.0.0/budgets")
uri.query = URI.encode_www_form({
  "include_accounts" => "true"
})

http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = uri.scheme == "https"

req = Net::HTTP::Get.new(uri)

res = http.request(req)
puts JSON.parse(res.body)

<?php
$url = "https://api.apis.guru/v2/specs/youneedabudget.com/1.0.0/budgets?" . http_build_query([
    "include_accounts" => "true"
]);
$opts = ["http" => [
    "method" => "GET",
]];
$ctx = stream_context_create($opts);
$res = file_get_contents($url, false, $ctx);
print_r(json_decode($res, true));

GET User info

Returns authenticated user information

https://api.apis.guru/v2/specs/youneedabudget.com/1.0.0/user

Hover any highlighted part to learn what it does

curl -X GET "https://api.apis.guru/v2/specs/youneedabudget.com/1.0.0/user"

import requests
response = requests.get(
    "https://api.apis.guru/v2/specs/youneedabudget.com/1.0.0/user",
)
print(response.json())

const url = 'https://api.apis.guru/v2/specs/youneedabudget.com/1.0.0/user';

const response = await fetch(url); 
const data = await response.json();
console.log(data);

package main

import (
	"fmt"
	"io"
	"net/http"
)

func main() {
	targetURL := "https://api.apis.guru/v2/specs/youneedabudget.com/1.0.0/user"
	req, _ := http.NewRequest("GET", targetURL, nil)

	client := &http.Client{}
	resp, _ := client.Do(req)
	defer resp.Body.Close()
	body, _ := io.ReadAll(resp.Body)
	fmt.Println(string(body))
}

require "net/http"
require "json"

uri = URI("https://api.apis.guru/v2/specs/youneedabudget.com/1.0.0/user")

http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = uri.scheme == "https"

req = Net::HTTP::Get.new(uri)

res = http.request(req)
puts JSON.parse(res.body)

<?php
$url = "https://api.apis.guru/v2/specs/youneedabudget.com/1.0.0/user";
$opts = ["http" => [
    "method" => "GET",
]];
$ctx = stream_context_create($opts);
$res = file_get_contents($url, false, $ctx);
print_r(json_decode($res, true));

GET Single budget

Returns a single budget with all related entities. This resource is effectively a full budget export.

https://api.apis.guru/v2/specs/youneedabudget.com/1.0.0/budgets/{budget_id}?last_knowledge_of_server=1

Hover any highlighted part to learn what it does

curl -X GET "https://api.apis.guru/v2/specs/youneedabudget.com/1.0.0/budgets/{budget_id}?last_knowledge_of_server=1"

import requests
params = {
    "last_knowledge_of_server": "1"
}
response = requests.get(
    "https://api.apis.guru/v2/specs/youneedabudget.com/1.0.0/budgets/{budget_id}",
    params=params,
)
print(response.json())

const url = new URL('https://api.apis.guru/v2/specs/youneedabudget.com/1.0.0/budgets/{budget_id}');
url.searchParams.set('last_knowledge_of_server', '1');

const response = await fetch(url); 
const data = await response.json();
console.log(data);

package main

import (
	"fmt"
	"io"
	"net/http"
	"net/url"
)

func main() {
	baseURL, _ := url.Parse("https://api.apis.guru/v2/specs/youneedabudget.com/1.0.0/budgets/{budget_id}")
	q := baseURL.Query()
	q.Set("last_knowledge_of_server", "1")
	baseURL.RawQuery = q.Encode()
	targetURL := baseURL.String()
	req, _ := http.NewRequest("GET", targetURL, nil)

	client := &http.Client{}
	resp, _ := client.Do(req)
	defer resp.Body.Close()
	body, _ := io.ReadAll(resp.Body)
	fmt.Println(string(body))
}

require "net/http"
require "json"

uri = URI("https://api.apis.guru/v2/specs/youneedabudget.com/1.0.0/budgets/{budget_id}")
uri.query = URI.encode_www_form({
  "last_knowledge_of_server" => "1"
})

http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = uri.scheme == "https"

req = Net::HTTP::Get.new(uri)

res = http.request(req)
puts JSON.parse(res.body)

<?php
$url = "https://api.apis.guru/v2/specs/youneedabudget.com/1.0.0/budgets/{budget_id}?" . http_build_query([
    "last_knowledge_of_server" => "1"
]);
$opts = ["http" => [
    "method" => "GET",
]];
$ctx = stream_context_create($opts);
$res = file_get_contents($url, false, $ctx);
print_r(json_decode($res, true));

Postman Setup Guide

Get Postman ↗

See official documentation for authentication and setup.

What can you build with YNAB API Endpoints?

YNAB API Endpoints is a Finance API. Developers commonly use finance APIs for:

processing payments and handling transactions
building subscription and billing systems
automating invoicing and financial reporting
fraud detection and risk scoring
connecting to banking and accounting software

No authentication required. This API is open — no signup or key needed. Ideal for quick prototypes and public-facing features. YNAB API Endpoints is free to use, making it a low-risk choice to experiment with.

New to APIs? Read our beginner's guide · Learn about API keys · What is REST?

Open documentation ↗