Resolving locale mismatch errors in BoldSign eSignature API
When using the BoldSign API to send documents for eSignature, it’s important to ensure that the locale settings for both the Signers
and the DocumentInfo
are correctly set and consistent. This article addresses a common error where the locale set for a signer does not match the locale specified in the DocumentInfo
, resulting in a validation error.
Error Description
The error typically appears as follows:
{
"errors": {
"DocumentInfo": [
"Signer has chosen another locale."
]
},
"type": "https://tools.ietf.org/html/rfc7231#section-6.5.1",
"title": "One or more validation errors occurred.",
"status": 400,
"traceId": "00-5ba8e14059c6bb4f8d74437d8d60605b-83d672273d395a0f-00"
}
This indicates that the locale set for the signer does not match the locale specified in the DocumentInfo
.
Steps to Resolve
-
Check Locale Settings: Ensure that the locale for each signer matches the locale specified in the
DocumentInfo
. The locale must be consistent across all elements of the document configuration. -
Modify API Call: Update your API call to include the correct
locale
settings for both theSigners
and theDocumentInfo
. Here is a corrected version of the API call:curl -X 'POST' \ 'https://api.boldsign.com/v1/document/send' \ -H 'accept: application/json' \ -H 'X-API-KEY: {Your API Key}' \ -H 'Content-Type: multipart/form-data' \ -F 'Signers={ "name": "David", "emailAddress": "david@cubeflakes.com", "formFields": [ { "id": "string", "fieldType": "Signature", "pageNumber": 1, "bounds": { "x": 100, "y": 100, "width": 100, "height": 20 }, "isRequired": true } ], "locale": "IT" }' \ -F 'Files={Your file path}' \ -F 'DocumentInfo[locale]="IT"' \ -F 'Title=Signer language'
-
Documentation Reference: For further details, refer to the section on setting signer language in the official BoldSign API Documentation.
Additional Tips
- Always verify that the locales you are using are supported by BoldSign.
- If you continue to experience issues, check the API documentation for any updates regarding locale handling or contact BoldSign support for assistance.
By following these steps, you should be able to resolve the locale mismatch error and successfully send your eSignature documents using the BoldSign API.