Intelligence Data

Structured intelligence behind The Neural Ledger's analysis: country coverage, trade-flow routes and events, source identity, and corporation profiles.

API key requiredStarter and above

Thirty collections across four families. Calls count against your plan's monthly allowance.

Restricted use

Licensed for your own internal use. You may not redistribute, republish, resell, or expose it on a public surface. Every response carries the terms in a redistribution object, and they apply to cached copies too.

Families

Family	Collections
Country watch (10)	countries, coverage, financials, structural-factors, documents, authorities, market-snapshots, events, impact-routes, impact-outcomes
Trade flow (4)	events, routes, calibration, replay-scenarios
Sources (4)	sources, source-accounts, social-accounts, source-similarity
Corporations (12)	corporations, inputs, outputs, workforce, stock-history, effector-taxonomy, effector-weights, effector-observations, predictions, dependency-nodes, dependency-edges, filings

GET /v1/intel/resources

The catalog — every collection with its key, available fields and supported filters. Read this rather than hard-coding paths; it is authoritative, and collections can be added without a client change.

curl -H "Authorization: Bearer $TNL_API_KEY" \
  https://theneuralledger.com/v1/intel/resources

GET /v1/intel/{family}/{collection}

curl -H "Authorization: Bearer $TNL_API_KEY" \
  "https://theneuralledger.com/v1/intel/country-watch/countries?limit=50"

curl -H "Authorization: Bearer $TNL_API_KEY" \
  "https://theneuralledger.com/v1/intel/trade-flow/routes?limit=20"

The sources and corporations families sit at the top level:

curl -H "Authorization: Bearer $TNL_API_KEY" \
  "https://theneuralledger.com/v1/intel/sources?limit=20"

Parameters. limit (max 200), cursor, all=1, plus whatever filters the catalog lists for that collection. Common ones are updated_since, updated_before, q and the collection's own key.

Unsupported filters are rejected, not ignored. A silently dropped filter returns a wider set than you asked for, which is a harder bug to notice than a 400.

Paging

Each response carries a cursor. Repeat the identical filters plus cursor:

curl -H "Authorization: Bearer $TNL_API_KEY" \
  "https://theneuralledger.com/v1/intel/corporations?limit=100&cursor=eyJ2ZXJ..."

Or pass all=1 and we walk it for you — the response then reports pages and, if the walk hit its ceiling, truncated: true. Treat truncated as "there is more", not as the end of the data.

Two properties worth respecting:

• Cursors expire after an hour. cursorExpiresAt tells you when. A stale cursor needs a fresh query, not a retry.
• Consistency is creation_fenced_keyset_not_snapshot. It is keyset paging, not a point-in-time snapshot: rows created during a long walk may not appear. For incremental syncs, persist a window only after all its pages complete.

Data honesty

Records preserve source evidence, observation timestamps, quality states, units, currencies and nulls, and decimals are strings to survive the round trip.

Unavailable is reported as unavailable. A corporation without a prediction or a stock history returns empty rather than a placeholder. There are issuer profiles without fully populated datasets behind them — treat an empty field as "we do not have this", and render it that way rather than as a zero or an empty chart.

Errors

Status	Meaning
401	Missing or invalid API key
403	Your plan does not include intelligence data
404	Unknown collection — the response lists what is available
400	Unsupported filter — the response lists what that collection accepts
503	Upstream backpressure. Honour Retry-After.