List certificates

GET

certificates

List Certificates

curl --request GET \
  --url https://api.taxwire.com/certificates \
  --header 'X-API-Key: <api-key>'

const options = {method: 'GET', headers: {'X-API-Key': '<api-key>'}};

fetch('https://api.taxwire.com/certificates', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.taxwire.com/certificates",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "X-API-Key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.taxwire.com/certificates"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("X-API-Key", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.taxwire.com/certificates")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["X-API-Key"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "has_more": true,
  "object": "list",
  "url": "/certificates",
  "data": [
    {
      "id": "cexc_01J9Z8Q4E7K2M3N4P5R6S7T8U9",
      "customer_id": "cust_01J9Z8Q4E7K2M3N4P5R6S7T8U9",
      "jurisdictions": [
        {
          "jurisdiction": "USA.S-CA",
          "jurisdiction_name": "California"
        }
      ],
      "status": "valid",
      "created_at": "2026-09-14T20:00:00Z",
      "updated_at": "2026-09-14T20:00:00Z",
      "exemption_number": "SR-1234567",
      "exemption_type": "resale",
      "exemption_type_other": null,
      "review_reason": null,
      "starts_at": "2025-04-01",
      "expires_at": "2027-03-31"
    }
  ]
}

{
  "errors": [
    {
      "status": "422",
      "code": "validation_error",
      "title": "Validation Error",
      "detail": "Input should be 'valid', 'expired', 'not_yet_active', 'needs_review' or 'rejected'"
    }
  ]
}

{
  "errors": [
    {
      "status": "429",
      "code": "rate_limit_error",
      "title": "Too Many Requests",
      "detail": "Rate limit exceeded"
    }
  ]
}

{
  "errors": [
    {
      "status": "500",
      "code": "system_internal_error",
      "title": "Internal Error",
      "detail": "An unexpected error occurred. Our team has been notified."
    }
  ]
}

Lists the exemption certificates on file for your customers, newest first, including those still in review or rejected.

Filters combine with AND. Repeat a filter to match any of its values, for example ?status=needs_review&status=rejected.
jurisdiction also matches places under it: USA.S-IL finds a certificate that covers USA.S-IL.M-CHICAGO.
status combines the review and the dates. needs_review and rejected certificates exempt nothing, whatever their dates say. Treat the list of values as open, because Taxwire can add more.
Certificates of deleted customers, and emailed certificates not yet linked to a customer, are left out.

See Listing certificates for examples.

Authorizations

X-API-Key

string

header

required

Query Parameters

limit

integer

default:100

Page size, between 1 and 1000.

Required range: 1 <= x <= 1000

starting_after

string | null

Return certificates after this one. Pass the id of the last certificate from the previous page to fetch the next page.

customer_id

string[] | null

Only certificates belonging to these customers. At most 100 values.

Maximum array length: 100

exemption_type

enum<string>[] | null

Only certificates with these exemption types.

Available options:

agriculture,

direct_pay,

driveaway,

govt_exempt_org,

manufacturing,

resale,

other

status

enum<string>[] | null

Only certificates with these statuses.

Available options:

valid,

expired,

not_yet_active,

needs_review,

rejected

jurisdiction

string[] | null

Only certificates covering these jurisdictions, given as political paths. A path also matches the jurisdictions under it: USA.S-IL matches a certificate for USA.S-IL.M-CHICAGO. At most 100 values.

Maximum array length: 100

Response

Successful Response

List envelope for GET /certificates, cursor-paged by id.

has_more

boolean

required

More results available

Examples:

true

false

object

string

default:list

url

string

default:/certificates

data

CertificateResource · object[]

A page of certificates, newest first.

Show child attributes

List Certificates

curl --request GET \
  --url https://api.taxwire.com/certificates \
  --header 'X-API-Key: <api-key>'

const options = {method: 'GET', headers: {'X-API-Key': '<api-key>'}};

fetch('https://api.taxwire.com/certificates', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.taxwire.com/certificates",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "X-API-Key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.taxwire.com/certificates"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("X-API-Key", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.taxwire.com/certificates")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["X-API-Key"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "has_more": true,
  "object": "list",
  "url": "/certificates",
  "data": [
    {
      "id": "cexc_01J9Z8Q4E7K2M3N4P5R6S7T8U9",
      "customer_id": "cust_01J9Z8Q4E7K2M3N4P5R6S7T8U9",
      "jurisdictions": [
        {
          "jurisdiction": "USA.S-CA",
          "jurisdiction_name": "California"
        }
      ],
      "status": "valid",
      "created_at": "2026-09-14T20:00:00Z",
      "updated_at": "2026-09-14T20:00:00Z",
      "exemption_number": "SR-1234567",
      "exemption_type": "resale",
      "exemption_type_other": null,
      "review_reason": null,
      "starts_at": "2025-04-01",
      "expires_at": "2027-03-31"
    }
  ]
}

{
  "errors": [
    {
      "status": "422",
      "code": "validation_error",
      "title": "Validation Error",
      "detail": "Input should be 'valid', 'expired', 'not_yet_active', 'needs_review' or 'rejected'"
    }
  ]
}

{
  "errors": [
    {
      "status": "429",
      "code": "rate_limit_error",
      "title": "Too Many Requests",
      "detail": "Rate limit exceeded"
    }
  ]
}

{
  "errors": [
    {
      "status": "500",
      "code": "system_internal_error",
      "title": "Internal Error",
      "detail": "An unexpected error occurred. Our team has been notified."
    }
  ]
}

Getting Started

Guides

API details

Calculations

Transactions

Customers

Certificates

Product Tax Codes (PTC) & Attributes

Products

Resources

Authorizations

Query Parameters

Response