Get a forecast

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

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

fetch('https://api.thinkout.io/v1/forecasts/{id}', 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/{id}");
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);

import requests

url = "https://api.thinkout.io/v1/forecasts/{id}"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

{
  "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"
}

{
  "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": "not_found",
    "code": "resource_not_found",
    "message": "Transaction not found",
    "param": null,
    "request_id": "0HNF8K3QJL2VM:00000001"
  }
}

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