Skip to main content

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.3

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for boarddata 6.8.3
File Size Uploaded
boarddata-6.8.3.tar.gz 85.4 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for boarddata 6.8.3
File Interpreter ABI Platform
boarddata-6.8.3-py3-none-any.whl Python 3 none any Details

Total release size: 204.7 kB

Release files / boarddata-6.8.3.tar.gz

Download URL boarddata-6.8.3.tar.gz
Size 85.4 kB
Tags Source
SHA-256 checksum
How to use checksums
97f9c6896bb4f863a9a4cdc8ba7e89a7f1f8f4c8a28628991f3ffaf670f10985
BLAKE2b-256 checksum
How to use checksums
ff334cf7fda22d5249f121c7f3a991411f0b5b0e1aeb50c0231f5e40258c6ccf
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.13.15

Release files / boarddata-6.8.3-py3-none-any.whl

Download URL boarddata-6.8.3-py3-none-any.whl
Size 119.3 kB
Tags Python 3
SHA-256 checksum
How to use checksums
ac2be76363dba4b2066253b63cc15279650970c50f2281eaf1d34e5c60932892
BLAKE2b-256 checksum
How to use checksums
f4534a2f4d9702960e7f9b87a657320850356bb552ea98b7427a23b7bcf19060
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.13.15

Release history Release notifications | RSS feed

6.8.4

2 release files

This release

6.8.3 This release

2 release files

6.8.2

2 release files

6.8.1

2 release files

6.7.4

2 release files

6.7.3

2 release files

6.7.2

2 release files

6.7.1

2 release files

6.6.3

2 release files

6.6.2

2 release files

6.6.1

2 release files

6.5.1

2 release files

6.4.2

2 release files

6.4.1

2 release files

6.3.1

2 release files

6.2.2

2 release files

6.2.1

2 release files

6.1.1

2 release files

6.0.1

2 release files

5.0.1

2 release files

4.4.21

2 release files

4.4.20

2 release files

4.4.19

2 release files

4.4.18

2 release files

4.4.17

2 release files

4.4.16

2 release files

4.4.15

2 release files

4.4.14

2 release files

4.4.13

2 release files

4.4.12

2 release files

4.4.11

2 release files

4.4.10

2 release files

4.4.9

2 release files

4.4.8

2 release files

4.4.6

2 release files

4.4.4

2 release files

4.4.2

2 release files

4.4.1

2 release files

4.3.1

2 release files

4.2.2

2 release files

4.2.1

2 release files

4.1.3

2 release files

4.1.2

2 release files

4.1.1

2 release files

4.0.2

2 release files

4.0.1

2 release files

4.0.0

2 release files

3.1.0

2 release files

3.0.2

2 release files

3.0.1

2 release files

3.0.0

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page