Retrieve Workflow Batch Information

Retrieves information about a batch of workflows

Endpoint URLSDK Method
https://api.inkit.com/v1/invoke/batch/{batchId}N/A

Request properties

PropertyTypeRequiredDescription
batchIdStringYesThe ID of a batch that was previously launched.

Response properties

PropertyTypeDescription
created_atStringThe date and time the batch was created.
destinationsObjectThe status of document generations within the batch.
idStringThe ID of the batch.
nameStringThe name of the batch.
statusStringThe batch creation status.
totalIntegerThe number of documents in the batch.

destinations

PropertyTypeDescription
inkit_storageObjectThe status of Inkit Storage document generations within the batch.
salesforceObjectThe status of Salesforce document generations within the batch.
sepireObjectThe status of Sepire document generations within the batch.
docusignObjectThe status of DocuSign document generations within the batch.
magic_linkObjectThe status of Magic Link document generations within the batch.
amazon_s3ObjectThe status of Amazon S3 document generations within the batch.
google_driveObjectThe status of Google Drive document generations within the batch.
dropboxObjectThe status of Dropbox document generations within the batch.
boxObjectThe status of Box document generations within the batch.

[destination]

PropertyTypeDescription
countIntegerThe total number of document generations within the batch for this destination.
completedIntegerThe total number of completed document generations within the batch for this destination.
failedIntegerThe total number of failed document generations within the batch for this destination.
in_progressIntegerThe total number of in-progress document generations within the batch for this destination.

Example request and response

curl --request GET \
     --url https://api.inkit.com/v1/invoke/batch/fb_4AO6oyjh5yc9jvRKJplghb \
     --header 'X-Inkit-API-Token: ENTER YOUR API KEY' \
     --header 'accept: application/json'
{
	"created_at": "2023-11-07T02:16:22.319388Z",
	"destinations": {
		"inkit_storage": {
			"completed": 1,
			"count": 1,
			"failed": 0,
			"in_progress": 0,
			"status": "completed"
		}
	},
	"id": "fb_4AO6oyjh5yc9jvRKJplghb",
	"name": "Batch Name",
	"status": "Completed",
	"total": 1
}