Skip to main content
Version: 1.7.3

Whcertificate Reconciliation Report

Whcertificate Reconciliation Report

GET Reports/WhFormsReconcileReport 

Use this endpoint to retrieve the count and current status of W-9/W-8 requests initiated in your account.

Provide the date range for the period you wish to generate the report, and the response will include a complete summary of WhCertificate requests along with their statuses. Click here to view the complete list of statuses available for W-9/W-8 forms.

Request Params

FieldTypeDescription
FromDatestringOptional Enter a date from which the form W9/W8 records need to be listed in MM/DD/YYYY format.
ToDatestringOptional Enter a date till which the W9/W8 records created are to be listed in MM/DD/YYYY format.

Response Body

FieldTypeDescription
WithHoldingFormsSummaryObjectSummary of withholding forms requests and statuses.
    RequestByEmailObjectSummary of requests initiated through email.
        RequestByEmailTotalCountNumberReturns the total number of requests sent through email.
        WhCertificateObjectReturns withholding certificate request statistics for email requests.
            WhCertificateTotalCountNumberReturns the total number of withholding certificate requests sent through email.
            SENTNumberReturns total number of forms in the SENT status.
            OPENEDNumberReturns total number of forms in OPENED status.
            BOUNCEDNumberReturns total number of forms in BOUNCED status.
        FormW9ObjectReturns Form W-9 request statistics for email requests.
            W9TotalCountNumberReturns total number of Form W-9 requests.
            SENTNumberReturns total number of forms in SENT status.
            OPENEDNumberReturns total number of forms in OPENED status.
            COMPLETEDNumberReturns total number of forms in COMPLETED status.
            AWAITING_TIN_CERTIFICATENumberReturns total number of forms awaiting TIN certification.
            COMPLETED_AND_TIN_MATCH_INPROGRESSNumberReturns total number of completed forms currently undergoing TIN matching.
            INVALIDNumberReturns total number of forms in INVALID status.
            BOUNCEDNumberReturns total number of forms in BOUNCED status.
        FormW8BENObjectReturns Form W-8BEN request statistics for email requests.
            W8BENTotalCountNumberReturns total number of Form W-8BEN requests.
            SENTNumberReturns total number of forms in SENT status.
            OPENEDNumberReturns total number of forms in OPENED status.
            COMPLETEDNumberReturns total number of forms in COMPLETED status.
            BOUNCEDNumberReturns total number of forms in BOUNCED status.
            EXPIREDNumberReturns total number of forms in EXPIRED status.
        FormW8BENEObjectReturns Form W-8BEN-E request statistics for email requests.
            W8BENETotalCountNumberReturns total number of Form W-8BEN-E requests.
            OPENEDNumberReturns total number of forms in OPENED status.
            COMPLETEDNumberReturns total number of forms in COMPLETED status.
            EXPIREDNumberReturns total number of forms in EXPIRED status.
        FormW8EXPObjectReturns Form W-8EXP request statistics for email requests.
            W8EXPTotalCountNumberReturns total number of Form W-8EXP requests.
            OPENEDNumberReturns total number of forms in OPENED status.
            COMPLETEDNumberReturns total number of forms in COMPLETED status.
        FormW8ECIObjectReturns Form W-8ECI request statistics for email requests.
            W8ECITotalCountNumberReturns total number of Form W-8ECI requests.
            OPENEDNumberReturns total number of forms in OPENED status.
            COMPLETEDNumberReturns total number of forms in COMPLETED status.
        FormW8IMYObjectReturns Form W-8IMY request statistics for email requests.
            W8IMYTotalCountNumberReturns total number of Form W-8IMY requests.
            OPENEDNumberReturns total number of forms in OPENED status.
            COMPLETEDNumberReturns total number of forms in COMPLETED status.
            EXPIREDNumberReturns total number of forms in EXPIRED status.
    RequestByUrlObjectSummary of requests initiated through URL generation.
        RequestByUrlTotalCountNumberReturns total number of URL-based requests.
        WhCertificateObjectReturns withholding certificate request statistics for URL requests.
        WhCertificateTotalCountNumberReturns total number of withholding certificate URL requests.
        URL_GENERATEDNumberReturns total number of generated URLs.
        OPENEDNumberReturns total number of opened URLs.
        FormW9ObjectReturns Form W-9 request statistics for URL requests.
        W9TotalCountNumberReturns total number of Form W-9 URL requests.
        URL_GENERATEDNumberReturns total number of generated URLs.
        OPENEDNumberReturns total number of forms in OPENED status.
        COMPLETEDNumberReturns total number of forms in COMPLETED status.
        AWAITING_TIN_CERTIFICATENumberReturns total number of forms awaiting TIN certification.
        COMPLETED_AND_TIN_MATCH_INPROGRESSNumberReturns the total number of completed forms currently undergoing TIN matching.
        INVALIDNumberReturns total number of forms in INVALID status.
        ONHOLDNumberReturns total number of forms in ONHOLD status.
        FormW8BENObjectReturns Form W-8BEN request statistics for URL requests.
        W8BENTotalCountNumberReturns total number of Form W-8BEN URL requests.
        URL_GENERATEDNumberReturns total number of generated URLs.
        OPENEDNumberReturns total number of forms in OPENED status.
        COMPLETEDNumberReturns total number of forms in COMPLETED status.
        EXPIREDNumberReturns total number of forms in EXPIRED status.
        ONHOLDNumberReturns total number of forms in ONHOLD status.
        FormW8BENEObjectReturns Form W-8BENE request statistics for URL requests.
        W8BENETotalCountNumberReturns total number of Form W-8BENE URL requests.
        OPENEDNumberReturns total number of forms in OPENED status.
        COMPLETEDNumberReturns total number of forms in COMPLETED status.
        EXPIREDNumberReturns total number of forms in EXPIRED status.
        ONHOLDNumberReturns total number of forms in ONHOLD status.
        FormW8EXPObjectReturns Form W-8EXP request statistics for URL requests.
        W8EXPTotalCountNumberReturns total number of Form W-8EXP URL requests.
        OPENEDNumberReturns total number of forms in OPENED status.
        COMPLETEDNumberReturns total number of forms in COMPLETED status.
        ONHOLDNumberReturns total number of forms in ONHOLD status.
        FormW8ECIObjectReturns Form W-8ECI request statistics for URL requests.
        W8ECITotalCountNumberReturns total number of Form W-8ECI URL requests.
        OPENEDNumberReturns total number of forms in OPENED status.
        COMPLETEDNumberReturns total number of forms in COMPLETED status.
        ONHOLDNumberReturns total number of forms in ONHOLD status.
        FormW8IMYObjectReturns Form W-8IMY request statistics for URL requests.
        W8IMYTotalCountNumberReturns total number of Form W-8EXP URL requests.
        OPENEDNumberReturns total number of forms in OPENED status.
        COMPLETEDNumberReturns total number of forms in COMPLETED status.
        EXPIREDNumberReturns total number of forms in EXPIRED status.
        ONHOLDNumberReturns total number of forms in ONHOLD status.
    RequestByTextObjectSummary of requests initiated through text.
        RequestByTextTotalCountNumberReturns the total number of requests sent through text.
        WhCertificateObjectReturns withholding certificate request statistics for text requests.
            WhCertificateTotalCountNumberReturns the total number of withholding certificate requests sent through text.
            SENTNumberReturns total number of forms in the SENT status.
            OPENEDNumberReturns total number of forms in OPENED status.
        FormW9ObjectReturns Form W-9 request statistics for text requests.
            W9TotalCountNumberReturns total number of Form W-9 requests.
            SENTNumberReturns total number of forms in SENT status.
            OPENEDNumberReturns total number of forms in OPENED status.
            COMPLETEDNumberReturns total number of forms in COMPLETED status.
            AWAITING_TIN_CERTIFICATENumberReturns total number of forms awaiting TIN certification.
            COMPLETED_AND_TIN_MATCH_INPROGRESSNumberReturns total number of completed forms currently undergoing TIN matching.
            INVALIDNumberReturns total number of forms in INVALID status.
        FormW8BENObjectReturns Form W-8BEN request statistics for text requests.
        W8BENTotalCountNumberReturns total number of Form W-8BEN requests.
        SENTNumberReturns total number of forms in SENT status.
        OPENEDNumberReturns total number of forms in OPENED status.
        COMPLETEDNumberReturns total number of forms in COMPLETED status.
        EXPIREDNumberReturns total number of forms in EXPIRED status.
        FormW8BENEObjectReturns Form W-8BEN-E request statistics for text requests.
        W8BENETotalCountNumberReturns total number of Form W-8BEN-E requests.
        OPENEDNumberReturns total number of forms in OPENED status.
        COMPLETEDNumberReturns total number of forms in COMPLETED status.
        EXPIREDNumberReturns total number of forms in EXPIRED status.
        FormW8EXPObjectReturns Form W-8EXP request statistics for text requests.
        W8EXPTotalCountNumberReturns total number of Form W-8EXP requests.
        OPENEDNumberReturns total number of forms in OPENED status.
        COMPLETEDNumberReturns total number of forms in COMPLETED status.
        FormW8ECIObjectReturns Form W-8ECI request statistics for text requests.
        W8ECITotalCountNumberReturns total number of Form W-8ECI requests.
        OPENEDNumberReturns total number of forms in OPENED status.
        COMPLETEDNumberReturns total number of forms in COMPLETED status.
        FormW8IMYObjectReturns Form W-8IMY request statistics for text requests.
        W8IMYTotalCountNumberReturns total number of Form W-8IMY requests.
        OPENEDNumberReturns total number of forms in OPENED status.
        COMPLETEDNumberReturns total number of forms in COMPLETED status.
        EXPIREDNumberReturns total number of forms in EXPIRED status.
    WHCertificateCreateObjectSummary of uploaded forms through manual save endpoint
        WHCertificateCreateTotCountNumberReturns the total number of uploaded forms through manual save endpoint
            COMPLETEDNumberReturns total number of forms in COMPLETED status.
            AWAITING_TIN_CERTIFICATENumberReturns total number of forms awaiting TIN certification.
            COMPLETED_AND_TIN_MATCH_INPROGRESSNumberReturns total number of completed forms currently undergoing TIN matching.
            INVALIDNumberReturns total number of forms in INVALID status.
Errorsobject[]Shows error information
    IdstringReturns the validation error Id.
    NamestringName of the validation error.
    MessagestringDescription of the validation error.

Request Params

"Reports/WhFormsReconcileReport?FromDate=11/11/2025&ToDate=03/25/2025"

Response JSON

Success Response - This is a sample response for successful API requests.

{
"WithHoldingFormsSummary": {
"RequestByEmail": {
"RequestByEmailTotalCount": 126,
"WhCertificate": {
"WhCertificateTotalCount": 74,
"SENT": 69,
"OPENED": 4,
"BOUNCED": 0
},
"FormW9": {
"W9TotalCount": 31,
"SENT": 9,
"OPENED": 7,
"COMPLETED": 15,
"AWAITING_TIN_CERTIFICATE": 0,
"COMPLETED_AND_TIN_MATCH_INPROGRESS": 0,
"INVALID": 0,
"BOUNCED": 0
},
"FormW8BEN": {
"W8BENTotalCount": 15,
"SENT": 9,
"OPENED": 4,
"COMPLETED": 0,
"BOUNCED": 0,
"EXPIRED": 2
},
"FormW8BENE": {
"W8BENETotalCount": 3,
"OPENED": 3,
"COMPLETED": 0,
"EXPIRED": 0
},
"FormW8EXP": {
"W8EXPTotalCount": 0,
"OPENED": 0,
"COMPLETED": 0
},
"FormW8ECI": {
"W8ECITotalCount": 2,
"OPENED": 0,
"COMPLETED": 1
},
"FormW8IMY": {
"W8IMYTotalCount": 1,
"OPENED": 1,
"COMPLETED": 0,
"EXPIRED": 0
}
},
"RequestByUrl": {
"RequestByUrlTotalCount": 136,
"WhCertificate": {
"WhCertificateTotalCount": 40,
"URL_GENERATED": 41,
"OPENED": 0
},
"FormW9": {
"W9TotalCount": 67,
"URL_GENERATED": 2,
"OPENED": 14,
"COMPLETED": 49,
"AWAITING_TIN_CERTIFICATE": 5,
"COMPLETED_AND_TIN_MATCH_INPROGRESS": 0,
"INVALID": 2,
"ONHOLD": 2
},
"FormW8BEN": {
"W8BENTotalCount": 7,
"URL_GENERATED": 0,
"OPENED": 4,
"COMPLETED": 0,
"EXPIRED": 2,
"ONHOLD": 1
},
"FormW8BENE": {
"W8BENETotalCount": 12,
"OPENED": 2,
"COMPLETED": 1,
"EXPIRED": 6,
"ONHOLD": 3
},
"FormW8EXP": {
"W8EXPTotalCount": 1,
"OPENED": 0,
"COMPLETED": 1,
"ONHOLD": 0
},
"FormW8ECI": {
"W8ECITotalCount": 3,
"OPENED": 1,
"COMPLETED": 2,
"ONHOLD": 0
},
"FormW8IMY": {
"W8IMYTotalCount": 5,
"OPENED": 5,
"COMPLETED": 0,
"EXPIRED": 0,
"ONHOLD": 0
}
},
"RequestByText": {
"RequestByTextTotalCount": 22,
"WhCertificate": {
"WhCertificateTotalCount": 8,
"SENT": 6,
"OPENED": 2
},
"FormW9": {
"W9TotalCount": 14,
"SENT": 4,
"OPENED": 4,
"COMPLETED": 6,
"AWAITING_TIN_CERTIFICATE": 0,
"COMPLETED_AND_TIN_MATCH_INPROGRESS": 0,
"INVALID": 0
},
"FormW8BEN": {
"W8BENTotalCount": 0,
"SENT": 0,
"OPENED": 0,
"COMPLETED": 0,
"EXPIRED": 0
},
"FormW8BENE": {
"W8BENETotalCount": 0,
"OPENED": 0,
"COMPLETED": 0,
"EXPIRED": 0
},
"FormW8EXP": {
"W8EXPTotalCount": 0,
"OPENED": 0,
"COMPLETED": 0
},
"FormW8ECI": {
"W8ECITotalCount": 0,
"OPENED": 0,
"COMPLETED": 0
},
"FormW8IMY": {
"W8IMYTotalCount": 0,
"OPENED": 0,
"COMPLETED": 0,
"EXPIRED": 0
}
},
"WHCertificateCreate": {
"WHCertificateCreateTotCount": 0,
"COMPLETED": 0,
"AWAITING_TIN_CERTIFICATE": 0,
"COMPLETED_AND_TIN_MATCH_INPROGRESS": 0,
"INVALID": 0
}
},
"Errors": null
}