{"uid":"cap_Jx0t63XpzepzT26ETFJvL","slug":"sitecheck-trade-energy-us-cbp-cross-rulings-search-5c6f2e12","name":"SiteCheck Trade & Energy – US CBP CROSS Rulings Search","description":"Searches US CBP binding customs rulings (CROSS database) by keyword and returns ruling number, subject, date, classified tariff number, category and whether it was modified or revoked. Results are the first page of the CBP search (up to 20); it is not a legal opinion.","url":"https://api.tradeenergy-api.workers.dev/api/logistics/us-cbp-cross-rulings?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","required":["term"],"properties":{"term":{"type":"string","description":"Keyword(s), 3 to 80 characters"},"limit":{"type":"string","description":"1 to 20, default 5"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"term":"motor vehicle","source":"https://rulings.cbp.gov/api/search?term=motor%20vehicle","rulings":[{"revoked":false,"subject":"Motor vehicle license plate bracket","category":"Classification","collection":"hq","rulingDate":"2000-03-10","rulingNumber":"962974","tariffNumber":"8302.30.30","operationallyRevoked":false},{"revoked":false,"subject":"Mahindra Project 408 Motor Vehicle","category":"Classification","collection":"hq","rulingDate":"2007-01-25","rulingNumber":"W968379","tariffNumber":"8704.21.0000","operationallyRevoked":false}],"checkedAt":"2026-10-23T09:38:00.544Z","totalHits":2714}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.002","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.002/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_EzABUGM5YiT9IY8IiWFHz","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.002","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Searches the US CBP CROSS database of binding customs rulings by keyword and returns ruling details including tariff number, category, and revocation status.","exampleAgentPrompt":"Can you search the CBP CROSS rulings database for 'electric bicycle' and show me the top 10 results including tariff numbers and whether any rulings have been revoked?","exampleUseCases":[{"title":"Tariff classification research for product import","prompt":"I'm importing folding electric scooters from China and need to know how CBP has classified them in binding rulings — can you search CROSS for 'electric scooter' and give me the ruling numbers and HTS codes?"},{"title":"Checking revocation status of customs rulings","prompt":"Search the CBP CROSS database for 'solar panel' rulings and flag any that have been revoked or modified — I want to make sure I'm not relying on outdated guidance."},{"title":"Compliance research for a new product category","prompt":"We're launching a line of biodegradable food packaging and need to understand how US customs has ruled on similar items — can you look up 'biodegradable packaging' in the CBP CROSS rulings and return up to 15 results?"}],"resultDescription":"A JSON object containing the search term used, a link to the CBP source URL, a checkedAt timestamp, the total number of matching rulings in the database, and an array of up to 20 ruling objects each with ruling number, subject, ruling date, classified tariff (HTS) number, category (e.g. Classification), collection (e.g. hq), and boolean flags for whether the ruling was revoked or operationally revoked.","failureModes":["Search term shorter than 3 or longer than 80 characters returns validation error","No matching rulings found returns empty rulings array with totalHits of 0","CBP CROSS upstream service unavailable causes failure or stale data","Limit parameter outside 1–20 range may be clamped or cause error","Highly ambiguous search terms may return irrelevant rulings requiring further filtering"],"whenToPreferThis":"Use this endpoint when you need to quickly search US CBP binding customs rulings (CROSS database) by keyword to find HTS tariff classifications, check revocation status, or research classification precedents for imported goods. It is ideal for trade compliance agents, customs brokers, and importers who need fast programmatic access to CBP ruling data without manually navigating the CBP website. Prefer this over general web search when you need structured, machine-readable ruling data including tariff numbers and revocation flags.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-29T00:34:22.329Z","isFirstParty":false,"canonicalSlug":"sitecheck-trade-energy-us-cbp-cross-rulings-search-5c6f2e12"}