{"openapi":"3.1.0","info":{"title":"Business & Consumer Confidence API","version":"1.0.0","description":"How optimistic the firms and households of each economy are right now — the OECD Business and Consumer Confidence Indicators as an API, live from the OECD's official statistics, no key. Confidence is soft data: it comes from monthly surveys asking businesses about orders, output and expectations, and consumers about their finances and the outlook, and it moves before the hard data does, which makes it one of the most-watched early reads on demand. The OECD standardises both into amplitude-adjusted indices that oscillate around 100 — above 100 means confidence is above its long-term average (optimism), below 100 means below average (pessimism) — and the direction (rising or falling) tells you whether sentiment is improving or deteriorating. The business endpoint returns the Business Confidence Indicator (BCI) for every economy the OECD tracks (and the aggregates — G7, G20, OECD, the euro area), ranked, each with its current value, month-on-month change, optimism/pessimism reading and direction. The consumer endpoint returns the Consumer Confidence Indicator (CCI) the same way. The country endpoint puts both side by side for one economy — the firm view and the household view together, with a combined read. Discontinued series are excluded and each reading carries its own period, so the board is genuinely current. The survey-based confidence / soft-data cut — distinct from the OECD composite-leading-indicator board (a different measure built to lead GDP), from the bond-yield and inflation boards, and from the generic multi-provider data aggregator. Figures are monthly; this is the sentiment lens on the world's economies.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/confidence-api","description":"oanor gateway"}],"tags":[{"name":"Business"},{"name":"Consumer"},{"name":"Country"},{"name":"Meta"}],"components":{"securitySchemes":{"oanorKey":{"type":"apiKey","in":"header","name":"x-oanor-key","description":"Get your key at https://www.oanor.com/developer/keys"}}},"security":[{"oanorKey":[]}],"paths":{"/v1/business":{"get":{"operationId":"get_v1_business","tags":["Business"],"summary":"Business Confidence Indicator for every economy, ranked","description":"","parameters":[{"name":"countries_only","in":"query","required":false,"description":"Drop aggregate groups (true)","schema":{"type":"string"},"example":"true"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"The OECD amplitude-adjusted Business Confidence Indicator (BCI) for every tracked economy (and aggregates unless countries_only=true), ranked. The index oscillates around 100: above 100 = confidence above its long-term average (optimism), below 100 = pessimism; direction gives whether sentiment is improving or deteriorating. Survey-based soft data, leads the hard data. Each row carries its own period (economies report with a varying lag); discontinued series are excluded. Monthly, cached a few hours.","board":[{"code":"HRV","mood":"optimism","name":"Croatia","value":101.877,"change":0.497,"period":"2026-04","reading":"optimistic and improving","previous":101.38,"direction":"rising","is_aggregate":false},{"code":"ISR","mood":"optimism","name":"Israel","value":101.724,"change":-0.381,"period":"2026-03","reading":"optimistic but softening","previous":102.105,"direction":"falling","is_aggregate":false},{"code":"GRC","mood":"optimism","name":"Greece","value":101.632,"change":-0.144,"period":"2026-04","reading":"optimistic but softening","previous":101.776,"direction":"falling","is_aggregate":false},{"code":"LTU","mood":"optimism","name":"Lithuania","value":101.59,"change":0.005,"period":"2026-04","reading":"optimistic and improving","previous":101.585,"direction":"rising","is_aggregate":false},{"code":"IRL","mood":"optimism","name":"Ireland","value":101.491,"change":-0.05,"period":"2026-04","reading":"optimistic but softening","previous":101.54,"direction":"falling","is_aggregate":false},{"code":"LVA","mood":"optimism","name":"Latvia","value":101.36,"change":0.023,"period":"2026-04","reading":"optimistic and improving","previous":101.336,"direction":"rising","is_aggregate":false},{"code":"JPN","mood":"optimism","name":"Japan","value":101.248,"change":0.023,"period":"2026-03","reading":"optimistic and improving","previous":101.224,"direction":"rising","is_aggregate":false},{"code":"ESP","mood":"optimism","name":"Spain","value":100.688,"change":-0.193,"period":"2026-04","reading":"optimistic but softening","previous":100.882,"direction":"falling","is_aggregate":false},{"code":"BGR","mood":"optimism","name":"Bulgaria","value":100.677,"change":-0.093,"period":"2026-04","reading":"optimistic but softening","previous":100.769,"direction":"falling","is_aggregate":false},{"code":"NZL","mood":"optimism","name":"New Zealand","value":100.676,"change":-0.981,"period":"2026-03","reading":"optimistic but softening","previous":101.657,"direction":"falling","is_aggregate":false},{"code":"NLD","mood":"optimism","name":"Netherlands","value":100.613,"change":-0.012,"period":"2026-04","reading":"optimistic but softening","previous":100.625,"direction":"falling","is_aggregate":false},{"code":"AUS","mood":"optimism","name":"Australia","value":100.455,"change":0.003,"period":"2026-02","reading":"optimistic and improving","previous":100.452,"direction":"rising","is_aggregate":false},{"code":"CRI","mood":"optimism","name":"Costa Rica","value":100.417,"change":-0.289,"period":"2026-05","reading":"optimistic but softening","previous":100.706,"direction":"falling","is_aggregate":false},{"code":"ZAF","mood":"optimism","name":"South Africa","value":100.41,"change":0.099,"period":"2026-03","reading":"optimistic and improving","previous":100.311,"direction":"rising","is_aggregate":false},{"code":"SVK","mood":"optimism","name":"Slovak Republic","value":100.304,"change":0.524,"period":"2026-04","reading":"optimistic and improving","previous":99.78,"direction":"rising","is_aggregate":false},{"code":"FIN","mood":"optimism","name":"Finland","value":100.273,"change":0.052,"period":"2026-04","reading":"optimistic and improving","previous":100.22,"direction":"rising","is_aggregate":false},{"code":"SWE","mood":"optimism","name":"Sweden","value":100.047,"change":0.019,"period":"2026-04","reading":"optimistic and improving","previous":100.028,"direction":"rising","is_aggregate":false},{"code":"ITA","mood":"pessimism","name":"Italy","value":99.994,"change":-0.056,"period":"2026-04","reading":"pessimistic and deteriorating","previous":100.051,"direction":"falling","is_aggregate":false},{"code":"USA","mood":"pessimism","name":"United States","value":99.97,"change":0.057,"period":"2026-04","reading":"pessimistic but recovering","previous":99.912,"direction":"rising","is_aggregate":false},{"code":"CHL","mood":"pessimism","name":"Chile","value":99.956,"change":-0.151,"period":"2026-04","reading":"pessimistic and deteriorating","previous":100.108,"direction":"falling","is_aggregate":false},{"code":"POL","mood":"pessimism","name":"Poland","value":99.924,"change":0.096,"period":"2026-04","reading":"pessimistic but recovering","previous":99.829,"direction":"rising","is_aggregate":false},{"code":"FRA","mood":"pessimism","name":"France","value":99.911,"change":-0.249,"period":"2026-04","reading":"pessimistic and deteriorating","previous":100.159,"direction":"falling","is_aggregate":false},{"code":"OECDXEA","mood":"pessimism","name":"OECD excluding the euro area","value":99.907,"change":-0.015,"period":"2026-03","reading":"pessimistic and deteriorating","previous":99.922,"direction":"falling","is_aggregate":false},{"code":"BRA","mood":"pessimism","name":"Brazil","value":99.89,"change":-0.024,"period":"2026-04","reading":"pessimistic and deteriorating","previous":99.914,"direction":"falling","is_aggregate":false},{"code":"CHE","mood":"pessimism","name":"Switzerland","value":99.89,"change":-0.269,"period":"2026-04","reading":"pessimistic and deteriorating","previous":100.159,"direction":"falling","is_aggregate":false},{"code":"PRT","mood":"pessimism","name":"Portugal","value":99.852,"change":-0.232,"period":"2026-04","reading":"pessimistic and deteriorating","previous":100.084,"direction":"falling","is_aggregate":false},{"code":"NOR","mood":"pessimism","name":"Norway","value":99.765,"change":-0.081,"period":"2026-03","reading":"pessimistic and deteriorating","previous":99.846,"direction":"falling","is_aggregate":false},{"code":"IND","mood":"pessimism","name":"India","value":99.644,"change":-0.183,"period":"2025-11","reading":"pessimistic and deteriorating","previous":99.827,"direction":"falling","is_aggregate":false},{"code":"CZE","mood":"pessimism","name":"Czechia","value":99.536,"change":0.249,"period":"2026-04","reading":"pessimistic but recovering","previous":99.287,"direction":"rising","is_aggregate":false},{"code":"CAN","mood":"pessimism","name":"Canada","value":99.532,"change":0.386,"period":"2026-01","reading":"pessimistic but recovering","previous":99.146,"direction":"rising","is_aggregate":false},{"code":"LUX","mood":"pessimism","name":"Luxembourg","value":99.515,"change":0.099,"period":"2026-04","reading":"pessimistic but recovering","previous":99.417,"direction":"rising","is_aggregate":false},{"code":"ROU","mood":"pessimism","name":"Romania","value":99.476,"change":-0.195,"period":"2026-04","reading":"pessimistic and deteriorating","previous":99.671,"direction":"falling","is_aggregate":false},{"code":"BEL","mood":"pessimism","name":"Belgium","value":99.37,"change":0.165,"period":"2026-04","reading":"pessimistic but recovering","previous":99.205,"direction":"rising","is_aggregate":false},{"code":"DEU","mood":"pessimism","name":"Germany","value":99.24,"change":0.093,"period":"2026-04","reading":"pessimistic but recovering","previous":99.147,"direction":"rising","is_aggregate":false},{"code":"KOR","mood":"pessimism","name":"Korea","value":99.172,"change":0.082,"period":"2026-04","reading":"pessimistic but recovering","previous":99.09,"direction":"rising","is_aggregate":false},{"code":"COL","mood":"pessimism","name":"Colombia","value":99.143,"change":-0.254,"period":"2026-03","reading":"pessimistic and deteriorating","previous":99.397,"direction":"falling","is_aggregate":false},{"code":"GBR","mood":"pessimism","name":"United Kingdom","value":99.09,"change":-0.292,"period":"2026-04","reading":"pessimistic and deteriorating","previous":99.382,"direction":"falling","is_aggregate":false},{"code":"CHN","mood":"pessimism","name":"China (People’s Republic of)","value":98.951,"change":0.313,"period":"2026-04","reading":"pessimistic but recovering","previous":98.638,"direction":"rising","is_aggregate":false},{"code":"HUN","mood":"pessimism","name":"Hungary","value":98.78,"change":0.298,"period":"2026-04","reading":"pessimistic but recovering","previous":98.482,"direction":"rising","is_aggregate":false},{"code":"IDN","mood":"pessimism","name":"Indonesia","value":98.777,"change":0.007,"period":"2026-03","reading":"pessimistic but recovering","previous":98.77,"direction":"rising","is_aggregate":false},{"code":"AUT","mood":"pessimism","name":"Austria","value":98.688,"change":0.069,"period":"2026-04","reading":"pessimistic but recovering","previous":98.618,"direction":"rising","is_aggregate":false},{"code":"DNK","mood":"pessimism","name":"Denmark","value":98.645,"change":0.353,"period":"2026-04","reading":"pessimistic but recovering","previous":98.291,"direction":"rising","is_aggregate":false},{"code":"MEX","mood":"pessimism","name":"Mexico","value":98.246,"change":-0.051,"period":"2026-04","reading":"pessimistic and deteriorating","previous":98.297,"direction":"falling","is_aggregate":false},{"code":"SVN","mood":"pessimism","name":"Slovenia","value":98.244,"change":-0.302,"period":"2026-04","reading":"pessimistic and deteriorating","previous":98.545,"direction":"falling","is_aggregate":false},{"code":"TUR","mood":"pessimism","name":"Türkiye","value":97.987,"change":-0.713,"period":"2026-04","reading":"pessimistic and deteriorating","previous":98.7,"direction":"falling","is_aggregate":false},{"code":"EST","mood":"pessimism","name":"Estonia","value":96.7,"change":-0.055,"period":"2026-04","reading":"pessimistic and deteriorating","previous":96.755,"direction":"falling","is_aggregate":false}],"count":46,"source":"OECD Business & Consumer Confidence (SDMX), amplitude-adjusted","indicator":"Business Confidence Indicator (BCI)","latest_period":"2026-05"},"meta":{"timestamp":"2026-06-12T19:37:47.972Z","request_id":"a51a865b-c881-4d2b-96c7-9e54217de885"},"status":"ok","message":"Business confidence retrieved successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/consumer":{"get":{"operationId":"get_v1_consumer","tags":["Consumer"],"summary":"Consumer Confidence Indicator for every economy, ranked","description":"","parameters":[{"name":"countries_only","in":"query","required":false,"description":"Drop aggregate groups (true)","schema":{"type":"string"},"example":"true"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"The OECD amplitude-adjusted Consumer Confidence Indicator (CCI) for every tracked economy (and aggregates unless countries_only=true), ranked. The index oscillates around 100: above 100 = confidence above its long-term average (optimism), below 100 = pessimism; direction gives whether sentiment is improving or deteriorating. Survey-based soft data, leads the hard data. Each row carries its own period (economies report with a varying lag); discontinued series are excluded. Monthly, cached a few hours.","board":[{"code":"CRI","mood":"optimism","name":"Costa Rica","value":105.41,"change":0.518,"period":"2026-02","reading":"optimistic and improving","previous":104.892,"direction":"rising","is_aggregate":false},{"code":"HUN","mood":"optimism","name":"Hungary","value":102.429,"change":0.885,"period":"2026-05","reading":"optimistic and improving","previous":101.545,"direction":"rising","is_aggregate":false},{"code":"IND","mood":"optimism","name":"India","value":102.367,"change":-0.374,"period":"2026-03","reading":"optimistic but softening","previous":102.741,"direction":"falling","is_aggregate":false},{"code":"MEX","mood":"optimism","name":"Mexico","value":102.115,"change":-0.197,"period":"2026-05","reading":"optimistic but softening","previous":102.312,"direction":"falling","is_aggregate":false},{"code":"COL","mood":"optimism","name":"Colombia","value":101.46,"change":-0.369,"period":"2026-04","reading":"optimistic but softening","previous":101.829,"direction":"falling","is_aggregate":false},{"code":"IDN","mood":"optimism","name":"Indonesia","value":101.223,"change":-0.074,"period":"2026-04","reading":"optimistic but softening","previous":101.298,"direction":"falling","is_aggregate":false},{"code":"LTU","mood":"optimism","name":"Lithuania","value":100.942,"change":-0.02,"period":"2026-05","reading":"optimistic but softening","previous":100.962,"direction":"falling","is_aggregate":false},{"code":"CZE","mood":"optimism","name":"Czechia","value":100.852,"change":-0.564,"period":"2026-05","reading":"optimistic but softening","previous":101.416,"direction":"falling","is_aggregate":false},{"code":"POL","mood":"optimism","name":"Poland","value":100.431,"change":0.053,"period":"2026-05","reading":"optimistic and improving","previous":100.378,"direction":"rising","is_aggregate":false},{"code":"KOR","mood":"optimism","name":"Korea","value":100.408,"change":-0.036,"period":"2026-05","reading":"optimistic but softening","previous":100.444,"direction":"falling","is_aggregate":false},{"code":"BRA","mood":"optimism","name":"Brazil","value":100.328,"change":0.079,"period":"2026-05","reading":"optimistic and improving","previous":100.25,"direction":"rising","is_aggregate":false},{"code":"TUR","mood":"pessimism","name":"Türkiye","value":99.475,"change":0.09,"period":"2026-05","reading":"pessimistic but recovering","previous":99.385,"direction":"rising","is_aggregate":false},{"code":"LVA","mood":"pessimism","name":"Latvia","value":99.355,"change":-0.647,"period":"2026-05","reading":"pessimistic and deteriorating","previous":100.002,"direction":"falling","is_aggregate":false},{"code":"ZAF","mood":"pessimism","name":"South Africa","value":99.305,"change":0.12,"period":"2026-03","reading":"pessimistic but recovering","previous":99.185,"direction":"rising","is_aggregate":false},{"code":"SVK","mood":"pessimism","name":"Slovak Republic","value":99.031,"change":0.107,"period":"2026-05","reading":"pessimistic but recovering","previous":98.924,"direction":"rising","is_aggregate":false},{"code":"SWE","mood":"pessimism","name":"Sweden","value":98.703,"change":-0.15,"period":"2026-05","reading":"pessimistic and deteriorating","previous":98.853,"direction":"falling","is_aggregate":false},{"code":"NZL","mood":"pessimism","name":"New Zealand","value":98.499,"change":-0.066,"period":"2026-03","reading":"pessimistic and deteriorating","previous":98.564,"direction":"falling","is_aggregate":false},{"code":"DEU","mood":"pessimism","name":"Germany","value":98.323,"change":-0.223,"period":"2026-05","reading":"pessimistic and deteriorating","previous":98.546,"direction":"falling","is_aggregate":false},{"code":"ISR","mood":"pessimism","name":"Israel","value":98.306,"change":-0.462,"period":"2026-04","reading":"pessimistic and deteriorating","previous":98.768,"direction":"falling","is_aggregate":false},{"code":"ESP","mood":"pessimism","name":"Spain","value":98.249,"change":-0.39,"period":"2026-05","reading":"pessimistic and deteriorating","previous":98.639,"direction":"falling","is_aggregate":false},{"code":"SVN","mood":"pessimism","name":"Slovenia","value":98.16,"change":-0.32,"period":"2026-05","reading":"pessimistic and deteriorating","previous":98.479,"direction":"falling","is_aggregate":false},{"code":"LUX","mood":"pessimism","name":"Luxembourg","value":98.124,"change":-0.159,"period":"2026-05","reading":"pessimistic and deteriorating","previous":98.283,"direction":"falling","is_aggregate":false},{"code":"GBR","mood":"pessimism","name":"United Kingdom","value":98.066,"change":-0.212,"period":"2026-05","reading":"pessimistic and deteriorating","previous":98.278,"direction":"falling","is_aggregate":false},{"code":"BEL","mood":"pessimism","name":"Belgium","value":98.028,"change":-0.243,"period":"2026-05","reading":"pessimistic and deteriorating","previous":98.271,"direction":"falling","is_aggregate":false},{"code":"AUS","mood":"pessimism","name":"Australia","value":97.964,"change":-0.284,"period":"2026-05","reading":"pessimistic and deteriorating","previous":98.248,"direction":"falling","is_aggregate":false},{"code":"ITA","mood":"pessimism","name":"Italy","value":97.894,"change":-0.252,"period":"2026-05","reading":"pessimistic and deteriorating","previous":98.146,"direction":"falling","is_aggregate":false},{"code":"NLD","mood":"pessimism","name":"Netherlands","value":97.678,"change":-0.309,"period":"2026-05","reading":"pessimistic and deteriorating","previous":97.988,"direction":"falling","is_aggregate":false},{"code":"JPN","mood":"pessimism","name":"Japan","value":97.66,"change":-0.184,"period":"2026-05","reading":"pessimistic and deteriorating","previous":97.844,"direction":"falling","is_aggregate":false},{"code":"AUT","mood":"pessimism","name":"Austria","value":97.626,"change":-0.075,"period":"2026-05","reading":"pessimistic and deteriorating","previous":97.701,"direction":"falling","is_aggregate":false},{"code":"GRC","mood":"pessimism","name":"Greece","value":97.411,"change":-0.009,"period":"2026-05","reading":"pessimistic and deteriorating","previous":97.42,"direction":"falling","is_aggregate":false},{"code":"PRT","mood":"pessimism","name":"Portugal","value":97.39,"change":-0.286,"period":"2026-05","reading":"pessimistic and deteriorating","previous":97.676,"direction":"falling","is_aggregate":false},{"code":"CHL","mood":"pessimism","name":"Chile","value":97.241,"change":-1.273,"period":"2026-05","reading":"pessimistic and deteriorating","previous":98.514,"direction":"falling","is_aggregate":false},{"code":"OECDXEA","mood":"pessimism","name":"OECD excluding the euro area","value":97.232,"change":-0.317,"period":"2026-05","reading":"pessimistic and deteriorating","previous":97.549,"direction":"falling","is_aggregate":false},{"code":"DNK","mood":"pessimism","name":"Denmark","value":97.047,"change":-0.555,"period":"2026-05","reading":"pessimistic and deteriorating","previous":97.602,"direction":"falling","is_aggregate":false},{"code":"CHE","mood":"pessimism","name":"Switzerland","value":96.861,"change":-0.369,"period":"2026-05","reading":"pessimistic and deteriorating","previous":97.229,"direction":"falling","is_aggregate":false},{"code":"FIN","mood":"pessimism","name":"Finland","value":96.838,"change":0.116,"period":"2026-05","reading":"pessimistic but recovering","previous":96.722,"direction":"rising","is_aggregate":false},{"code":"FRA","mood":"pessimism","name":"France","value":96.762,"change":-0.455,"period":"2026-05","reading":"pessimistic and deteriorating","previous":97.217,"direction":"falling","is_aggregate":false},{"code":"IRL","mood":"pessimism","name":"Ireland","value":96.717,"change":-0.08,"period":"2026-05","reading":"pessimistic and deteriorating","previous":96.797,"direction":"falling","is_aggregate":false},{"code":"USA","mood":"pessimism","name":"United States","value":95.631,"change":-0.466,"period":"2026-05","reading":"pessimistic and deteriorating","previous":96.097,"direction":"falling","is_aggregate":false},{"code":"CHN","mood":"pessimism","name":"China (People’s Republic of)","value":95.325,"change":-0.21,"period":"2026-04","reading":"pessimistic and deteriorating","previous":95.535,"direction":"falling","is_aggregate":false},{"code":"EST","mood":"pessimism","name":"Estonia","value":94.63,"change":-0.856,"period":"2026-04","reading":"pessimistic and deteriorating","previous":95.487,"direction":"falling","is_aggregate":false}],"count":41,"source":"OECD Business & Consumer Confidence (SDMX), amplitude-adjusted","indicator":"Consumer Confidence Indicator (CCI)","latest_period":"2026-05"},"meta":{"timestamp":"2026-06-12T19:37:51.743Z","request_id":"479156ea-93b9-4c30-9028-362211ae6322"},"status":"ok","message":"Consumer confidence retrieved successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/country":{"get":{"operationId":"get_v1_country","tags":["Country"],"summary":"Business + consumer confidence side by side for one economy","description":"","parameters":[{"name":"country","in":"query","required":true,"description":"ISO-3 code or name","schema":{"type":"string"},"example":"USA"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"code":"USA","name":"United States","note":"One economy's OECD Business and Consumer Confidence side by side. Both indices oscillate around 100 (above = optimism). Survey-based soft data that leads the hard data. Monthly, cached a few hours.","period":"2026-04","source":"OECD Business & Consumer Confidence (SDMX)","is_aggregate":false,"combined_read":"both firms and households pessimistic","business_confidence":{"mood":"pessimism","value":99.97,"change":0.057,"reading":"pessimistic but recovering","direction":"rising"},"consumer_confidence":{"mood":"pessimism","value":95.631,"change":-0.466,"reading":"pessimistic and deteriorating","direction":"falling"}},"meta":{"timestamp":"2026-06-12T19:37:51.816Z","request_id":"eeee82a7-94d4-4b77-9f4b-8f3d98b1c25b"},"status":"ok","message":"Country confidence retrieved successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/meta":{"get":{"operationId":"get_v1_meta","tags":["Meta"],"summary":"Service metadata","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"business and consumer take countries_only (true to drop aggregates). country takes country (ISO-3 code or name, required). meta takes no parameters. Index values are points around 100; the mood is above/below 100 and the direction is rising/falling. Monthly data; a multi-hour protective cache fronts the OECD upstream.","source":"OECD Business (BCICP) & Consumer (CCICP) Confidence via OECD SDMX API, amplitude-adjusted, live, keyless","service":"confidence-api","endpoints":{"GET /v1/meta":"This document.","GET /v1/country":"Business + consumer confidence side by side for one economy (country=USA).","GET /v1/business":"Business Confidence Indicator (BCI) for every economy, ranked (countries_only optional).","GET /v1/consumer":"Consumer Confidence Indicator (CCI) for every economy, ranked (countries_only optional)."},"description":"OECD Business & Consumer Confidence — how optimistic firms and households are in each economy, live from the OECD (no key). Both are amplitude-adjusted survey indices around 100 (above = optimism, below = pessimism) that lead the hard data. business returns the Business Confidence Indicator for every economy ranked; consumer returns the Consumer Confidence Indicator; country puts both side by side for one economy with a combined read. The survey-based soft-data / sentiment cut — distinct from the OECD composite-leading-indicator board (a different measure), the bond-yield and inflation boards, and the generic data aggregator.","united_states":{"business":99.97,"consumer":95.631},"upstream_status":"ok","business_economies":54,"consumer_economies":49},"meta":{"timestamp":"2026-06-12T19:37:51.917Z","request_id":"e8e37c41-f485-498d-bd4a-370c076e2710"},"status":"ok","message":"Meta","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}}},"x-oanor-pricing":[{"slug":"free","name":"Free","price_cents_month":0,"monthly_call_quota":860,"rps_limit":2,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":1050,"monthly_call_quota":19100,"rps_limit":6,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":3180,"monthly_call_quota":96500,"rps_limit":16,"hard_limit":true},{"slug":"business","name":"Business","price_cents_month":7280,"monthly_call_quota":524000,"rps_limit":40,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/confidence-api"}