Methods

  • post - 3.2. Get Exemption Certificates

Resource

{
    "GetExemptCertificatesResult": {
        "ExemptCertificates": [
            {
                "CertificateID": "uuid",
                "Detail": {
                    "CreatedDate": "date-time",
                    "ExemptStates": [
                        {
                            "IdentificationNumber": "string",
                            "ReasonForExemption": "string",
                            "StateAbbr": "string"
                        }
                    ],
                    "PurchaserAddress1": "string",
                    "PurchaserAddress2": "string",
                    "PurchaserBusinessType": "string",
                    "PurchaserBusinessTypeOtherValue": "string",
                    "PurchaserCity": "string",
                    "PurchaserExemptionReason": "string",
                    "PurchaserExemptionReasonOtherValue": "string",
                    "PurchaserFirstName": "string",
                    "PurchaserLastName": "string",
                    "PurchaserState": "string",
                    "PurchaserTaxID": {
                        "IDNumber": "string",
                        "StateOfIssue": "string",
                        "TaxType": "string"
                    },
                    "PurchaserTitle": "string",
                    "PurchaserZip": "string"
                }
            }
        ],
        "Messages": [
            "string"
        ],
        "ResponseType": "int32"
    }
}

Properties

Name Type Description Additional
GetExemptCertificatesResult object Optional
GetExemptCertificatesResult.ExemptCertificates[] array Optional
GetExemptCertificatesResult.ExemptCertificates[].CertificateID uuid CertificateID Optional
GetExemptCertificatesResult.ExemptCertificates[].Detail object ExemptionCertificateDetail Optional
GetExemptCertificatesResult.ExemptCertificates[].Detail.CreatedDate date-time

The Date/Time of the exemption certificate being created. If omitted, this value is inferred from the time the API call is received. Exemption Certificate is not valid (will not be honored by TaxCloud) before this date.

GetExemptCertificatesResult.ExemptCertificates[].Detail.ExemptStates[] array

Typically, Exemption Certificates are state-by-state, however, for Federal Government Purchasers, multiple states can be specified.

GetExemptCertificatesResult.ExemptCertificates[].Detail.ExemptStates[].IdentificationNumber string
GetExemptCertificatesResult.ExemptCertificates[].Detail.ExemptStates[].ReasonForExemption string
GetExemptCertificatesResult.ExemptCertificates[].Detail.ExemptStates[].StateAbbr string State

Possible values are:

  • AL
  • AK
  • AZ
  • AR
  • CA
  • CO
  • CT
  • DE
  • DC
  • FL
  • GA
  • HI
  • ID
  • IL
  • IN
  • IA
  • KS
  • KY
  • LA
  • ME
  • MD
  • MA
  • MI
  • MN
  • MS
  • MO
  • MT
  • NE
  • NV
  • NH
  • NJ
  • NM
  • NY
  • NC
  • ND
  • OH
  • OK
  • OR
  • PA
  • RI
  • SC
  • SD
  • TN
  • TX
  • UT
  • VT
  • VA
  • WA
  • WV
  • WI
  • WY
GetExemptCertificatesResult.ExemptCertificates[].Detail.PurchaserAddress1 string
GetExemptCertificatesResult.ExemptCertificates[].Detail.PurchaserAddress2 string
GetExemptCertificatesResult.ExemptCertificates[].Detail.PurchaserBusinessType string ExemptPurchaserBusinessType

Possible values are:

  • AccommodationAndFoodServices
  • Agricultural_Forestry_Fishing_Hunting
  • Construction
  • FinanceAndInsurance
  • Information_PublishingAndCommunications
  • Manufacturing
  • Mining
  • RealEstate
  • RentalAndLeasing
  • RetailTrade
  • TransportationAndWarehousing
  • Utilities
  • WholesaleTrade
  • BusinessServices
  • ProfessionalServices
  • EducationAndHealthCareServices
  • NonprofitOrganization
  • Government
  • NotABusiness
  • Other
GetExemptCertificatesResult.ExemptCertificates[].Detail.PurchaserBusinessTypeOtherValue string

Required if PurchaserBusinessType selected is "Other"

Optional
GetExemptCertificatesResult.ExemptCertificates[].Detail.PurchaserCity string
GetExemptCertificatesResult.ExemptCertificates[].Detail.PurchaserExemptionReason string PurchaserExemptionReason

Possible values are:

  • FederalGovernmentDepartment
  • StateOrLocalGovernmentName
  • TribalGovernmentName
  • ForeignDiplomat
  • CharitableOrganization
  • EducationalOrganization
  • Resale
  • AgriculturalProduction
  • IndustrialProductionOrManufacturing
  • DirectPayPermit
  • DirectMail
  • Other
  • ReligiousOrganization
GetExemptCertificatesResult.ExemptCertificates[].Detail.PurchaserExemptionReasonOtherValue string

Required if PurchaserExemptionReason selected is "Other"

Optional
GetExemptCertificatesResult.ExemptCertificates[].Detail.PurchaserFirstName string
GetExemptCertificatesResult.ExemptCertificates[].Detail.PurchaserLastName string
GetExemptCertificatesResult.ExemptCertificates[].Detail.PurchaserState string
GetExemptCertificatesResult.ExemptCertificates[].Detail.PurchaserTaxID object ExemptPurchaserTaxID
GetExemptCertificatesResult.ExemptCertificates[].Detail.PurchaserTaxID.IDNumber string
GetExemptCertificatesResult.ExemptCertificates[].Detail.PurchaserTaxID.StateOfIssue string State

Possible values are:

  • AL
  • AK
  • AZ
  • AR
  • CA
  • CO
  • CT
  • DE
  • DC
  • FL
  • GA
  • HI
  • ID
  • IL
  • IN
  • IA
  • KS
  • KY
  • LA
  • ME
  • MD
  • MA
  • MI
  • MN
  • MS
  • MO
  • MT
  • NE
  • NV
  • NH
  • NJ
  • NM
  • NY
  • NC
  • ND
  • OH
  • OK
  • OR
  • PA
  • RI
  • SC
  • SD
  • TN
  • TX
  • UT
  • VT
  • VA
  • WA
  • WV
  • WI
  • WY
GetExemptCertificatesResult.ExemptCertificates[].Detail.PurchaserTaxID.TaxType string TaxType

Possible values are:

  • SSN
  • FEIN
  • StateIssued
  • ForeignDiplomat
GetExemptCertificatesResult.ExemptCertificates[].Detail.PurchaserTitle string
GetExemptCertificatesResult.ExemptCertificates[].Detail.PurchaserZip string
GetExemptCertificatesResult.Messages[] array of string

Optional array of messages related to the response.

Optional
GetExemptCertificatesResult.ResponseType int32

Response Types include

  • 0 = Error. Likely invalid API Credentials
  • 1 = Warning. Something is wrong.
  • 2 = Informational. Something could be better
  • 3 = SUCCESS! You did it!

    Possible values are:

    • %!s(float64=0)
    • %!s(float64=1)
    • %!s(float64=2)
    • %!s(float64=3)
Optional