Skip to content

PyCompanyData is an unofficial Python client library for the Codat API.

License

Notifications You must be signed in to change notification settings

pj-simpson/PyCompanyData

Repository files navigation

PyCompanyData

PyCompanyData is an unofficial Python client library for the Codat API.

CI pypi versions

PyCompanyData is a package which harnesses the power of Requests and Pydantic, (two of the most esteemed Python projects around), making it easy to interact with resources in the Codat Platform from your Python code.

Installation

pip install pycompanydata

Quick Start

# import the main client 
from pycompanydata import Codat

# enter credentials
client = Codat('your-API-key')

# get a page of companies
companies = client.get_companies_page()

# loop over the companies and print out their names
for company in companies.results:
    print(company.name)

Disclaimer

The origin of the package comes from Codat's internal Hackathon, which was held in Jan 2023. The authors of the package are Codat staff, but this isnt an officially supported product. Please treat it as an example of what is possible to achieve with the Codat Public REST API. Many thanks to Tim Hoare, John Hicks and Amber Lewis for their contributions and being on the Hackathon team!

Contributing

See disclaimer for context.

Docs

The aim is improve documentation ASAP. For the time being, if you wish to see whats currently possible with PyCompanyData, you can view the methods in src/pycodat/clients/platform_client and src/pycodat/clients/accounting_client. We have implemented 'GET' methods only on the endpoints to manage the Codat Platform as well as a subset of the Accounting API. If you would like something adding, just raise an issue!

About

PyCompanyData is an unofficial Python client library for the Codat API.

Topics

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages