Metadata-Version: 2.4
Name: nexus-filings
Version: 0.1.1
Summary: Official SDK for Nexus Filings: normalized financial data extracted from official filings across multiple registries (UK, US, Denmark, Norway, Brazil and other European markets)
Author: TFSouthCode
License-Expression: Apache-2.0
Keywords: financial-data,xbrl,ixbrl,companies-house,filings
Requires-Python: >=3.9
Description-Content-Type: text/markdown
License-File: LICENSE
License-File: NOTICE
Requires-Dist: requests>=2.31
Dynamic: license-file

# nexus-filings (Python)

Official SDK for [Nexus Filings](https://nexusfilings.io): normalized financial data
(revenue, profit, equity, ratios) extracted from official filings across multiple
registries (UK, US, Denmark, Norway, Brazil and other European markets — see full
coverage at [nexusfilings.io](https://nexusfilings.io/#coverage)), with the provenance
of every field (`direct`, `derived` or `unavailable`).

```bash
pip install nexus-filings
```

```python
from nexus_filings_sdk import NexusFilingsClient

client = NexusFilingsClient(api_key="YOUR_API_KEY")

for company in client.search("wise"):
    print(company["id"], company["name"])

result = client.get_financials("GB:07209813")             # Free: latest fiscal year only; paid plans: full history
result = client.get_financials("GB:07209813", fiscal_year=2024)
print(result["available_years"])
```

A query for a company that hasn't been processed yet may respond with `202` (processing):
the SDK returns the body with `"status": "processing"` and `retry_after_seconds`; retry the
same request after that time (errors, by contrast, raise `NexusFilingsAPIError`). Full
documentation: https://nexusfilings.io/docs.html

## License

Apache License 2.0 — Copyright 2026 TFSouthCode. See `LICENSE` and `NOTICE`. The license
covers this SDK's code; use of the API and the data is governed by Nexus Filings' Terms
of Service.
