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

Gets metadata for a document

Fetches metadata details, including version history if requested

get

Query Parameters

isAllVersionsNeededboolean

Indicates if all versions are required in the response

Default:false

Example:true

documentTypestring

Type of document indicating its purpose

Example:NB Application

documentClassificationstring

Classification of the document, e.g., OUTBOUND OR INBOUND

Allowed values:OUTBOUNDINBOUND

Example:OUTBOUND

parentCarrierCodestring

Client code associated with the document

Example:EVGL

Path Parameters

documentIdstringrequired

Unique ID in EDS db

Example:670e23dfab593b4387210b81

Headers

Authorizationstringrequired

Authorization token

Example:Bearer <token>

x-correlation-idstring

Unique ID for correlating requests

Example:1760f822-dcbf-49fc-a623-a1998383f4b9

Response

application/json

document metadata retrieved successfully

MetadataByIdResponse

metadataobject
Show Child Parameters
correlationIdstring

Unique ID for correlating requests

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

get/document/v3/documents/{documentId}
 
application/json