For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
Logo
SupportLog InSign Up
GuidesAPI Reference
GuidesAPI Reference
  • Tax Rates
    • GETGet Tax Rates (v6.0)
  • Account
    • GETGet Account Metrics (v6.0)
  • Merchant
    • POSTCreate Merchant
    • POSTUpdate Merchant
    • POSTDelete Merchant
    • POSTGet Merchant
    • GETList Merchants
    • POSTSet Merchant Credentials
    • POSTGet Merchant Credentials
    • POSTDelete Merchant Credentials
  • Data
    • GETGet TIC Codes
    • POSTSearch TIC Codes
    • POSTRecommend TIC Codes
    • GETGet TIC Search JSON Schema
  • System
    • GETHealth Check
    • GETGet System Metadata
SupportLog InSign Up
Merchant

List Merchants

Beta
GET
https://api.zip-tax.com/merchant/list
GET
/merchant/list
$curl https://api.zip-tax.com/merchant/list \
>     -H "X-API-KEY: <apiKey>"
1[
2  {
3    "merchantId": "merchantId",
4    "name": "name",
5    "id": "id",
6    "contact_first": "contact_first",
7    "contact_last": "contact_last",
8    "contact_email": "contact_email",
9    "txc_connected": true
10  }
11]
> **Private Preview** — Access by request only. The API surface may change before general availability. Contact support@zip.tax for access. Returns every non-deleted merchant owned by the authenticated account. Empty accounts return an empty array. No pagination is implemented yet — large merchant lists will need a cursor in a future release.
Was this page helpful?
Previous

Set Merchant Credentials

Next
Built with

Private Preview — Access by request only. The API surface may change before general availability. Contact support@zip.tax for access.

Returns every non-deleted merchant owned by the authenticated account. Empty accounts return an empty array. No pagination is implemented yet — large merchant lists will need a cursor in a future release.

Authentication

X-API-KEYstring
API Key authentication via header

Response

OK
merchantIdstringformat: "uuid"

Server-issued UUID of the merchant

namestring
Merchant display name
idstring
External identifier supplied by the integrator at create time
contact_firststring
Primary contact first name
contact_laststring
Primary contact last name
contact_emailstring
Primary contact email
txc_connectedboolean
True if TaxCloud credentials are currently stored for the merchant

Errors

401
List Merchants Request Unauthorized Error
500
List Merchants Request Internal Server Error