HTS MCP
Skip to Content
REST APICROSS Rulings

CROSS Rulings

Search CBP classification rulings from the Customs Rulings Online Search System (CROSS).

GET /api/cross/search

Full-text search over CROSS classification rulings. Returns results grouped by HTS code, sorted by ruling count (consensus).

Query Parameters

ParameterTypeDefaultDescription
qstring-Search query (required, min 2 characters)
limitinteger50Maximum rulings to return (1–200)
include_revokedbooleanfalseInclude revoked rulings

Response 200

{
  "groups": [
    {
      "htsCode": "2811.29.5000",
      "rulingCount": 5,
      "mostRecent": "2023-06-15",
      "rulings": [
        {
          "rulingNumber": "N123456",
          "subject": "Classification of nitrous oxide gas",
          "rulingDate": "2023-06-15",
          "rulingUrl": "https://rulings.cbp.gov/ruling/N123456",
          "score": 4.1
        }
      ]
    }
  ],
  "metadata": {
    "query": "nitrous oxide",
    "totalRulings": 12,
    "totalGroups": 3
  }
}

Examples

Basic search:

GET /api/cross/search?q=nitrous+oxide

Include revoked rulings:

GET /api/cross/search?q=lithium+ion+battery&include_revoked=true
GraphHealth