Process a Contract
POST/api/v8/partner/contracts
Supports .zip,.pdf. Max file size is 20mb.
Request
- application/json
- multipart/form-data
Body
Possible values: >= 1
and <= 50
Default value: 50
Limit processing to number of pages. A page is a pdf page or an image
Default value: false
Delete this contract from Veryfi after data has been extracted
Possible values: non-empty
The least effective way to submit files. Base64 encoded string, could be raw or datauri https://en.wikipedia.org/wiki/Data_URI_scheme E.g. 'data:application/zip;base64,iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAQAAAC1HAwCAAAAC0lEQVQYV2NgYAAAAAMAAWgmWQ0AAAAASUVORK5CYII='
Possible values: non-empty
Possible values: non-empty
A path to file in S3 bucket, e.g. 'some/contract.pdf
Possible values: non-empty
An S3 bucket for 'package_path', e.g. 'contracts'
Possible values: non-empty
Optional filename, helps to determine file type
Body
Possible values: non-empty
The least effective way to submit files. Base64 encoded string, could be raw or datauri https://en.wikipedia.org/wiki/Data_URI_scheme E.g. 'data:application/zip;base64,iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAQAAAC1HAwCAAAAC0lEQVQYV2NgYAAAAAMAAWgmWQ0AAAAASUVORK5CYII='
Possible values: non-empty
Possible values: non-empty
An array of URLs to publicly accessible documents to be sent to Veryfi for processing.
Possible values: non-empty
A path to file in S3 bucket, e.g. 'some/contract.pdf
Possible values: non-empty
An S3 bucket for 'package_path', e.g. 'contracts'
Possible values: non-empty
Optional filename, helps to determine file type
Possible values: non-empty
A custom identification value. Use this if you would like to assign your own ID to documents. This parameter is useful when mapping this document to a service or resource outside Veryfi.
A binary file. Submitting zipped documents through this parameter is the fastest way to process any document.
Possible values: >= 1
and <= 50
Default value: 50
Limit processing to number of pages. A page is a pdf page or an image
Default value: false
Delete this contract from Veryfi after data has been extracted
Responses
- 201
- 400
- 403
- 404
- 429
- 499
- 503
- 504
- default
Processed contract response. Fields with an asterisk will be returned, others need to be enabled for your client
- application/json
- Schema
- Example (from schema)
Schema
- Array [
- ]
meta object
Possible values: non-empty
A custom identification value. Use this if you would like to assign your own ID to documents. This parameter is useful when mapping this document to a service or resource outside Veryfi.
Possible values: non-empty
and <= 2083 characters
A signed URL to access the auto-generated PDF created from the submitted document. This URL expires 15 minutes after the response object is returned and is resigned during every GET request.
The unique number created to identify the document.
The text returned from converting the document into a machine-readable text format.
contract_name objectrequired
date objectrequired
end_date objectrequired
start_date objectrequired
parties object[]required
term objectrequired
total objectrequired
renewal_term objectrequired
notice_period objectrequired
termination_for_convenience_period objectrequired
governing_law objectrequired
vanity objectrequired
termination_notice objectrequired
{
"meta": {
"external_id": "string"
},
"pdf_url": "string",
"id": 0,
"created_date": "2025-01-25T22:06:11.818Z",
"updated_date": "2025-01-25T22:06:11.818Z",
"text": "string",
"contract_name": {
"value": "string",
"begin": 0,
"end": 0,
"score": 0
},
"date": {
"value": "2025-01-25",
"begin": 0,
"end": 0,
"score": 0
},
"end_date": {
"value": "2025-01-25",
"begin": 0,
"end": 0,
"score": 0
},
"start_date": {
"value": "2025-01-25",
"begin": 0,
"end": 0,
"score": 0
},
"parties": [
{
"value": "string",
"begin": 0,
"end": 0,
"score": 0
}
],
"term": {
"value": "string",
"begin": 0,
"end": 0,
"score": 0
},
"total": {
"value": 0,
"begin": 0,
"end": 0,
"score": 0
},
"renewal_term": {
"value": "string",
"begin": 0,
"end": 0,
"score": 0
},
"notice_period": {
"value": "string",
"begin": 0,
"end": 0,
"score": 0
},
"termination_for_convenience_period": {
"value": "string",
"begin": 0,
"end": 0,
"score": 0
},
"governing_law": {
"value": "string",
"begin": 0,
"end": 0,
"score": 0
},
"vanity": {
"value": "string",
"begin": 0,
"end": 0,
"score": 0
},
"termination_notice": {
"value": "string",
"begin": 0,
"end": 0,
"score": 0
}
}
User error
- application/json
- Schema
- Example (from schema)
Schema
- FAILED_TO_PROCESS_DOCUMENTS
- FAILED_TO_EXTRACT
Default value: fail
Default value: Failed to process documents
Default value: fail
Default value: Failed to extract
{}
User error
- application/json
- Schema
- Example (from schema)
Schema
- AUTHENTICATION_CREDENTIALS_WERE_NOT_PROVIDED
Default value: fail
Default value: Authentication credentials were not provided.
{}
Not found
- application/json
- Schema
- Example (from schema)
Schema
- NOT_FOUND
- DOCUMENT_NOT_FOUND
Default value: fail
Default value: Not found.
Default value: fail
Default value: Document Not Found
{}
Rate limit
- application/json
- Schema
- Example (from schema)
Schema
- YOU_HAVE_BEEN_RATE_LIMITED
Default value: fail
Default value: You have been rate limited
Default value: [object Object]
{}
User error
- application/json
- Schema
- Example (from schema)
Schema
- CLIENT_CLOSED_REQUEST_OR_LOST_CONNECTION
Default value: fail
Default value: Client closed request or lost connection
{}
Service is temporarily unavailable
- application/json
- Schema
- Example (from schema)
Schema
- SERVICE_IS_TEMPORARILY_UNAVAILABLE_PLEASE_TRY_AGAIN_LATER
Default value: fail
Default value: Service is temporarily unavailable. Please try again later
{}
Gateway timeout. Returned if request takes more than 150 seconds. The request might finish successfully later.
- application/json
- Schema
- Example (from schema)
Schema
- GATEWAY_TIMEOUT
Default value: fail
Default value: Gateway timeout
{}
OperationStatus
- application/json
- Schema
- Example (from schema)
Schema
Default value: fail
{
"status": "fail",
"error": "string",
"details": [
{}
]
}