globalbarry. Company Intelligence Engine
Developers · Documentation

Global Barry Intelligence API v1

← Your credentials OpenAPI JSON

A versioned, authenticated API over Global Barry's own normalized intelligence, derived only from public and primary sources (SEC EDGAR, Federal Register, the Federal Reserve, U.S. Treasury, BEA, BLS, Census, Fiscal Data and public corporate releases). No commercial market-data vendor is proxied. This is not investment advice, and no real-time prices or price-movement claims are returned.

Authentication

Every request needs a Global Barry API credential. Create one on the Developer page. Send it as a Bearer token (or the X-API-Key header):

curl -H 'Authorization: Bearer $BARRY_API_KEY' http://globalbarry.com/api/v1/events
  • Missing / invalid / revoked credential → 401 with a JSON error.
  • Per-minute rate limit exceeded → 429 with a Retry-After header.
  • Rolling 30-day quota exceeded → 429 with a clear message.

Response envelope

Every response is JSON (Content-Type: application/json, Cache-Control: no-store) and carries top-level metadata plus per-item provenance:

  • api_version, request_id, disclaimer — top level.
  • source — human-readable source (e.g. "SEC EDGAR", "U.S. Bureau of Economic Analysis").
  • source_url — openable canonical/accession URL, or "Unavailable".
  • retrieval_timestamp — when Global Barry first retrieved the record.
  • analysis_timestamp — when intelligence/AI was computed (null for deterministic-only).
  • evidence_type — primary_filing · regulatory_document · economic_release · derived_intelligence · ai_analysis.
  • confidence — FACT · INFERENCE · ANALYSIS · UNKNOWN (plus an uncertainty note where relevant).
  • ai_generated (bool) and ai_generated_fields (which fields are model-generated).

All GET endpoints are deterministic and never call the language model. Only POST /research and POST /impact-analysis may, and only on a cache miss — identical inputs reuse the cache.

Endpoints

GET /api/v1/companies/{ticker}
Company profile intelligence (identity + normalized summary).
Parameters:
  • ticker (path) — Ticker symbol (e.g. NVDA) or CIK.
Example: 
curl -H 'Authorization: Bearer $BARRY_API_KEY' 'http://globalbarry.com/api/v1/companies/NVDA'
GET /api/v1/companies/{ticker}/filings
Filings for a company (record kind 'filing'), newest first, paginated.
Parameters:
  • ticker (path) — Ticker or CIK.
  • page (query) — 1-based page (default 1).
  • page_size (query) — Items per page (default 25, max 100).
Example: 
curl -H 'Authorization: Bearer $BARRY_API_KEY' 'http://globalbarry.com/api/v1/companies/NVDA/filings'
GET /api/v1/companies/{ticker}/events
Normalized events involving the company, paginated.
Parameters:
  • ticker (path) — Ticker or CIK.
  • page (query) — Page.
  • page_size (query) — Page size.
Example: 
curl -H 'Authorization: Bearer $BARRY_API_KEY' 'http://globalbarry.com/api/v1/companies/NVDA/events'
GET /api/v1/companies/{ticker}/exposure
Qualitative exposure relationships (derived; inferences labeled).
Parameters:
  • ticker (path) — Ticker or CIK.
Example: 
curl -H 'Authorization: Bearer $BARRY_API_KEY' 'http://globalbarry.com/api/v1/companies/NVDA/exposure'
GET /api/v1/companies/{ticker}/risk-factors
Risk-factor intelligence (evidence-grounded source filings).
Parameters:
  • ticker (path) — Ticker or CIK.
Example: 
curl -H 'Authorization: Bearer $BARRY_API_KEY' 'http://globalbarry.com/api/v1/companies/NVDA/risk-factors'
GET /api/v1/companies/{ticker}/geographic-exposure
Geographic / country exposure (qualitative; inferences labeled).
Parameters:
  • ticker (path) — Ticker or CIK.
Example: 
curl -H 'Authorization: Bearer $BARRY_API_KEY' 'http://globalbarry.com/api/v1/companies/NVDA/geographic-exposure'
GET /api/v1/events
List normalized events, filterable, ranked by materiality & recency.
Parameters:
  • type (query) — Category filter (e.g. regulatory, economic).
  • country (query) — Country substring filter.
  • industry (query) — Industry filter.
  • company (query) — Ticker/CIK filter.
  • page (query) — Page.
  • page_size (query) — Page size.
Example: 
curl -H 'Authorization: Bearer $BARRY_API_KEY' 'http://globalbarry.com/api/v1/events'
GET /api/v1/events/{event_id}
Single normalized event intelligence object.
Parameters:
  • event_id (path) — Event id (e.g. EV1234) or record id.
Example: 
curl -H 'Authorization: Bearer $BARRY_API_KEY' 'http://globalbarry.com/api/v1/events/EV1'
GET /api/v1/events/{event_id}/companies
Companies related to an event (relationship graph; inferences labeled).
Parameters:
  • event_id (path) — Event id or record id.
Example: 
curl -H 'Authorization: Bearer $BARRY_API_KEY' 'http://globalbarry.com/api/v1/events/EV1/companies'
GET /api/v1/economic-events
Economic observation records, filterable, paginated.
Parameters:
  • indicator (query) — Indicator code filter (e.g. FEDFUNDS).
  • page (query) — Page.
  • page_size (query) — Page size.
Example: 
curl -H 'Authorization: Bearer $BARRY_API_KEY' 'http://globalbarry.com/api/v1/economic-events'
POST /api/v1/research
On-demand deep research (AI). Reuses cache on identical inputs.
Body (JSON):
  • question — string (required)
  • regenerate — boolean (optional)
Example: 
curl -X POST -H 'Authorization: Bearer $BARRY_API_KEY' -H 'Content-Type: application/json' -d '{"question": "What recent filings has NVIDIA made?"}' 'http://globalbarry.com/api/v1/research'
POST /api/v1/impact-analysis
Analyzed impact/relevance for an event and/or companies (AI).
Body (JSON):
  • event_text — string
  • event_id — string (EV… or record id)
  • companies — array of tickers/CIKs (optional)
  • regenerate — boolean (optional)
Example: 
curl -X POST -H 'Authorization: Bearer $BARRY_API_KEY' -H 'Content-Type: application/json' -d '{"event_text": "New export controls on advanced chips"}' 'http://globalbarry.com/api/v1/impact-analysis'

Example response

{
  "api_version": "v1",
  "request_id": "req_3f9c2a1b8e7d",
  "disclaimer": "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.",
  "pagination": {
    "page": 1,
    "page_size": 25,
    "total": 1,
    "pages": 1
  },
  "data": [
    {
      "data": {
        "event_id": "EV1234",
        "event": "New U.S. export controls on advanced chips",
        "date": "2026-09-18",
        "category": "regulatory"
      },
      "source": "U.S. Federal Register",
      "source_url": "https://www.federalregister.gov/documents/...",
      "retrieval_timestamp": "2026-09-18T13:02:11+00:00",
      "analysis_timestamp": null,
      "evidence_type": "regulatory_document",
      "confidence": {
        "tier": "FACT",
        "note": "Sourced directly from a primary regulatory release."
      },
      "ai_generated": false,
      "ai_generated_fields": []
    }
  ]
}

Sources & redistribution

Every returned item passes through a source-permission registry. Only sources explicitly flagged redistributable (today: all public / primary government and public corporate sources) are exposed. New permitted sources can be onboarded later by adding a registry row and a mapper — without changing any endpoint contract. There is intentionally no commercial / licensed vendor data path.

AI-generated fields are produced by a language model over cited evidence, carry a confidence tier, and may be incomplete — always verify against the linked source. The API never returns investment advice or price-movement claims.