Create a TaxCloud maintained Exemption Certificate.

Request

POST https://api.taxcloud.net/1.0/TaxCloud/AddExemptCertificate

Request body

The request body takes a complete AddExemptCertificate resource, containing the following writable properties:

{
    "apiKey": "string",
    "apiLoginID": "string",
    "customerID": "string",
    "exemptCert": {
        "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"
        }
    }
}

Properties

Name Type Description Additional
apiKey string

Find your API KEY via https://taxcloud.com/go/stores/

apiLoginID string

Find your API ID via https://taxcloud.com/go/stores/

customerID string

This should be the abstract identifier used by your system to uniquely identify customers. Note: This should not be your customer's email address or any other form of Personally Identifiable Information (PII).

exemptCert object exemptCert
exemptCert.CertificateID uuid CertificateID Optional
exemptCert.Detail object ExemptionCertificateDetail Optional
exemptCert.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.

exemptCert.Detail.ExemptStates[] array

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

exemptCert.Detail.ExemptStates[].IdentificationNumber string
exemptCert.Detail.ExemptStates[].ReasonForExemption string
exemptCert.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
exemptCert.Detail.PurchaserAddress1 string
exemptCert.Detail.PurchaserAddress2 string
exemptCert.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
exemptCert.Detail.PurchaserBusinessTypeOtherValue string

Required if PurchaserBusinessType selected is "Other"

Optional
exemptCert.Detail.PurchaserCity string
exemptCert.Detail.PurchaserExemptionReason string PurchaserExemptionReason

Possible values are:

  • FederalGovernmentDepartment
  • StateOrLocalGovernmentName
  • TribalGovernmentName
  • ForeignDiplomat
  • CharitableOrganization
  • EducationalOrganization
  • Resale
  • AgriculturalProduction
  • IndustrialProductionOrManufacturing
  • DirectPayPermit
  • DirectMail
  • Other
  • ReligiousOrganization
exemptCert.Detail.PurchaserExemptionReasonOtherValue string

Required if PurchaserExemptionReason selected is "Other"

Optional
exemptCert.Detail.PurchaserFirstName string
exemptCert.Detail.PurchaserLastName string
exemptCert.Detail.PurchaserState string
exemptCert.Detail.PurchaserTaxID object ExemptPurchaserTaxID
exemptCert.Detail.PurchaserTaxID.IDNumber string
exemptCert.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
exemptCert.Detail.PurchaserTaxID.TaxType string TaxType

Possible values are:

  • SSN
  • FEIN
  • StateIssued
  • ForeignDiplomat
exemptCert.Detail.PurchaserTitle string
exemptCert.Detail.PurchaserZip string

Response

The following HTTP status codes may be returned, optionally with a response resource.

Status code Description Resource
200 OK

OK

AddExemptCertificateResponse

Explore this API

AddExemptCertificate
Request Content-Type
Response Content-Type
Try it out!