---
title: "OpenAPI document names the response headers and describes every filings route"
description: "The OpenAPI document now declares the headers each call returns, and the docs list every MCP tool and the countries the Economics API serves."
url: "https://narwhalapi.com/changelog/openapi-headers-and-text"
---

# OpenAPI document names the response headers and describes every filings route

The OpenAPI document now declares the headers each call returns, and the docs list every MCP tool and the countries the Economics API serves.

November 20, 2026

The OpenAPI document now declares the headers each call returns, and the docs list every MCP tool and the countries the Economics API serves.

## What changed

- The OpenAPI document declares X-Request-Id, X-Narwhal-Cost, X-Narwhal-Balance, the X-RateLimit headers and Retry-After on the calls that send them. X-RateLimit-Limit is the size of your request bucket, not a count of requests per minute.
- All 33 filings routes in the OpenAPI document now have a summary and a description.
- The two filing text routes list format as json only, trade routes no longer list as_of and version (they were always refused), and the prices stream-ticket route lists its 410.
- /docs/mcp names all 140 MCP tools, up from 109. The Economics country lists are read from the API's own tables and now include Brazil, China, Indonesia, India, Israel, South Korea, Thailand and South Africa, which the API already served.

[All changelog entries](https://narwhalapi.com/changelog.md) · [Changelog RSS feed](https://narwhalapi.com/changelog/feed.xml)

Was this page helpful?
