GV

GeezerVison

The World Wide Web, restored to 800 pixels of glory.

Home|About|Gaming cabinet|Archives|How it works|Starter sites

On this site

  • Sign in
  • ActionsCI/CD and automation
  • CodespacesCloud development environments
  • All Features
  • Documentation
  • Training
  • Certifications
  • Build with Copilot
  • Customize Copilot
  • Integrations
  • Trending repos
  • GitHub Sponsors
  • Developer articles
  • Enterprises

This view

  • Original page
  • New address

GeezerVison is showing github.com — Updated on 2026-10-19 10:07:17. Version: 3.3.0 · DocSpring/docspring-php@a76ee42

File tree

Expand file treeCollapse file tree
Open diff view settings
Filter options
  • .openapi-generator
    • FILES
  • CHANGELOG.md
  • README.md
  • composer.json
  • composer.lock
  • docs
    • Api
      • Client.md
    • Model
      • BatchGeneratePdfs201Response.md
      • CombinePdfsData.md
      • CreateCombinedSubmissionResponse.md
      • CreateCustomFileResponse.md
      • CreatePdfSubmissionData.md
      • CreateSubmissionDataRequestEventResponse.md
      • CreateSubmissionDataRequestResponse.md
      • CreateSubmissionDataRequestTokenResponse.md
      • CreateSubmissionResponse.md
      • ForbiddenErrorResponse.md
      • SubmissionBatchData.md
  • lib
    • ApiException.php
    • Api
      • Client.php
    • Configuration.php
    • FormDataProcessor.php
    • HeaderSelector.php
    • Model
      • AddFieldsData.php
      • BatchGeneratePdfs201Response.php
      • CombinePdfsData.php
      • CombinedSubmission.php
      • CombinedSubmissionAction.php
      • CopyTemplateOptions.php
      • CreateCombinedSubmissionResponse.php
      • CreateCustomFileData.php
      • CreateCustomFileResponse.php
      • CreateFolderData.php
      • CreateHtmlTemplate.php
      • CreatePdfSubmissionData.php
      • CreatePdfTemplate.php
      • CreateSubmissionDataRequestData.php
      • CreateSubmissionDataRequestEventRequest.php
      • CreateSubmissionDataRequestEventResponse.php
      • CreateSubmissionDataRequestResponse.php
      • CreateSubmissionDataRequestTokenResponse.php
      • CreateSubmissionResponse.php
      • CreateWebhookData.php
      • CustomFile.php
      • ErrorOrMultipleErrorsResponse.php
      • ErrorResponse.php
      • Folder.php
      • ForbiddenErrorResponse.php
      • JsonSchema.php
      • ListSubmissionsResponse.php
      • ModelInterface.php
      • MoveFolderData.php
      • MoveTemplateData.php
      • MultipleErrorsResponse.php
      • PublishVersionData.php
      • RenameFolderData.php
      • RestoreVersionData.php
      • Submission.php
      • Submission422Response.php
      • SubmissionAction.php
      • SubmissionBatch.php
      • SubmissionBatchData.php
      • SubmissionBatchWithSubmissions.php
      • SubmissionDataRequest.php
      • SubmissionDataRequestEvent.php
      • SubmissionDataRequestShow.php
      • SubmissionDataRequestToken.php
      • SubmissionPreview.php
      • SuccessErrorResponse.php
      • SuccessMultipleErrorsResponse.php
      • Template.php
      • TemplateAddFieldsResponse.php
      • TemplateDeleteResponse.php
      • TemplateModelCodeResponse.php
      • TemplatePreview.php
      • TemplatePublishVersionResponse.php
      • UpdateHtmlTemplate.php
      • UpdatePdfTemplate.php
      • UpdateSubmissionDataRequestData.php
      • UpdateWebhookData.php
      • UploadPresignResponse.php
      • Webhook.php
    • ObjectSerializer.php
  • test
    • Api
      • ClientTest.php
    • Model
      • AddFieldsDataTest.php
      • BatchGeneratePdfs201ResponseTest.php
      • CombinePdfsDataTest.php
      • CombinedSubmissionActionTest.php
      • CombinedSubmissionTest.php
      • CopyTemplateOptionsTest.php
      • CreateCombinedSubmissionResponseTest.php
      • CreateCustomFileDataTest.php
      • CreateCustomFileResponseTest.php
      • CreateFolderDataTest.php
      • CreateHtmlTemplateTest.php
      • CreatePdfSubmissionDataTest.php
      • CreatePdfTemplateTest.php
      • CreateSubmissionDataRequestDataTest.php
      • CreateSubmissionDataRequestEventRequestTest.php
      • CreateSubmissionDataRequestEventResponseTest.php
      • CreateSubmissionDataRequestResponseTest.php
      • CreateSubmissionDataRequestTokenResponseTest.php
      • CreateSubmissionResponseTest.php
      • CreateWebhookDataTest.php
      • CustomFileTest.php
      • ErrorOrMultipleErrorsResponseTest.php
      • ErrorResponseTest.php
      • FolderTest.php
      • ForbiddenErrorResponseTest.php
      • JsonSchemaTest.php
      • ListSubmissionsResponseTest.php
      • MoveFolderDataTest.php
      • MoveTemplateDataTest.php
      • MultipleErrorsResponseTest.php
      • PublishVersionDataTest.php
      • RenameFolderDataTest.php
      • RestoreVersionDataTest.php
      • Submission422ResponseTest.php
      • SubmissionActionTest.php
      • SubmissionBatchDataTest.php
      • SubmissionBatchTest.php
      • SubmissionBatchWithSubmissionsTest.php
      • SubmissionDataRequestEventTest.php
      • SubmissionDataRequestShowTest.php
      • SubmissionDataRequestTest.php
      • SubmissionDataRequestTokenTest.php
      • SubmissionPreviewTest.php
      • SubmissionTest.php
      • SuccessErrorResponseTest.php
      • SuccessMultipleErrorsResponseTest.php
      • TemplateAddFieldsResponseTest.php
      • TemplateDeleteResponseTest.php
      • TemplateModelCodeResponseTest.php
      • TemplatePreviewTest.php
      • TemplatePublishVersionResponseTest.php
      • TemplateTest.php
      • UpdateHtmlTemplateTest.php
      • UpdatePdfTemplateTest.php
      • UpdateSubmissionDataRequestDataTest.php
      • UpdateWebhookDataTest.php
      • UploadPresignResponseTest.php
      • WebhookTest.php

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.
Dismiss banner
Expand file treeCollapse file tree
Open diff view settings
Collapse file

‎.openapi-generator/FILES‎

Copy file name to clipboardExpand all lines: .openapi-generator/FILES
+3Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -28,6 +28,7 @@ docs/Model/CustomFile.md
2828
docs/Model/ErrorOrMultipleErrorsResponse.md
2929
docs/Model/ErrorResponse.md
3030
docs/Model/Folder.md
31+
docs/Model/ForbiddenErrorResponse.md
3132
docs/Model/JsonSchema.md
3233
docs/Model/ListSubmissionsResponse.md
3334
docs/Model/MoveFolderData.md
@@ -91,6 +92,7 @@ lib/Model/CustomFile.php
9192
lib/Model/ErrorOrMultipleErrorsResponse.php
9293
lib/Model/ErrorResponse.php
9394
lib/Model/Folder.php
95+
lib/Model/ForbiddenErrorResponse.php
9496
lib/Model/JsonSchema.php
9597
lib/Model/ListSubmissionsResponse.php
9698
lib/Model/ModelInterface.php
@@ -152,6 +154,7 @@ test/Model/CustomFileTest.php
152154
test/Model/ErrorOrMultipleErrorsResponseTest.php
153155
test/Model/ErrorResponseTest.php
154156
test/Model/FolderTest.php
157+
test/Model/ForbiddenErrorResponseTest.php
155158
test/Model/JsonSchemaTest.php
156159
test/Model/ListSubmissionsResponseTest.php
157160
test/Model/MoveFolderDataTest.php
Collapse file

‎CHANGELOG.md‎

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 numberDiff line numberDiff line change
@@ -1,3 +1,14 @@
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+
112
### 3.2.0 [October 18, 2026]
213

314
- Templates: new `parse_dates_using_template_date_format` setting, when you create or update a template. When it's
Collapse file

‎README.md‎

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 numberDiff line numberDiff line change
@@ -6,7 +6,7 @@ templates with your data, generates PDFs from HTML templates, combines PDFs and
66
[Documentation](https://docspring.com/docs/) · [API reference](https://docspring.com/docs/api/) ·
77
[Packagist](https://packagist.org/packages/docspring/docspring) · [Changelog](https://github.com/DocSpring/docspring-php/blob/main/CHANGELOG.md)
88

9-
Version 3.2.0. Requires PHP ^8.1.
9+
Version 3.3.0. Requires PHP ^8.1.
1010

1111
## Install and configure
1212

Collapse file

‎composer.json‎

Copy file name to clipboardExpand all lines: composer.json
+2-2Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
{
22
"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/).",
55
"keywords": [
66
"openapitools",
77
"openapi-generator",
Collapse file

‎composer.lock‎

Copy file name to clipboardExpand all lines: composer.lock
+15-15Lines changed: 15 additions & 15 deletions
Some generated files are not rendered by default. Learn more about customizing how changed files appear on GitHub.
Collapse file

‎docs/Api/Client.md‎

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 numberDiff line numberDiff line change
@@ -124,7 +124,7 @@ batchGeneratePdfs($data, $wait): \DocSpring\Model\BatchGeneratePdfs201Response
124124

125125
Generate multiple PDFs
126126

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
128128

129129
### Example
130130

@@ -188,7 +188,7 @@ combinePdfs($data): \DocSpring\Model\CreateCombinedSubmissionResponse
188188

189189
Merge submission PDFs, template PDFs, or custom files
190190

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/).
192192

193193
### Example
194194

@@ -1134,7 +1134,7 @@ generatePdf($template_id, $submission, $wait): \DocSpring\Model\CreateSubmission
11341134

11351135
Generate a PDF
11361136

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
11381138

11391139
### Example
11401140

@@ -1262,7 +1262,7 @@ getCombinedSubmission($combined_submission_id): \DocSpring\Model\CombinedSubmiss
12621262

12631263
Check the status of a combined submission (merged PDFs)
12641264

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`.
12661266

12671267
### Example
12681268

@@ -1507,7 +1507,7 @@ getSubmission($submission_id, $include_data): \DocSpring\Model\Submission
15071507

15081508
Check the status of a PDF
15091509

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`.
15111511

15121512
### Example
15131513

@@ -1571,7 +1571,7 @@ getSubmissionBatch($submission_batch_id, $include_submissions): \DocSpring\Model
15711571

15721572
Check the status of a submission batch job
15731573

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

15761576
### Example
15771577

Collapse file

‎docs/Model/BatchGeneratePdfs201Response.md‎

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 numberDiff line numberDiff line change
@@ -9,5 +9,6 @@ Name | Type | Description | Notes
99
**errors** | **string[]** | | [optional]
1010
**submission_batch** | [**\DocSpring\Model\SubmissionBatch**](SubmissionBatch.md) | |
1111
**submissions** | **object[]** | |
12+
**code** | **string** | `insufficient_credits` when the response is a 402. | [optional]
1213

1314
[[Back to Model list]](../../README.md#models) [[Back to API list]](../../README.md#endpoints) [[Back to README]](../../README.md)
Collapse file

‎docs/Model/CombinePdfsData.md‎

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 numberDiff line numberDiff line change
@@ -9,6 +9,6 @@ Name | Type | Description | Notes
99
**metadata** | **object** | | [optional]
1010
**password** | **string** | | [optional]
1111
**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]
1313

1414
[[Back to Model list]](../../README.md#models) [[Back to API list]](../../README.md#endpoints) [[Back to README]](../../README.md)
Collapse file

‎docs/Model/CreateCombinedSubmissionResponse.md‎

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 numberDiff line numberDiff line change
@@ -6,6 +6,8 @@ Name | Type | Description | Notes
66
------------ | ------------- | ------------- | -------------
77
**status** | **string** | |
88
**combined_submission** | [**\DocSpring\Model\CombinedSubmission**](CombinedSubmission.md) | |
9+
**error** | **string** | | [optional]
910
**errors** | **string[]** | | [optional]
11+
**code** | **string** | `insufficient_credits` when the response is a 402. | [optional]
1012

1113
[[Back to Model list]](../../README.md#models) [[Back to API list]](../../README.md#endpoints) [[Back to README]](../../README.md)
Collapse file

‎docs/Model/CreateCustomFileResponse.md‎

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 numberDiff line numberDiff line change
@@ -6,6 +6,7 @@ Name | Type | Description | Notes
66
------------ | ------------- | ------------- | -------------
77
**status** | **string** | |
88
**custom_file** | [**\DocSpring\Model\CustomFile**](CustomFile.md) | |
9+
**error** | **string** | | [optional]
910
**errors** | **string[]** | | [optional]
1011

1112
[[Back to Model list]](../../README.md#models) [[Back to API list]](../../README.md#endpoints) [[Back to README]](../../README.md)

0 commit comments

Comments
0 (0)
You are visitor 01402520 — GeezerVison does not store the pages you look up.
Best viewed with Netscape Navigator 4.7 or Internet Explorer 6 at 800×600. No cookies required.