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

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.2
File Size Uploaded
boarddata-6.8.2.tar.gz 84.8 kB Details

Built distribution (wheel)

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

Total release size: 203.7 kB

Release files / boarddata-6.8.2.tar.gz

Download URL boarddata-6.8.2.tar.gz
Size 84.8 kB
Tags Source
SHA-256 checksum
How to use checksums
6573fd7357d3ac292552c6dbb46aa577e56be2e752fd0e6049686bdf67e4d7b0
BLAKE2b-256 checksum
How to use checksums
9297e7a6f346e9c1aa0fae769bc712817c328d1192683aa330e84d21563be76d
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.2-py3-none-any.whl

Download URL boarddata-6.8.2-py3-none-any.whl
Size 118.8 kB
Tags Python 3
SHA-256 checksum
How to use checksums
ff4e091634b3d0d817dabb5cfff32171c513ac7678df9301ed0947559378e273
BLAKE2b-256 checksum
How to use checksums
53abfa4d28fad71e81207df4503e0cfa730ad0839142ee33681f77e439f6e8df
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

6.8.3

2 release files

This release

6.8.2 This release

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