Articles in this section
Category / Section

Resolving locale mismatch errors in BoldSign eSignature API

Published:
2 mins read

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

  1. 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.

  2. Modify API Call: Update your API call to include the correct locale settings for both the Signers and the DocumentInfo. 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'
    
  3. 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.

Was this article useful?
Like
Dislike
Help us improve this page
Please provide feedback or comments
Access denied
Access denied