boarddata
Python SDK for the BoardData V2 REST API.
Installation
pip install boarddata
Quick Start
from boarddata import BoardDataClient
# From environment variables
client = BoardDataClient.from_env()
# Or explicit configuration
client = BoardDataClient(
base_url="https://api.boarddata.scalens.com",
client_id="your-client-id",
client_secret="your-client-secret",
)
# List companies
companies = client.list_companies(country="FR", page_size=10)
# Get a specific company
company = client.get_company("company-uuid")
# Create or update a company
result = client.upsert_company("FR0000120271", "TotalEnergies", country="FR")
print(result["action"]) # "created" or "updated"
print(result["id"]) # company UUID
Environment Variables
| Variable | Description |
|---|---|
BOARDDATA_BACKEND_URL |
Base URL of the BoardData API |
BOARDDATA_CLIENT_ID |
OAuth2 client ID (from Django admin) |
BOARDDATA_CLIENT_SECRET |
OAuth2 client secret (from Django admin) |
Token Caching
from boarddata import BoardDataClient, FileTokenCache
# File-based cache
client = BoardDataClient.from_env(token_cache="~/.boarddata/token.json")
# Or with explicit cache object
cache = FileTokenCache("~/.boarddata/token.json")
client = BoardDataClient.from_env(token_cache=cache)
Pagination
# Auto-paginate any list endpoint
all_companies = client.paginate(client.list_companies, country="FR")
# Limit pages
first_100 = client.paginate(client.list_companies, max_pages=4, page_size=25)
Available Domains
- Companies —
list_companies,get_company,create_company,update_company,delete_company,upsert_company - Persons —
list_persons,get_person,create_person,update_person,delete_person,upsert_person - Directors —
list_directors,get_director,create_director,update_director,delete_director,upsert_director - Comex —
list_comex,get_comex,create_comex,update_comex,delete_comex,upsert_comex - Auditors —
list_auditors,get_auditor,create_auditor,update_auditor,delete_auditor - Documents —
list_documents,get_document,create_document,update_document,delete_document - Assemblies —
list_assemblies,get_assembly,create_assembly,update_assembly,delete_assembly - Resolutions —
list_resolutions,get_resolution,update_resolution,delete_resolution - ESG —
list_iros,create_iro,list_transition_plans,create_transition_plan,list_esg_benchmark - Sentinel —
list_analyses,create_analysis,retry_press_extraction,update_press_article - Utilities —
search,query_assistant,get_field_sources,paginate
License
MIT
Release files for boarddata 6.8.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| boarddata-6.8.1.tar.gz | 84.5 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| boarddata-6.8.1-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 203.1 kB
Release files / boarddata-6.8.1.tar.gz
| Download URL | boarddata-6.8.1.tar.gz |
|---|---|
| Size | 84.5 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
7433db284074056f1d65f86e6ee02f76218454a8030535d733d664176c3c5358
|
|
BLAKE2b-256 checksum How to use checksums |
2d2b6bb19c7d1f42bc759a3f584157001062b5f7dddd3856b5d2e41753c2206d
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Release files / boarddata-6.8.1-py3-none-any.whl
| Download URL | boarddata-6.8.1-py3-none-any.whl |
|---|---|
| Size | 118.6 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
accd1966b748e0b484907dbcfa78b40e1e98d5de8334c3ad3660473474216d7b
|
|
BLAKE2b-256 checksum How to use checksums |
a26f9c161ed2ac97efc5cc7b8860a5fa1ced3be770e2d207aaf3cabfe12ba9c9
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|