{"components": {"securitySchemes": {"ApiKeyHeader": {"description": "Global Barry API credential.", "in": "header", "name": "X-API-Key", "type": "apiKey"}, "BearerAuth": {"description": "Global Barry API credential as a Bearer token.", "scheme": "bearer", "type": "http"}}}, "info": {"description": "This API returns intelligence derived only from public and primary sources. It is provided for informational purposes only and is NOT investment advice. Fields marked ai_generated are produced by a language model over cited evidence and may be incomplete or contain errors; verify against the linked source before relying on them. No real-time prices or price-movement claims are provided.", "title": "Global Barry Intelligence API", "version": "v1"}, "openapi": "3.0.3", "paths": {"/api/v1/companies/{ticker}": {"get": {"parameters": [{"description": "Ticker symbol (e.g. NVDA) or CIK.", "in": "path", "name": "ticker", "required": true, "schema": {"type": "string"}}], "responses": {"200": {"description": "Success \u2014 standard envelope."}, "401": {"description": "Missing, invalid or revoked API credential."}, "429": {"description": "Rate limit or monthly quota exceeded."}}, "security": [{"BearerAuth": []}, {"ApiKeyHeader": []}], "summary": "Company profile intelligence (identity + normalized summary)."}}, "/api/v1/companies/{ticker}/events": {"get": {"parameters": [{"description": "Ticker or CIK.", "in": "path", "name": "ticker", "required": true, "schema": {"type": "string"}}, {"description": "Page.", "in": "query", "name": "page", "required": false, "schema": {"type": "string"}}, {"description": "Page size.", "in": "query", "name": "page_size", "required": false, "schema": {"type": "string"}}], "responses": {"200": {"description": "Success \u2014 standard envelope."}, "401": {"description": "Missing, invalid or revoked API credential."}, "429": {"description": "Rate limit or monthly quota exceeded."}}, "security": [{"BearerAuth": []}, {"ApiKeyHeader": []}], "summary": "Normalized events involving the company, paginated."}}, "/api/v1/companies/{ticker}/exposure": {"get": {"parameters": [{"description": "Ticker or CIK.", "in": "path", "name": "ticker", "required": true, "schema": {"type": "string"}}], "responses": {"200": {"description": "Success \u2014 standard envelope."}, "401": {"description": "Missing, invalid or revoked API credential."}, "429": {"description": "Rate limit or monthly quota exceeded."}}, "security": [{"BearerAuth": []}, {"ApiKeyHeader": []}], "summary": "Qualitative exposure relationships (derived; inferences labeled)."}}, "/api/v1/companies/{ticker}/filings": {"get": {"parameters": [{"description": "Ticker or CIK.", "in": "path", "name": "ticker", "required": true, "schema": {"type": "string"}}, {"description": "1-based page (default 1).", "in": "query", "name": "page", "required": false, "schema": {"type": "string"}}, {"description": "Items per page (default 25, max 100).", "in": "query", "name": "page_size", "required": false, "schema": {"type": "string"}}], "responses": {"200": {"description": "Success \u2014 standard envelope."}, "401": {"description": "Missing, invalid or revoked API credential."}, "429": {"description": "Rate limit or monthly quota exceeded."}}, "security": [{"BearerAuth": []}, {"ApiKeyHeader": []}], "summary": "Filings for a company (record kind 'filing'), newest first, paginated."}}, "/api/v1/companies/{ticker}/geographic-exposure": {"get": {"parameters": [{"description": "Ticker or CIK.", "in": "path", "name": "ticker", "required": true, "schema": {"type": "string"}}], "responses": {"200": {"description": "Success \u2014 standard envelope."}, "401": {"description": "Missing, invalid or revoked API credential."}, "429": {"description": "Rate limit or monthly quota exceeded."}}, "security": [{"BearerAuth": []}, {"ApiKeyHeader": []}], "summary": "Geographic / country exposure (qualitative; inferences labeled)."}}, "/api/v1/companies/{ticker}/risk-factors": {"get": {"parameters": [{"description": "Ticker or CIK.", "in": "path", "name": "ticker", "required": true, "schema": {"type": "string"}}], "responses": {"200": {"description": "Success \u2014 standard envelope."}, "401": {"description": "Missing, invalid or revoked API credential."}, "429": {"description": "Rate limit or monthly quota exceeded."}}, "security": [{"BearerAuth": []}, {"ApiKeyHeader": []}], "summary": "Risk-factor intelligence (evidence-grounded source filings)."}}, "/api/v1/economic-events": {"get": {"parameters": [{"description": "Indicator code filter (e.g. FEDFUNDS).", "in": "query", "name": "indicator", "required": false, "schema": {"type": "string"}}, {"description": "Page.", "in": "query", "name": "page", "required": false, "schema": {"type": "string"}}, {"description": "Page size.", "in": "query", "name": "page_size", "required": false, "schema": {"type": "string"}}], "responses": {"200": {"description": "Success \u2014 standard envelope."}, "401": {"description": "Missing, invalid or revoked API credential."}, "429": {"description": "Rate limit or monthly quota exceeded."}}, "security": [{"BearerAuth": []}, {"ApiKeyHeader": []}], "summary": "Economic observation records, filterable, paginated."}}, "/api/v1/events": {"get": {"parameters": [{"description": "Category filter (e.g. regulatory, economic).", "in": "query", "name": "type", "required": false, "schema": {"type": "string"}}, {"description": "Country substring filter.", "in": "query", "name": "country", "required": false, "schema": {"type": "string"}}, {"description": "Industry filter.", "in": "query", "name": "industry", "required": false, "schema": {"type": "string"}}, {"description": "Ticker/CIK filter.", "in": "query", "name": "company", "required": false, "schema": {"type": "string"}}, {"description": "Page.", "in": "query", "name": "page", "required": false, "schema": {"type": "string"}}, {"description": "Page size.", "in": "query", "name": "page_size", "required": false, "schema": {"type": "string"}}], "responses": {"200": {"description": "Success \u2014 standard envelope."}, "401": {"description": "Missing, invalid or revoked API credential."}, "429": {"description": "Rate limit or monthly quota exceeded."}}, "security": [{"BearerAuth": []}, {"ApiKeyHeader": []}], "summary": "List normalized events, filterable, ranked by materiality & recency."}}, "/api/v1/events/{event_id}": {"get": {"parameters": [{"description": "Event id (e.g. EV1234) or record id.", "in": "path", "name": "event_id", "required": true, "schema": {"type": "string"}}], "responses": {"200": {"description": "Success \u2014 standard envelope."}, "401": {"description": "Missing, invalid or revoked API credential."}, "429": {"description": "Rate limit or monthly quota exceeded."}}, "security": [{"BearerAuth": []}, {"ApiKeyHeader": []}], "summary": "Single normalized event intelligence object."}}, "/api/v1/events/{event_id}/companies": {"get": {"parameters": [{"description": "Event id or record id.", "in": "path", "name": "event_id", "required": true, "schema": {"type": "string"}}], "responses": {"200": {"description": "Success \u2014 standard envelope."}, "401": {"description": "Missing, invalid or revoked API credential."}, "429": {"description": "Rate limit or monthly quota exceeded."}}, "security": [{"BearerAuth": []}, {"ApiKeyHeader": []}], "summary": "Companies related to an event (relationship graph; inferences labeled)."}}, "/api/v1/impact-analysis": {"post": {"parameters": [], "requestBody": {"content": {"application/json": {"schema": {"properties": {"companies": {"type": "string"}, "event_id": {"type": "string"}, "event_text": {"type": "string"}, "regenerate": {"type": "string"}}, "type": "object"}}}, "required": true}, "responses": {"200": {"description": "Success \u2014 standard envelope."}, "401": {"description": "Missing, invalid or revoked API credential."}, "429": {"description": "Rate limit or monthly quota exceeded."}}, "security": [{"BearerAuth": []}, {"ApiKeyHeader": []}], "summary": "Analyzed impact/relevance for an event and/or companies (AI)."}}, "/api/v1/research": {"post": {"parameters": [], "requestBody": {"content": {"application/json": {"schema": {"properties": {"question": {"type": "string"}, "regenerate": {"type": "string"}}, "type": "object"}}}, "required": true}, "responses": {"200": {"description": "Success \u2014 standard envelope."}, "401": {"description": "Missing, invalid or revoked API credential."}, "429": {"description": "Rate limit or monthly quota exceeded."}}, "security": [{"BearerAuth": []}, {"ApiKeyHeader": []}], "summary": "On-demand deep research (AI). Reuses cache on identical inputs."}}}, "security": [{"BearerAuth": []}, {"ApiKeyHeader": []}], "servers": [{"url": "/"}]}