Get Exemption Certificate

curl -X POST https://api.zip-tax.com/merchant/cert/get \
     -H "X-API-KEY: <apiKey>" \
     -H "Content-Type: application/json" \
     -d '{
  "certificateId": "certificateId",
  "merchantId": "merchantId"
}'

{
  "accountId": 1000000,
  "address": {
    "city": "Minneapolis",
    "line1": "323 Washington Ave N",
    "state": "MN",
    "zip": "55401-2427",
    "countryCode": "US",
    "line2": "line2"
  },
  "certificateId": "certificateId",
  "connectionId": "connectionId",
  "createdDate": "2024-08-01T14:00:00Z",
  "customerBusinessType": "customerBusinessType",
  "customerId": "customerId",
  "customerName": "Mr. Francis Exempt",
  "reason": "Resale",
  "reasonDescription": "reasonDescription",
  "singlePurchase": true,
  "customerBusinessDescription": "customerBusinessDescription",
  "disabledAt": "2024-01-15T09:30:00Z",
  "states": [
    {
      "abbreviation": "MN"
    }
  ]
}

Available on Enterprise Plan

Forwards to TaxCloud GET /connections/{connectionId}/exemption-certificates/{certificateId}. certificateId is a path identifier.

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.

customerBusinessDescriptionstring

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

disabledAtdatetime

RFC3339 datetime the certificate was disabled, or null while it is active.

stateslist of objects

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