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

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.1
File Size Uploaded
boarddata-6.8.1.tar.gz 84.5 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for boarddata 6.8.1
File Interpreter ABI Platform
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

Release history Release notifications | RSS feed

6.8.4

2 release files

6.8.3

2 release files

6.8.2

2 release files

This release

6.8.1 This release

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