Search
K
Documents

TaxForms V2

getTaxForms-v2

This is an endpoint to get a list of tax-forms from SOVOS

get

Query Parameters

clientCodestring

Client code for the carrier/client

Example:EVGL

contractNumberstringrequired

Contract number for the document/tax-form

Example:1234567898

taxYearstring

Tax-year for the form (defaults to current year-1)

Example:2023

numYearsinteger(int32)

Default:1

>= 1<= 5

Example:1

Headers

Authorizationstringrequired

Authorization token

Example:Bearer <token>

Response

application/json

OK

TaxFormsResponse200

countnumberrequired
itemsarray[object]required
Show Child Parameters
get/document/v2/taxForms
 
application/json

downloadTaxForm-v2

This is an endpoint to download a tax-form from SOVOS

get

Query Parameters

clientCodestring

Client code for the carrier/client

Example:EVGL

contractNumberstringrequired

Contract number for the document/tax-form

Example:1234567898

fCharstringrequired

Unique string character associated with the tax-form name

Example:R

taxYearstring

Tax-year for the form (defaults to current year-1)

Example:2023

Path Parameters

formIdstringrequired

Form id for the tax-form

Example:123456

Headers

Authorizationstringrequired

Authorization token

Example:Bearer <token>

Response

OK

DownloadDocumentResponse

fileExtensionstringrequired
binaryDatastringrequired
get/document/v2/taxForms/{formId}
 

Documents V3

Uploads a document and saves its metadata

Accepts a file with metadata and returns a document Id

post

Headers

x-correlation-idstring

Body

multipart/form-data
filestringrequired
metadataobjectrequired
Show Child Parameters

Response

application/json

document stored successfully

DocumentUploadResponse

documentIdstring

Unique ID

Example:670e23dfab593b4387210b81

correlationIdstring

Unique ID for correlating requests

Example:123e4567-e89b-12d3-a456-426614174000

messagestring

Response message

Example:Document uploaded successfully

statusCodeinteger(int32)

Status code of the response

Example:200

successboolean
post/document/v3/documents

Body

{ "file": "file", "metadata": { "docClassification": "OUTBOUND", "docCategory": "NEW_BUSINESS", "fileType": "PDF", "documentType": "NB_STATE_REPLACEMENT", "documentTypeDescription": "Address Change Letter" } }
 
application/json