We have launched a public API for the .legal platform, so you can connect your own systems and workflows directly to your data on legal entities, contracts and assets. Here's what's included in this first API release.
Create, retrieve, update and delete legal entities (vendors, customers, group companies and others) through the API. List and filter your existing entities, look up a specific one by its ID, and make partial updates to individual fields without having to resend the whole record.
List legal entity
Create legal entity
The same core operations are available for contracts. Create, retrieve and update them, and paginate through your contract list with filtering by business area and date. You can also replace the business areas linked to a contract in a single call, and update custom field values in bulk rather than one at a time.
Assets support the same operations as contracts, covering creation, retrieval, updates, filtering, business areas and custom fields, and add supplier management on top. You can add a supplier to an asset, look one up, or remove it again.
Two supporting endpoints round out this release. One lists your active business areas, and the other returns entity templates for contracts and assets, including their custom field schemas, so external systems know the shape of your data before sending anything.
Every endpoint is versioned through the URL, for example /api/v1/legal-entities. Within a major version, we only make additive changes: new fields, new endpoints and new enum values that your integration should be able to tolerate without breaking. If an endpoint is ever retired, it will be marked as deprecated first, with at least 12 months' notice before it's switched off.
If you'd like to start integrating with our new Public API, or want a walkthrough of what's possible, get in touch, we'd love to help you get set up.
We'd love to hear from you! Your input helps us keep improving the platform. Please don't hesitate to reach out to our support team with your thoughts, questions, or suggestions. 🚀