curl --request GET \
  --url https://astreus.ai/api/v1/countries/{iso}/fed-financials \
  --header 'X-API-KEY: <api-key>'

import requests

url = "https://astreus.ai/api/v1/countries/{iso}/fed-financials"

headers = {"X-API-KEY": "<api-key>"}

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

print(response.text)

const options = {method: 'GET', headers: {'X-API-KEY': '<api-key>'}};

fetch('https://astreus.ai/api/v1/countries/{iso}/fed-financials', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://astreus.ai/api/v1/countries/{iso}/fed-financials",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "X-API-KEY: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

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

func main() {

	url := "https://astreus.ai/api/v1/countries/{iso}/fed-financials"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("X-API-KEY", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.get("https://astreus.ai/api/v1/countries/{iso}/fed-financials")
  .header("X-API-KEY", "<api-key>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://astreus.ai/api/v1/countries/{iso}/fed-financials")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["X-API-KEY"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "entity": "combined",
  "entityLabel": "Federal Reserve Banks (combined)",
  "entities": [
    {
      "key": "combined",
      "label": "Federal Reserve Banks (combined)",
      "firstPeriod": "1915-12-31",
      "lastPeriod": "2026-06-30",
      "hasQuarterly": true
    },
    {
      "key": "boston",
      "label": "Federal Reserve Bank of Boston",
      "firstPeriod": "1995-12-31",
      "lastPeriod": "2025-12-31",
      "hasQuarterly": false
    }
  ],
  "periodType": "annual",
  "unit": "USD millions",
  "statements": {
    "income_statement": {
      "columns": [
        {
          "key": "FY2024",
          "endDate": "2024-12-31",
          "durationMonths": 12,
          "derived": false,
          "sources": [
            {
              "url": "https://www.federalreserve.gov/aboutthefed/files/combinedfinstmt2025.pdf",
              "kind": "annual_audited"
            }
          ]
        },
        {
          "key": "FY2025",
          "endDate": "2025-12-31",
          "durationMonths": 12,
          "derived": false,
          "sources": [
            {
              "url": "https://www.federalreserve.gov/aboutthefed/files/combinedfinstmt2025.pdf",
              "kind": "annual_audited"
            }
          ]
        }
      ],
      "rows": [
        {
          "key": "hdr:0:0",
          "label": "Interest income",
          "fullLabel": "Interest income",
          "depth": 0,
          "header": true,
          "total": false,
          "values": {}
        },
        {
          "key": "loans_to_depository_institutions",
          "label": "Loans to depository institutions",
          "fullLabel": "Loans to depository institutions",
          "depth": 2,
          "header": false,
          "total": false,
          "values": {
            "FY2024": 204,
            "FY2025": 203
          }
        }
      ]
    },
    "balance_sheet": {
      "columns": [
        {
          "key": "FY2024",
          "endDate": "2024-12-31",
          "durationMonths": 0,
          "derived": false,
          "sources": [
            {
              "url": "https://www.federalreserve.gov/aboutthefed/files/combinedfinstmt2025.pdf",
              "kind": "annual_audited"
            },
            {
              "url": "https://www.federalreserve.gov/aboutthefed/files/combinedfinstmt2024.pdf",
              "kind": "annual_audited"
            }
          ]
        },
        {
          "key": "FY2025",
          "endDate": "2025-12-31",
          "durationMonths": 0,
          "derived": false,
          "sources": [
            {
              "url": "https://www.federalreserve.gov/aboutthefed/files/combinedfinstmt2025.pdf",
              "kind": "annual_audited"
            }
          ]
        }
      ],
      "rows": [
        {
          "key": "gold_certificates",
          "label": "Gold certificates",
          "fullLabel": "Gold certificates",
          "depth": 0,
          "header": false,
          "total": false,
          "values": {
            "FY2024": 11037,
            "FY2025": 11037
          }
        },
        {
          "key": "special_drawing_rights_certificates",
          "label": "Special drawing rights certificates",
          "fullLabel": "Special drawing rights certificates",
          "depth": 0,
          "header": false,
          "total": false,
          "values": {
            "FY2024": 15200,
            "FY2025": 15200
          }
        }
      ]
    },
    "income_summary": {
      "columns": [
        {
          "key": "FY2023",
          "endDate": "2023-12-31",
          "durationMonths": 12,
          "derived": false,
          "sources": [
            {
              "url": "https://www.federalreserve.gov/publications/2024-ar-statistical-tables.htm",
              "kind": "annual_report_stats"
            }
          ]
        },
        {
          "key": "FY2024",
          "endDate": "2024-12-31",
          "durationMonths": 12,
          "derived": false,
          "sources": [
            {
              "url": "https://www.federalreserve.gov/publications/2024-ar-statistical-tables.htm",
              "kind": "annual_report_stats"
            }
          ]
        }
      ],
      "rows": [
        {
          "key": "current_income",
          "label": "Current income",
          "fullLabel": "Current income",
          "depth": 0,
          "header": false,
          "total": false,
          "values": {
            "FY2023": 175136.109,
            "FY2024": 159323.708
          }
        },
        {
          "key": "assessments_by_the_board_of_governors_board_expenditures",
          "label": "Assessments by the Board of Governors: Board expenditures",
          "fullLabel": "Assessments by the Board of Governors: Board expenditures",
          "depth": 0,
          "header": false,
          "total": false,
          "values": {
            "FY2023": 1144,
            "FY2024": 1438
          }
        }
      ]
    }
  },
  "noteRefs": {
    "balance_sheet": {
      "accrued_benefit_costs": "Notes 9, 10",
      "bank_premises_and_equipment_net": "Note 7",
      "capital_paid_in": "Note 7",
      "consolidated_variable_interest_entities_assets_held_net": "Note 3",
      "consolidated_variable_interest_entities_formed_to_administer_credit_and_liquidity_facilities_non_controlling_interest": "Note 3",
      "consolidated_variable_interest_entities_other_liabilities": "Note 3",
      "deferred_asset_remittances_to_the_treasury": "Note 12",
      "deposits.depository_institutions": "Note 5",
      "deposit_treasury_funding_of_lending_facility_credit_protection": "Note 4",
      "federal_reserve_notes_outstanding_net": "Note 4",
      "foreign_currency_denominated_investments_net": "Note 2",
      "loans": "Note 4",
      "loans.other_loans": "Note 1",
      "loans_to_depository_institutions": "Note 1",
      "prepaid_pension_benefit_costs": "Note 9",
      "surplus": "Note 7",
      "system_open_market_account.accrued_interest_receivable": "Note 2",
      "system_open_market_account.central_bank_liquidity_swaps": "Note 2",
      "system_open_market_account.federal_agency_and_government_sponsored_enterprise_mortgage_backed_securities_net": "Note 2",
      "system_open_market_account.government_sponsored_enterprise_debt_securities_net": "Note 2",
      "system_open_market_account.other_assets": "Note 5",
      "system_open_market_account.other_liabilities": "Note 2",
      "system_open_market_account.securities_purchased_under_agreements_to_resell": "Note 2",
      "system_open_market_account.securities_sold_under_agreements_to_repurchase": "Note 2",
      "system_open_market_account.treasury_securities_net": "Note 2",
      "treasury_general_account": "Note 6"
    },
    "income_statement": {
      "board_of_governors_operating_expenses_and_currency_costs": "Note 8(E)",
      "bureau_of_consumer_financial_protection": "Note 8(E)",
      "central_bank_liquidity_swaps": "Note 8(B)",
      "change_in_actuarial_gains_related_to_benefit_plans": "Notes 9, 10, 11",
      "change_in_prior_service_costs_related_to_benefit_plans": "Notes 9, 10, 11",
      "consolidated_variable_interest_entities_gains_net": "Note 3",
      "consolidated_variable_interest_entities_income_net": "Note 8(C)",
      "consolidated_variable_interest_entities_non_controlling_interest_income_net": "Note 8(C)",
      "depository_institutions_and_others": "Note 8(D)",
      "earnings_remittances_to_the_treasury_net": "Note 12",
      "equipment": "Note 8(E)",
      "federal_agency_and_government_sponsored_enterprise_mortgage_backed_securities_gains_net": "Note 8(B)",
      "federal_agency_and_government_sponsored_enterprise_mortgage_backed_securities_net": "Note 8(B)",
      "foreign_currency_denominated_investments_net": "Note 8(B)",
      "foreign_currency_translation_gains_net": "Note 8(B)",
      "government_sponsored_enterprise_debt_securities_net": "Note 8(B)",
      "income_from_investments_held_by_consolidated_variable_interest_entities_net": "Note 3",
      "income_from_services": "Note 5",
      "interest_expense.system_open_market_account.other": "Note 5",
      "interest_on_federal_reserve_notes": "Note 13",
      "investments_held_by_consolidated_variable_interest_entities": "Note 3",
      "investments_held_by_consolidated_variable_interest_entities_gains_net": "Note 3",
      "loans": "Note 4",
      "loans_to_depository_institutions": "Note 8(A)",
      "net_periodic_pension_expense": "Note 9",
      "occupancy": "Note 8(E)",
      "operating_expenses.other": "Note 8(E)",
      "other_components_of_net_benefit_costs": "Notes 9, 10",
      "other_income.system_open_market_account.other": "Note 8(B)",
      "other_income.system_open_market_account.other#2": "Note 5",
      "other_loans": "Note 8(A)",
      "payments_to_u_s_treasury_as_required_by_statute": "Note 3",
      "reimbursable_services_to_government_agencies": "Note 5",
      "required_by_the_federal_reserve_act_as_amended_by_the_fast_act": "Note 3o",
      "salaries_and_benefits": "Note 8(E)",
      "securities_purchased_under_agreements_to_resell": "Note 8(B)",
      "securities_sold_under_agreements_to_repurchase": "Note 8(B)",
      "system_pension_service_cost": "Note 8(E)",
      "treasury_securities_gains_net": "Note 8(B)",
      "treasury_securities_net": "Note 8(B)"
    }
  },
  "quality": {
    "documentsListed": 157,
    "documentsStored": 157,
    "documentsServed": 76,
    "errata": [
      {
        "statement": "balance_sheet",
        "period": "2016-06-30",
        "subject": "Total liabilities @ 2016-06-30",
        "detail": "June 30, 2016 total liabilities printed as 4,482,386 (digits transposed, same in the HTML edition). The twelve liability lines sum to 4,428,386, and total liabilities and capital 4,468,497 − total cap…",
        "printed": 4482386,
        "corrected": 4428386,
        "sourceUrl": "https://www.federalreserve.gov/aboutthefed/files/quarterly-report-20160630.pdf"
      }
    ],
    "withheld": [
      {
        "statement": "income_statement",
        "period": "2024-12-31",
        "subject": "Total distribution of comprehensive income @ 2024-12-31 12m",
        "detail": "no run of the items above foots it",
        "printed": null,
        "corrected": null,
        "sourceUrl": "https://www.federalreserve.gov/publications/2024-ar-statistical-tables.htm"
      },
      {
        "statement": "income_statement",
        "period": "2023-12-31",
        "subject": "Total distribution of comprehensive income @ 2023-12-31 12m",
        "detail": "no run of the items above foots it",
        "printed": null,
        "corrected": null,
        "sourceUrl": "https://www.federalreserve.gov/publications/2023-ar-statistical-tables.htm"
      }
    ]
  }
}

{
  "error": "<string>",
  "code": "unknown_parameter",
  "param": "<string>",
  "allowed": [
    "<string>"
  ]
}

{
  "error": "<string>",
  "code": "unknown_parameter",
  "param": "<string>",
  "allowed": [
    "<string>"
  ]
}

{
  "error": "<string>",
  "code": "unknown_parameter",
  "param": "<string>",
  "allowed": [
    "<string>"
  ]
}

{
  "error": "<string>",
  "code": "unknown_parameter",
  "param": "<string>",
  "allowed": [
    "<string>"
  ]
}