Skip to navigation
Merchant Transactions [TaxCloud]

Get Exemption Certificate

View as Markdown
Available on Enterprise Plan

Forwards to TaxCloud GET /connections/{connectionId}/exemption-certificates/{certificateId}. certificateId is a path identifier. Requires a TaxCloud-connected merchant with credentials on file: this operation returns 403 for a self-managed merchant, whose only available transaction endpoint is /merchant/cart/calculate.

Authentication

X-API-KEYstring
API Key authentication via header

Request

This endpoint expects an object.
certificateIdstringRequired
The certificateId returned when the exemption certificate was created.
merchantIdstringRequired
UUID of the merchant. Must be owned by the calling account. Consumed by the Ziptax layer for routing and not forwarded to TaxCloud.

Response

TaxCloud response relayed verbatim.
accountIdlong
The TaxCloud account id the certificate belongs to.
addressobject
Address of the exempt customer.
certificateIdstring

TaxCloud's identifier for the exemption certificate. Use it with /merchant/cert/get, /merchant/cert/delete, and as exemptionId on carts and orders.

connectionIdstring
The TaxCloud connection the certificate belongs to.
createdDatedatetime
RFC3339 datetime the certificate was created.
customerBusinessTypestring

The type of business the customer is (e.g. RetailTrade, Government, NonprofitOrganization).

customerIdstring
Your identifier for the exempt customer.
customerNamestring
Name of the customer the certificate was issued to.
reasonstring

The reason the customer is exempt (e.g. Resale, FederalGovernment, CharitableOrganization).

reasonDescriptionstring

Free-text elaboration of the exemption reason.

singlePurchaseboolean
Whether the certificate covers a single purchase only, rather than being a blanket certificate.
customerBusinessDescriptionstringOptional

Free-text description of the business, present when customerBusinessType is Other.

disabledAtdatetimeOptional
RFC3339 datetime the certificate was disabled, or null while it is active.
stateslist of objectsOptional
The states the certificate is valid in.

Errors

400
Merchant Cert Get Body Bad Request Error
401
Merchant Cert Get Body Unauthorized Error
403
Merchant Cert Get Body Forbidden Error
404
Merchant Cert Get Body Not Found Error
413
Merchant Cert Get Body Content Too Large Error
422
Merchant Cert Get Body Unprocessable Entity Error
429
Merchant Cert Get Body Too Many Requests Error
500
Merchant Cert Get Body Internal Server Error
502
Merchant Cert Get Body Bad Gateway Error
504
Merchant Cert Get Body Gateway Timeout Error