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.
Here we have the API documentation to explain how to use. This is API V1 and now Legale is building API V2 with better functionalities.

Environment​

Legale provides two API environments:

EnvironmentBase API URLBase Media URLPurpose
Productionhttps://api.legale.io/apihttps://api.legale.io/mediaLive traffic. Real signatures and documents.
Test / Sandboxhttps://dev.api.legale.io/apihttps://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 Rest API V1 provides two authentication options.

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.