List forecasts

GET

forecasts

List forecasts

curl --request GET \
  --url https://api.thinkout.io/v1/forecasts \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.thinkout.io/v1/forecasts', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

using RestSharp;


var options = new RestClientOptions("https://api.thinkout.io/v1/forecasts");
var client = new RestClient(options);
var request = new RestRequest("");
request.AddHeader("Authorization", "Bearer <token>");
var response = await client.GetAsync(request);

Console.WriteLine("{0}", response.Content);

{
  "object": "list",
  "data": [
    {
      "object": "forecast",
      "id": "7e6d5c4b-3a29-4180-9f8e-7d6c5b4a3928",
      "date": "2026-09-15",
      "amount": "-4200.00",
      "remaining_amount": "-4200.00",
      "currency": "EUR",
      "direction": "outflow",
      "status": "planned",
      "description": "Office rent",
      "comment": null,
      "category": "2a3b4c5d-6e7f-4809-8a1b-2c3d4e5f6a7b",
      "counterparty": "8b9c0d1e-2f3a-4b5c-8d6e-7f8a9b0c1d2e",
      "labels": [
        "0f1e2d3c-4b5a-4968-8776-655443322110"
      ],
      "recurrence": "4c5d6e7f-8091-4a2b-9c3d-4e5f6a7b8c9d",
      "linked_transactions": [],
      "created_at": "2025-12-20T09:30:00Z",
      "updated_at": "2025-12-20T09:30:00Z"
    }
  ],
  "has_more": true,
  "next_cursor": "<string>"
}

{
  "error": {
    "type": "invalid_request",
    "code": "invalid_parameter",
    "message": "direction must be 'inflow' or 'outflow'",
    "param": "direction",
    "request_id": "0HNF8K3QJL2VM:00000001"
  }
}

{
  "error": {
    "type": "authentication",
    "code": "unauthorized",
    "message": "Missing, malformed, unknown or revoked API key",
    "param": null,
    "request_id": "0HNF8K3QJL2VM:00000001"
  }
}

{
  "error": {
    "type": "authentication",
    "code": "forbidden",
    "message": "The API is not included in this company's ThinkOut plan. Contact support@thinkout.io to enable it.",
    "param": null,
    "request_id": "0HNF8K3QJL2VM:00000001"
  }
}

{
  "error": {
    "type": "rate_limit",
    "code": "rate_limited",
    "message": "Too many requests",
    "param": null,
    "request_id": "0HNF8K3QJL2VM:00000001"
  }
}

Authorizations

Authorization

string

header

required

A workspace API key created in ThinkOut settings. One key reads one workspace.

Query Parameters

from

string<date>

Earliest date to include, inclusive.

string<date>

Latest date to include, inclusive.

category_id

string<uuid>[]

Only rows in these categories. Comma-separated for several. On /transactions this also matches a split transaction whose pieces are in one of them. Subcategories are included only on the summaries.

label_id

string<uuid>[]

Only rows carrying at least one of these labels. Comma-separated for several.

counterparty_id

string<uuid>[]

Only rows attributed to these counterparties. Comma-separated for several.

direction

enum<string>

Whether money comes in or goes out. On a transaction or forecast it follows the sign of amount.

Available options:

inflow,

outflow

status

enum<string>

realised is complete. partial has matched transactions. overdue is dated before today with none. planned is dated today or later with none.

Available options:

planned,

overdue,

partial,

realised

expand

enum<string>[]

Relations to return as objects instead of ids. Comma-separated. Expansion goes one level deep; an unknown name is rejected with invalid_expand.

Available options:

category,

counterparty,

labels,

recurrence,

linked_transactions

limit

integer

default:100

Page size. Outside the range it is rejected with limit_out_of_range.

Required range: 1 <= x <= 500

cursor

string

Opaque token from the previous page's next_cursor. Keep the other parameters unchanged between pages.

Response

A page of forecasts.

object

string

required

Allowed value: "list"

data

object[]

required

Show child attributes

has_more

boolean

required

Whether another page exists.

next_cursor

string | null

required

Pass as cursor to fetch the next page. null on the last page.

List forecasts

curl --request GET \
  --url https://api.thinkout.io/v1/forecasts \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.thinkout.io/v1/forecasts', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

using RestSharp;


var options = new RestClientOptions("https://api.thinkout.io/v1/forecasts");
var client = new RestClient(options);
var request = new RestRequest("");
request.AddHeader("Authorization", "Bearer <token>");
var response = await client.GetAsync(request);

Console.WriteLine("{0}", response.Content);

{
  "object": "list",
  "data": [
    {
      "object": "forecast",
      "id": "7e6d5c4b-3a29-4180-9f8e-7d6c5b4a3928",
      "date": "2026-09-15",
      "amount": "-4200.00",
      "remaining_amount": "-4200.00",
      "currency": "EUR",
      "direction": "outflow",
      "status": "planned",
      "description": "Office rent",
      "comment": null,
      "category": "2a3b4c5d-6e7f-4809-8a1b-2c3d4e5f6a7b",
      "counterparty": "8b9c0d1e-2f3a-4b5c-8d6e-7f8a9b0c1d2e",
      "labels": [
        "0f1e2d3c-4b5a-4968-8776-655443322110"
      ],
      "recurrence": "4c5d6e7f-8091-4a2b-9c3d-4e5f6a7b8c9d",
      "linked_transactions": [],
      "created_at": "2025-12-20T09:30:00Z",
      "updated_at": "2025-12-20T09:30:00Z"
    }
  ],
  "has_more": true,
  "next_cursor": "<string>"
}

{
  "error": {
    "type": "invalid_request",
    "code": "invalid_parameter",
    "message": "direction must be 'inflow' or 'outflow'",
    "param": "direction",
    "request_id": "0HNF8K3QJL2VM:00000001"
  }
}

{
  "error": {
    "type": "authentication",
    "code": "unauthorized",
    "message": "Missing, malformed, unknown or revoked API key",
    "param": null,
    "request_id": "0HNF8K3QJL2VM:00000001"
  }
}

{
  "error": {
    "type": "authentication",
    "code": "forbidden",
    "message": "The API is not included in this company's ThinkOut plan. Contact support@thinkout.io to enable it.",
    "param": null,
    "request_id": "0HNF8K3QJL2VM:00000001"
  }
}

{
  "error": {
    "type": "rate_limit",
    "code": "rate_limited",
    "message": "Too many requests",
    "param": null,
    "request_id": "0HNF8K3QJL2VM:00000001"
  }
}

Getting started

MCP

REST API

API reference

Authorizations

Query Parameters

Response