Skip to main content

Overview

Legale is an E-Signing platform to provide the possibility to sign all types of documents digitally.
We provide the REST API to help customers to integrate legale service into their own.
Legale is now developing this API section to satisfy specific customers' requirements, flexible integration and application.
If you need to build and customize any API to approach the specific requirements of your service, you can contact with Legale support, we will provide you a wonderful services.

Environment​

Legale provides two API environments:

EnvironmentBase API URLBase Media URLPurpose
Productionhttps://api.legale.io/api/customhttps://api.legale.io/mediaLive traffic. Real signatures and documents.
Test / Sandboxhttps://dev.api.legale.io/api/customhttps://dev.api.legale.io/mediaSafe for development, QA, and automated tests. No legal effect. Data may be reset without notice.

Example​

url: {{BASE_URL}}/token

Authentication​

Legale Custom API uses the same authentication logic as V1 & V2 .

1. Bearer Token​

You can use JWT token to authorize your API request.
You should have an legale account to integrate API, so that you can get JWT token to use in every API request.
You can see more details over here.

Example​

{
Authorization: `Bearer {{token}}`,
// Other header options
}

2. API Key​

You can use API Key to authorize your API request.
You should have an legale account with admin role to integrate API, so that you can generate API Key from here.

Example​

{
Legale-Api-Key: `{{api_key}}`,
// Other header options
}

Language​

You have a possibility to specified your language in API response.
You can pass the language code in API request header params.
You will receive the response error messages in that language.
Available language codes are en, es, pt.

Example​

{
"Accept-Language": "en",
// Other header options
}

Postman example​

You can download the postman example from here.
Please make sure to create Postman Environment and set the variable named BASE_URL = https://api.legale.io/api/custom.