Customs Entry AuditNEW
POST a 7501-shaped entry to /v1/audit/entry and get a line-by-line diff between the duty your broker declared and the duty our database says was owed under the rate stack in effect on the entry date — including Section 122 reciprocal, Section 232, Section 301 China, and MPF/HMF, with Federal Register provenance attached to every overlay.
At a glance
Try it — single-line audit
Run one line through the audit engine right now — no signup, no API key. Enter the HTS, country of origin, customs value, and the duty your broker declared. We'll diff it against the current rate stack and return a flag (match, underpaid, or overpaid) plus FR cites for every overlay applied. For full 7501 batch audits, upgrade to Team and POST to /v1/audit/entry.
What it solves
Pre-file sanity check
Catch under-applied Section 232 / 301 before you submit the entry. Flag missing program rates while there's still time to adjust.
Post-entry recovery
Replay your last quarter of 7501s against current rate history with as_of. Identify overpaid entries that may qualify for a Section 520(d) or PSC refund before the 5008.
Broker audits
Run nightly batch audits across every entry your team filed and get a per-line discrepancy report with FR cites — defensible for both internal QA and CBP inquiry.
Workflow lock-in
Higher-LTV than one-shot rate lookups. Each line audited returns cite-grade provenance you can paste into a 19 USC 1520 ruling request or Court of International Trade brief.
Request
Submit a single entry per call (max 200 line items). Larger batches will land in a multipart CSV path in a follow-up release.
curl -X POST https://api.ustariffrates.com/v1/audit/entry \
-H "Authorization: Bearer YOUR_TEAM_API_KEY" \
-H "Content-Type: application/json" \
-d @entry.jsonJSON body:
{
"entry_number": "ABI-12345678-9",
"as_of": "2026-04-15",
"lines": [
{
"line_no": 1,
"hts": "8471.30.01.00",
"country": "CN",
"value": 12500.00,
"declared_duty": 1875.00,
"mpf_paid": 43.30,
"hmf_paid": 15.63,
"mode": "ocean"
}
]
}Response
One flag per line: match, underpaid, overpaid, or error (HTS not found).
{
"entry_number": "ABI-12345678-9",
"as_of": "2026-04-15",
"audited_lines": 1,
"total_declared_duty": 1875.00,
"total_expected_duty": 2500.00,
"total_discrepancy": 625.00,
"total_underpaid": 625.00,
"total_overpaid": 0,
"lines": [
{
"line_no": 1,
"hts": "8471.30.01.00",
"country": "CN",
"expected": {
"base_mfn": 0,
"section_122": 1250.00,
"section_232": 0,
"section_301_china": 1250.00,
"mpf": 43.30,
"hmf": 15.63,
"total_duty": 2500.00,
"total_landed": 2558.93
},
"declared": { "duty": 1875.00, "mpf": 43.30, "hmf": 15.63 },
"discrepancy": 625.00,
"flag": "underpaid",
"provenance": [
{
"kind": "section_122",
"authority": "Section 122",
"source_doc_number": "2025-XXXX",
"source_url": "https://www.federalregister.gov/documents/...",
"effective_from": "2025-04-09"
}
]
}
]
}Get an API key
The audit endpoint is included with the Team plan ($199/mo, 10,000 requests + metered overage on lookup/calculate, $0.05 per audited entry). Free and Pro tiers cannot call this endpoint — upgrade to enable it on your account.