GeezerVison is showing github.com — Updated on 2026-10-19 10:07:17. Version: 3.3.0 · DocSpring/docspring-php@a76ee42
File treeExpand file treeCollapse file tree Open diff view settings Some content is hiddenLarge Commits have some content hidden by default. Use the searchbox below for content that may be hidden. Dismiss bannerExpand file treeCollapse file tree Open diff view settings Collapse file Copy file name to clipboardExpand all lines: .openapi-generator/FILES +3Lines changed: 3 additions & 0 deletions | Original file line number | Diff line number | Diff line change |
|---|
@@ -28,6 +28,7 @@ docs/Model/CustomFile.md | 28 | 28 | docs/Model/ErrorOrMultipleErrorsResponse.md | 29 | 29 | docs/Model/ErrorResponse.md | 30 | 30 | docs/Model/Folder.md | | 31 | +docs/Model/ForbiddenErrorResponse.md | 31 | 32 | docs/Model/JsonSchema.md | 32 | 33 | docs/Model/ListSubmissionsResponse.md | 33 | 34 | docs/Model/MoveFolderData.md | @@ -91,6 +92,7 @@ lib/Model/CustomFile.php | 91 | 92 | lib/Model/ErrorOrMultipleErrorsResponse.php | 92 | 93 | lib/Model/ErrorResponse.php | 93 | 94 | lib/Model/Folder.php | | 95 | +lib/Model/ForbiddenErrorResponse.php | 94 | 96 | lib/Model/JsonSchema.php | 95 | 97 | lib/Model/ListSubmissionsResponse.php | 96 | 98 | lib/Model/ModelInterface.php | @@ -152,6 +154,7 @@ test/Model/CustomFileTest.php | 152 | 154 | test/Model/ErrorOrMultipleErrorsResponseTest.php | 153 | 155 | test/Model/ErrorResponseTest.php | 154 | 156 | test/Model/FolderTest.php | | 157 | +test/Model/ForbiddenErrorResponseTest.php | 155 | 158 | test/Model/JsonSchemaTest.php | 156 | 159 | test/Model/ListSubmissionsResponseTest.php | 157 | 160 | test/Model/MoveFolderDataTest.php | |
Collapse file Copy file name to clipboardExpand all lines: CHANGELOG.md +11Lines changed: 11 additions & 0 deletions - Display the source diff
- Display the rich diff
| Original file line number | Diff line number | Diff line change |
|---|
| | 1 | +### 3.3.0 [October 18, 2026] | | 2 | + | | 3 | +- Submissions and combined submissions can be in the new `insufficient_credits` state: a live PDF that your credit | | 4 | + balance can't cover is saved and processed once you add credits. See | | 5 | + https://docspring.com/docs/api-guide/credits-and-rate-limits/. | | 6 | +- generate_pdf, batch_generate_pdfs and combine_pdfs document the 402 response for insufficient credits. Their | | 7 | + responses can include a `code`, which is `insufficient_credits` on a 402. | | 8 | +- generate_pdf, batch_generate_pdfs, create_pdf_template, create_pdf_template_from_upload, create_html_template and | | 9 | + copy_template document a 403 response with a `code` of `upgrade_required` (the plan doesn't include it) or | | 10 | + `account_suspended`. | | 11 | + | 1 | 12 | ### 3.2.0 [October 18, 2026] | 2 | 13 |
| 3 | 14 | - Templates: new `parse_dates_using_template_date_format` setting, when you create or update a template. When it's | |
Collapse file Copy file name to clipboardExpand all lines: README.md +1-1Lines changed: 1 addition & 1 deletion - Display the source diff
- Display the rich diff
| Original file line number | Diff line number | Diff line change |
|---|
@@ -6,7 +6,7 @@ templates with your data, generates PDFs from HTML templates, combines PDFs and | 6 | 6 | [Documentation](https://docspring.com/docs/) · [API reference](https://docspring.com/docs/api/) · | 7 | 7 | [Packagist](https://packagist.org/packages/docspring/docspring) · [Changelog](https://github.com/DocSpring/docspring-php/blob/main/CHANGELOG.md) | 8 | 8 |
| 9 | | -Version 3.2.0. Requires PHP ^8.1. | | 9 | +Version 3.3.0. Requires PHP ^8.1. | 10 | 10 |
| 11 | 11 | ## Install and configure | 12 | 12 |
| |
Collapse file Copy file name to clipboardExpand all lines: composer.json +2-2Lines changed: 2 additions & 2 deletions | Original file line number | Diff line number | Diff line change |
|---|
| 1 | 1 | { | 2 | 2 | "name": "docspring/docspring", | 3 | | - "version": "3.2.0", | 4 | | - "description": "Use DocSpring's API to programmatically fill out PDF forms, convert HTML to PDFs, merge PDFs, or request legally binding e-signatures.", | | 3 | + "version": "3.3.0", | | 4 | + "description": "Use DocSpring's API to programmatically fill out PDF forms, convert HTML to PDFs, merge PDFs, or request legally binding e-signatures. Requests are rate limited per account, and live PDFs use credits: a request over the limit returns 429 with a Retry-After header, and one your credits can't cover returns 402. See [Credits & Rate Limits](https://docspring.com/docs/api-guide/credits-and-rate-limits/).", | 5 | 5 | "keywords": [ | 6 | 6 | "openapitools", | 7 | 7 | "openapi-generator", | |
Collapse file Copy file name to clipboardExpand all lines: composer.lock +15-15Lines changed: 15 additions & 15 deletions Collapse file Copy file name to clipboardExpand all lines: docs/Api/Client.md +6-6Lines changed: 6 additions & 6 deletions - Display the source diff
- Display the rich diff
| Original file line number | Diff line number | Diff line change |
|---|
@@ -124,7 +124,7 @@ batchGeneratePdfs($data, $wait): \DocSpring\Model\BatchGeneratePdfs201Response | 124 | 124 |
| 125 | 125 | Generate multiple PDFs | 126 | 126 |
| 127 | | -Generates up to 50 PDFs in a single request. Each submission can use a different template and data. Supports both synchronous (wait for all PDFs) and asynchronous processing. More efficient than individual requests when creating multiple PDFs. See also: - [Batch Generate PDFs](https://docspring.com/docs/api-guide/generate-pdfs/batch-generate-pdfs/) - Request format, responses, and limits | | 127 | +Generates up to 50 PDFs in a single request. Each submission can use a different template and data. Supports both synchronous (wait for all PDFs) and asynchronous processing. More efficient than individual requests when creating multiple PDFs. Live PDFs use credits. If any live submission is waiting for credits, the API returns 402 and the others are still processed: check each submission's `state`. See [Credits & Rate Limits](https://docspring.com/docs/api-guide/credits-and-rate-limits/). See also: - [Batch Generate PDFs](https://docspring.com/docs/api-guide/generate-pdfs/batch-generate-pdfs/) - Request format, responses, and limits | 128 | 128 |
| 129 | 129 | ### Example | 130 | 130 |
| @@ -188,7 +188,7 @@ combinePdfs($data): \DocSpring\Model\CreateCombinedSubmissionResponse | 188 | 188 |
| 189 | 189 | Merge submission PDFs, template PDFs, or custom files | 190 | 190 |
| 191 | | -Combines multiple PDFs from various sources into a single PDF file. Supports merging submission PDFs, template PDFs, custom files, other merged PDFs, and PDFs from URLs. Merges the PDFs in the order provided. | | 191 | +Combines multiple PDFs from various sources into a single PDF file. Supports merging submission PDFs, template PDFs, custom files, other merged PDFs, and PDFs from URLs. Merges the PDFs in the order provided. Combining uses credits (4 per source PDF, plus 4 per unit of the combined PDF), even with a test API token or watermarked source PDFs. If your balance can't cover it, the API returns 402 and the combined submission waits in the `insufficient_credits` state until you add credits. See [Credits & Rate Limits](https://docspring.com/docs/api-guide/credits-and-rate-limits/). | 192 | 192 |
| 193 | 193 | ### Example | 194 | 194 |
| @@ -1134,7 +1134,7 @@ generatePdf($template_id, $submission, $wait): \DocSpring\Model\CreateSubmission | 1134 | 1134 |
| 1135 | 1135 | Generate a PDF | 1136 | 1136 |
| 1137 | | -Creates a PDF submission by filling in a template with data. Supports both synchronous (default) and asynchronous processing. Add the `wait=false` query parameter to return immediately. See also: - [Customize the PDF Title and Filename](https://docspring.com/docs/api-guide/generate-pdfs/customize-pdf-title-and-filename/) - Set custom metadata - [Handling Truncated Text](https://docspring.com/docs/api-guide/generate-pdfs/handle-truncated-text/) - Handle text that doesn't fit in fields | | 1137 | +Creates a PDF submission by filling in a template with data. Supports both synchronous (default) and asynchronous processing. Add the `wait=false` query parameter to return immediately. Live PDFs use credits; test PDFs (`test: true`) are free and watermarked. If your balance can't cover a live PDF, the API returns 402 and the submission waits in the `insufficient_credits` state until you add credits. See [Credits & Rate Limits](https://docspring.com/docs/api-guide/credits-and-rate-limits/). See also: - [Customize the PDF Title and Filename](https://docspring.com/docs/api-guide/generate-pdfs/customize-pdf-title-and-filename/) - Set custom metadata - [Handling Truncated Text](https://docspring.com/docs/api-guide/generate-pdfs/handle-truncated-text/) - Handle text that doesn't fit in fields | 1138 | 1138 |
| 1139 | 1139 | ### Example | 1140 | 1140 |
| @@ -1262,7 +1262,7 @@ getCombinedSubmission($combined_submission_id): \DocSpring\Model\CombinedSubmiss | 1262 | 1262 |
| 1263 | 1263 | Check the status of a combined submission (merged PDFs) | 1264 | 1264 |
| 1265 | | -Retrieves the details and status of a combined submission. Returns processing state, download URL (if processed), metadata, and information about any integrated actions (e.g., S3 uploads). | | 1265 | +Retrieves the details and status of a combined submission. Returns processing state, download URL (if processed), metadata, and information about any integrated actions (e.g., S3 uploads). `insufficient_credits` means the combined submission is waiting for credits and is processed once you add them. If it's still waiting after 30 days, it moves to `error`. | 1266 | 1266 |
| 1267 | 1267 | ### Example | 1268 | 1268 |
| @@ -1507,7 +1507,7 @@ getSubmission($submission_id, $include_data): \DocSpring\Model\Submission | 1507 | 1507 |
| 1508 | 1508 | Check the status of a PDF | 1509 | 1509 |
| 1510 | | -Retrieves the details and status of a PDF submission. Returns processing state, download URL (if processed), metadata, submission data (optional), and information about any integrated actions. Use this to poll for completion when using asynchronous processing. | | 1510 | +Retrieves the details and status of a PDF submission. Returns processing state, download URL (if processed), metadata, submission data (optional), and information about any integrated actions. Use this to poll for completion when using asynchronous processing. `insufficient_credits` means the submission is waiting for credits and is processed once you add them. If it's still waiting after 30 days, it moves to `error`. | 1511 | 1511 |
| 1512 | 1512 | ### Example | 1513 | 1513 |
| @@ -1571,7 +1571,7 @@ getSubmissionBatch($submission_batch_id, $include_submissions): \DocSpring\Model | 1571 | 1571 |
| 1572 | 1572 | Check the status of a submission batch job | 1573 | 1573 |
| 1574 | | -Retrieves the status and results of a batch PDF generation job. Returns processing state, completion statistics, and optionally includes all individual submission details. Use this to poll for completion when using asynchronous batch processing. | | 1574 | +Retrieves the status and results of a batch PDF generation job. Returns processing state, completion statistics, and optionally includes all individual submission details. Use this to poll for completion when using asynchronous batch processing. Submissions waiting for credits are in the `insufficient_credits` state and count as pending, so the batch stays `pending` until you add credits or they stop waiting after 30 days. | 1575 | 1575 |
| 1576 | 1576 | ### Example | 1577 | 1577 |
| |
Collapse file Copy file name to clipboardExpand all lines: docs/Model/BatchGeneratePdfs201Response.md +1Lines changed: 1 addition & 0 deletions - Display the source diff
- Display the rich diff
| Original file line number | Diff line number | Diff line change |
|---|
@@ -9,5 +9,6 @@ Name | Type | Description | Notes | 9 | 9 | **errors** | **string[]** | | [optional] | 10 | 10 | **submission_batch** | [**\DocSpring\Model\SubmissionBatch**](SubmissionBatch.md) | | | 11 | 11 | **submissions** | **object[]** | | | | 12 | +**code** | **string** | `insufficient_credits` when the response is a 402. | [optional] | 12 | 13 |
| 13 | 14 | [[Back to Model list]](../../README.md#models) [[Back to API list]](../../README.md#endpoints) [[Back to README]](../../README.md) |
Collapse file Copy file name to clipboardExpand all lines: docs/Model/CombinePdfsData.md +1-1Lines changed: 1 addition & 1 deletion - Display the source diff
- Display the rich diff
| Original file line number | Diff line number | Diff line change |
|---|
@@ -9,6 +9,6 @@ Name | Type | Description | Notes | 9 | 9 | **metadata** | **object** | | [optional] | 10 | 10 | **password** | **string** | | [optional] | 11 | 11 | **source_pdfs** | **object[]** | | | 12 | | -**test** | **bool** | Deprecated, and has no effect. A combined PDF is a test or live document because of its source PDFs. | [optional] | | 12 | +**test** | **bool** | Deprecated, and has no effect. Combining always uses credits, even with a test API token or watermarked source PDFs. | [optional] | 13 | 13 |
| 14 | 14 | [[Back to Model list]](../../README.md#models) [[Back to API list]](../../README.md#endpoints) [[Back to README]](../../README.md) |
Collapse file Copy file name to clipboardExpand all lines: docs/Model/CreateCombinedSubmissionResponse.md +2Lines changed: 2 additions & 0 deletions - Display the source diff
- Display the rich diff
| Original file line number | Diff line number | Diff line change |
|---|
@@ -6,6 +6,8 @@ Name | Type | Description | Notes | 6 | 6 | ------------ | ------------- | ------------- | ------------- | 7 | 7 | **status** | **string** | | | 8 | 8 | **combined_submission** | [**\DocSpring\Model\CombinedSubmission**](CombinedSubmission.md) | | | | 9 | +**error** | **string** | | [optional] | 9 | 10 | **errors** | **string[]** | | [optional] | | 11 | +**code** | **string** | `insufficient_credits` when the response is a 402. | [optional] | 10 | 12 |
| 11 | 13 | [[Back to Model list]](../../README.md#models) [[Back to API list]](../../README.md#endpoints) [[Back to README]](../../README.md) |
Collapse file Copy file name to clipboardExpand all lines: docs/Model/CreateCustomFileResponse.md +1Lines changed: 1 addition & 0 deletions - Display the source diff
- Display the rich diff
| Original file line number | Diff line number | Diff line change |
|---|
@@ -6,6 +6,7 @@ Name | Type | Description | Notes | 6 | 6 | ------------ | ------------- | ------------- | ------------- | 7 | 7 | **status** | **string** | | | 8 | 8 | **custom_file** | [**\DocSpring\Model\CustomFile**](CustomFile.md) | | | | 9 | +**error** | **string** | | [optional] | 9 | 10 | **errors** | **string[]** | | [optional] | 10 | 11 |
| 11 | 12 | [[Back to Model list]](../../README.md#models) [[Back to API list]](../../README.md#endpoints) [[Back to README]](../../README.md) |
|