utilities

Search TIC Codes

Search for Taxability Information Codes (TICs) using semantic search.

This endpoint helps you find the correct TICs for your products using natural language product descriptions, category names, or search terms. It uses semantic similarity (vector-based) to match meaning and context, so results can be relevant even when exact terminology doesn't match.

How it works:

  • Provide a product description, category name, or search term
  • The system searches available TICs using semantic similarity
  • Results are ranked by relevance (most relevant first)
  • Set limit from 1–100 (defaults to 10 when omitted)
  • Use cursor to paginate through results (optional, from previous response's nextCursor)

Best Practices:

  • Use specific descriptions: "Ceramic & Pottery Kilns" works better than "kilns"
  • Include context: "Women's Athletic Shoes" is better than "shoes"
  • If you don't find a match, try broader or more specific terms

Example Queries:

  • "Ceramic & Pottery Kilns", "Women's Running Shoes", "Laptop Computer"
  • "Clothing", "Electronics", "Food & Beverages"
  • "shipping charges", "digital goods", "prescription drugs"

Service Availability: If you receive a service unavailable error (HTTP 503), this indicates temporary downstream service unavailability, potentially due to rate limiting. Check the Retry-After header (if present) and retry your request after the specified delay. Use exponential backoff for retries.

post/tax/tic/search

Request

  • Base URL: https://api.v3.taxcloud.com
  • URL: https://api.v3.taxcloud.com/tax/tic/search
  • Auth: HTTP bearer

Request body

$schemastring uri

A URL to the JSON Schema for this object.

cursorstring

Pagination cursor from previous response. Use the nextCursor value from a previous request to get the next page of results.

limitinteger

Maximum number of TIC results to return (1-100). Defaults to 10 if not provided. Fewer results may be returned if fewer matches are available.

querystring required

Product description, category name, or search term

Response

OK

$schemastring uri

A URL to the JSON Schema for this object.

nextCursorstring

Cursor for retrieving next page of results

querystring required

Echo of the input query

Changes

No recorded changes to this operation across all 1 revision of this API.