Sandbox and production
The base URL, the two kinds of key, and the API version.
Base URL
https://gateway.staging.finsour.io
The API is in beta, and the beta is served from this staging gateway. The platform’s contract names no production address yet; this page will when it does.
Sandbox and production
| Sandbox | Production | |
|---|---|---|
| Key | fs_test_… | fs_live_… |
| Access | Given to your organisation when you verify your email | Granted by an Admin |
| Paid from | Your sandbox credit, never rupees | Your account, at your price |
| Data | The real data sources | The real data sources |
| meta.environment | sandbox | production |
The sandbox calls the real data sources, so use details you are entitled to look up. It publishes no test values. The two environments are separate end to end: a sandbox key can never see a production request or job, or the reverse.
An API an Admin has switched off in an environment answers 403 PRODUCT_NOT_AVAILABLE there. GET /v1/products lists the APIs your key may call in its environment.
API version
The newest published version is 2026-11-01. A request that names no version is served under the default, 2026-09-01. Every answer names the version that served it, in meta.apiVersion and the X-FinSour-Api-Version header. A request can name a version in the FinSour-Version header; one that is not published is refused 400 API_VERSION_UNSUPPORTED, and one past its announced sunset 410 API_VERSION_SUNSET. The document APIs are documented under 2026-11-01; see Document APIs.
Written from FinSour platform API contract (finsour development at 80e8b83bf), last changed . OpenAPI document at commit 436311c32, API version 2026-11-01. The beta is served from the staging gateway.