Search
K
Documents

Downloads a tax form

Retrieves a tax form by its unique ID

get

Query Parameters

parentCarrierCodestring

Carrier code

Example:EVGL

policyNumberstring

Policy number (either policyNumber or ssn is mandatory)

Example:7720001823

planCodestring

Plan Code

Example:132007A04

ssnstring

Social Security Number (either policyNumber or ssn is mandatory)

Example:123456

taxYearinteger(int32)

Example:2022

fCharstring

Unique string character associated with the tax-form name

Example:R

Path Parameters

formIdstringrequired

Unique form id for the tax-form

Example:44101

Headers

Authorizationstringrequired

Authorization token

Example:Bearer <token>

x-correlation-idstring

UUID for the request

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

Response

application/json

OK

TaxformDownloadResponse

fileExtensionstring

File extension of the document

Example:pdf

binaryDatastring

Binary data of the document

Example:wdvb2ekllkk189w0enjansle..

correlationIdstring

Unique ID for correlating requests

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

get/document/v3/tax-forms/{formId}/download
 
application/json

MetadataByIdResponse

object
metadataobject
Show Child Parameters
correlationIdstring

Unique ID for correlating requests

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

Example

MetadataResponse

object
sourcestring

Source system or origin of the document

Example:Email

documentIdstring

Unique ID in EDS db

Example:670e23dfab593b4387210b81

formNumberstring

Form number associated with the document

Example:FORM123

fileTypestring

Type of file, e.g., pdf, doc, etc.

Example:pdf

documentClassificationstring

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

Allowed values:OUTBOUNDINBOUND

Example:OUTBOUND

documentTypestring

Type of document indicating its purpose

Example:NB Application

documentCategorystring

Category of the document, such as New Business or Claim

Example:New Business

documentTypeDescriptionstring

Description of the document type

Example:Deferred Annuity Application

documentStatusinteger(int32)

Indicates the current status of the document. ‘1’ for ACTIVE, ‘0’ for INACTIVE.

Example:1

versionstring

Version of the document

Example:1

documentDatestring(date-time)

Date of the document

Example:2024-03-18T14:30:00.000Z

zinniaLiveCaseIdstring

Zinnia Live Case ID

Example:ZLC09876

planCodestring

Plan code

Example:565

policyNumberstring

Policy number associated with the document

Example:23109168

brokerMasterNumberstring

Broker master number associated with the document

Example:BKR123456

repMasterNumberstring

Representative master number associated with the document

Example:REP987654

agentExternalIDstring

External ID of the agent associated with the document

Example:AGT12345

brokerExternalIDstring

External ID of the broker associated with the document

Example:BRK12345

mailTrackingNumberstring

Mail tracking number

Example:TRK123456

deliveryMethodstring

Delivery method

Example:Email

emailFromstring

Email address

Example:XHbN8@example.com

emailTostring

Email address

Example:XHbN8@example.com

emailSubjectstring

Email subject

Example:Deferred Annuity Application

appIdstring

Application ID

Example:APP123456

mailShipDatestring(date-time)

Mail ship date

Example:2024-03-18T14:30:00.000Z

participantAccountNumberstring

Account number of the participant

Example:123456789

sourceFileNamestring

Name of the file in source system

Example:files/123456.pdf

displayNamestring

Display name of the document

Example:Deferred Annuity Application

distributionChannelstring

Distribution channel through which the document was delivered

Example:Online Portal

periodYearinteger(int32)

Year of the document period

Example:2024

periodQuarterstring

Quarter of the document period in Q1-Q4 format

Example:Q2

documentNumberstring

Document number associated with the document (if present) else document Id

Example:670e23dfab593b4387210b81 or 20241230-M-463066

documentVersionsarray[object]

Previous versions of the document

Show Child Parameters
scenariostring

Scenario

Allowed values:duplicatereplace

Example:duplicate

linkedDocumentIdstring

Linked document ID

Example:693e23dfab593b4387210k92

importDatestring(date-time)

Document creation timestamp(in UTC timezone)

Example:2024-09-23T10:30:00.000Z

Example

DocumentDownloadResponse

object
fileExtensionstring

File extension of the document

Example:pdf

fileNamestring

Name of the document

Example:NB Application

binaryDatastring

Binary data of the document

Example:wdvb2ekllkk189w0enjansle..

correlationIdstring

Unique ID for correlating requests

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

Example

TaxformResponse

object
policyNumberstring

policy number

Example:633033992

namestring

Name of the form

Example:1099-R

formIdstring

Form ID

Example:105

taxYearstring

Tax year

Example:2022

fcharstring
planCodestring

Example:633033992

Example