{"uid":"cap_FH_g98lF-U5jCfcn2z-7W","slug":"brainiac-hs-code-candidate-suggest-62e3a5bb","name":"BRAINIAC HS Code Candidate Suggest","description":"Pay-per-call APIs for AI agents: OFAC sanctions screening, compliance checks, token security, and Base chain data via x402. No account. Fixed USDC price. MCP-ready.","url":"https://www.brainiac.software/api/v1/freight-customs/hs-code-candidate-suggest?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"hsCode":{"type":"string","maxLength":14,"minLength":4},"description":{"type":"string","maxLength":300,"minLength":2}}},"responseSchema":{"type":"json","example":{"duty":"unavailable","source":"UK Trade Tariff","status":"candidates","findings":[{"code":"candidates_returned","kind":"extracted","detail":"These are search candidates from the UK Trade Tariff. They are not a customs classification."},{"code":"supplied_code_in_candidates","kind":"extracted","detail":"The supplied code matches a returned candidate by prefix. This is not a classification."}],"checkedAt":"2026-11-02T19:00:00.000Z","sanctions":"unavailable","candidates":[{"code":"6109100010","source":"UK Trade Tariff","description":"T-shirts"},{"code":"6109100090","source":"UK Trade Tariff","description":"Other"},"…"],"description":"cotton t-shirts","limitations":["No customs declaration was submitted and no shipment was booked.","Duty rates, restrictions, sanctions status, and country-specific requirements are not invented.","…"],"restrictions":"unavailable","shipmentBooked":false,"countryRequirements":"unavailable","declarationSubmitted":false,"definitiveClassification":false}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.06","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.06/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.06","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.06","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_e4tAWFu4qsExLFTQVoXtE","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.06","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Suggests candidate HS (Harmonized System) tariff codes for a product description or supplied code using the UK Trade Tariff search, returning potential matches with caveats that these are not formal customs classifications.","exampleAgentPrompt":"Can you suggest some HS code candidates for 'cotton t-shirts' — I want to see what UK Trade Tariff codes might apply so I can figure out the right one for my customs paperwork?","exampleUseCases":[{"title":"Pre-shipment tariff code research","prompt":"I'm shipping 500 units of cotton t-shirts to the UK and need to find the right HS code. Can you search the UK Trade Tariff and suggest candidate codes for 'cotton knitted t-shirts' so I know what to investigate further?"},{"title":"Validating an existing HS code","prompt":"I've been using code 6109100010 for our cotton tops — can you check if that code shows up as a candidate in the UK Trade Tariff for 'cotton t-shirts' so I know I'm at least in the right area?"},{"title":"E-commerce import classification research","prompt":"We're setting up automated customs docs for our clothing line and need to identify plausible HS codes for 'woven polyester jackets' — can you pull candidate codes from the UK Trade Tariff so our compliance team can narrow it down?"}],"resultDescription":"A JSON object containing: a list of HS code candidates from the UK Trade Tariff with their codes and descriptions, the status of the lookup (e.g. 'candidates'), findings about whether the supplied code matches any candidate, the product description used, timestamps, and availability indicators for duty rates, sanctions, restrictions, and country requirements. Includes explicit limitations clarifying these are not formal customs classifications.","failureModes":["Ambiguous product description returns unrelated or low-relevance candidates","Very specific or niche product descriptions may return no candidates","Duty rates, sanctions, and country requirements are always returned as 'unavailable' — this endpoint does not provide those values","The endpoint explicitly does not submit a customs declaration or book a shipment","Supplied HS code may not appear in candidates even if it is valid","Short or overly broad descriptions may return too many generic candidates"],"whenToPreferThis":"Use this endpoint when you need a quick, accountless lookup of plausible HS tariff code candidates from the UK Trade Tariff without needing to set up an account or integration. It is best suited for early-stage customs research, pre-classification shortlisting, or validating whether an existing code is in the right ballpark. It is not a replacement for formal customs classification — use it to narrow options before engaging a licensed customs broker or submitting a declaration.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-11-17T00:36:54.827Z","isFirstParty":false,"canonicalSlug":"brainiac-hs-code-candidate-suggest-62e3a5bb"}