Skip to content
DocSpring Documentation

Java API Client

New versions of the DocSpring Java API client. To install it, see Install an API Client. You can also get these release notes by email.

Changelog

Section titled “Changelog”

3.3.0

Section titled “3.3.0”
Released on Oct 18, 2026
  • Submissions and combined submissions can be in the new insufficient_credits state: a live PDF that your credit balance can’t cover is saved and processed once you add credits. See https://docspring.com/docs/api-guide/credits-and-rate-limits/.
  • generate_pdf, batch_generate_pdfs and combine_pdfs document the 402 response for insufficient credits. Their responses can include a code, which is insufficient_credits on a 402.
  • generate_pdf, batch_generate_pdfs, create_pdf_template, create_pdf_template_from_upload, create_html_template and copy_template document a 403 response with a code of upgrade_required (the plan doesn’t include it) or account_suspended.

3.2.0

Section titled “3.2.0”
Released on Oct 18, 2026
  • Response models keep fields this version doesn’t know: read them with getAdditionalProperties().
  • In an enum that can be null (such as a webhook’s mode), a value this version doesn’t know now reads as UNKNOWN_DEFAULT_OPEN_API instead of null.
  • Templates: new parse_dates_using_template_date_format setting, when you create or update a template. When it’s true, date values sent as NN/NN/YYYY (with slashes, dashes or dots) are read in the order of the template’s default date format: month first for %m/%d/%Y, day first for %d/%m/%Y. When it’s false, they’re read day first.
  • A new README: installing, a quick start, every API method, errors, and how API changes are handled. The repository also has an AGENTS.md for coding agents.

3.1.0

Section titled “3.1.0”
Released on Oct 15, 2026
  • Submissions and data requests can now be in the declined state, when a signer declines to sign. Data requests have a new declined_at timestamp. Earlier versions raise an error when they read a declined submission or data request.
  • New API methods for webhooks: create_webhook, list_webhooks, get_webhook, update_webhook and delete_webhook.
  • New API method: get_template_model_code, which generates typed model code for a template’s submission data, so your app can catch mistakes before it calls the API.
  • Templates:
    • Field dependencies: field_dependencies when you create or update a template, and dependencies on the fields you add with add_fields_to_template.
    • add_fields_to_template accepts the initials field type and an editable setting for each field.
    • Embedded template editor settings: embed_edit_allow_document_replacement, embed_edit_allow_settings, embed_edit_allow_versioning and embed_edit_token.
    • New template_schema_version attribute.
    • A template’s path is never null.
    • Individual template defaults can be null (for example fontSize after it’s cleared in the template editor).
    • last_changed_by_type can be external_user (a change made in the embedded template editor), with last_changed_by_external_id, last_changed_by_external_name and last_changed_by_external_email.
    • Template versions say who published them with published_by_type, published_by_user_id, published_by_name, published_by_email and published_by_external_id. These replace published_by_id, which the API no longer returns.
    • The JSON schema from get_template_schema includes $id, allOf and dependencies.
  • copy_template accepts a template version, and parent_folder_id is now optional. move_template_to_folder also accepts a version.
  • Pass a null parent_folder_id to move_template_to_folder or move_folder_to_folder to move it to the root folder.
  • Submissions and submission actions include an error_message when processing fails.
  • combine_pdfs: delete_custom_files now deletes the custom files once the merged PDF is processed (it used to be ignored). test has no effect and is deprecated.
  • new Client() reads DOCSPRING_TOKEN_ID, DOCSPRING_TOKEN_SECRET, DOCSPRING_HOST and DOCSPRING_REGION (US or EU) from the environment, for any credentials or host not already set on the default ApiClient. New constructors: Client(apiTokenId, apiTokenSecret) and Client(apiTokenId, apiTokenSecret, host, region).
  • An enum value added to the API after this release (e.g. a new submission state) deserializes as UNKNOWN_DEFAULT_OPEN_API instead of throwing, or as null for an attribute that can be null. Enums have the new UNKNOWN_DEFAULT_OPEN_API constant, so an exhaustive switch over one needs a case for it.
  • source, referrer and data are optional on submissions, because get_submission, list_submissions and list_template_submissions only return them with include_data. getSource() is now @Nullable.

3.0.1

Section titled “3.0.1”
Released on Sep 24, 2025
  • Accidentally had a hard-coded 2.x version in the user agent string for v3.0.0

3.0.0

Section titled “3.0.0”
Released on Sep 24, 2025
  • All our API clients are now 100% end-to-end tested against our real server.

2.1.0

Section titled “2.1.0”
Released on Mar 22, 2025
  • Added support for Template Versioning parameters:
    • Optional version parameter in submission requests (e.g., 1.2.3, draft, latest)
    • New API methods: publish_template_version, restore_template_version
    • Updated copy_template and delete_template methods to accept template version strings

2.0.0

Section titled “2.0.0”
Released on Feb 23, 2025
  • BREAKING CHANGE: Updated default host to our new synchronous API subdomain: sync.api.docspring.com. (EU customers should use sync.api-eu.docspring.com). Removed all custom polling code from library since this logic is now handled by the API service running on our sync subdomain
  • Fixed User-Agent header: docspring-java-x.x.x

1.3.2

Section titled “1.3.2”
Released on Nov 28, 2021
  • Added ‘password’ parameter to Generate PDF and Combine PDF API endpoints. You can now encrypt each generated PDF with a unique password.

1.3.1

Section titled “1.3.1”
Released on Nov 19, 2020
  • Added “sort_order” property for Submission Data Requests

1.3.0

Section titled “1.3.0”
Released on Sep 26, 2020
  • Updated OpenAPI Generator to v3.3.0.
  • Fixed MultipartBody.Part annotation issue for createPDFTemplate. Added Java code example to docs.

1.2.1

Section titled “1.2.1”
Released on Sep 24, 2020
  • Fixed the “include_data=true” option for the “Get Submission” API endpoint. Added the “data” property to the Submission model so that this is parsed and returned correctly when requested

1.2.0

Section titled “1.2.0”
Released on Sep 21, 2020
  • Renamed some internal models for template creation API endpoints. (CreateTemplateData / CreateTemplateData1 renamed to CreateHtmlTemplateData and CreateTemplateFromUploadData)

1.1.0

Section titled “1.1.0”
Released on Sep 12, 2020
  • BREAKING CHANGE: Renamed createTemplate operation to createPDFTemplate
  • Added createHTMLTemplate operation. (This uses the same API endpoint as createPDFTemplate, but the example shows how to set html, scss, etc. fields)
  • Added updateTemplate operation, to update a PDF or HTML template

1.0.0

Section titled “1.0.0”
Released on May 20, 2019
  • Renamed FormAPI to DocSpring. (View the CHANGELOG in the original FormAPI API client for prior releases.)