DEVELOPER REST API

Consolidated Screening List (CSL) API Docs

Free, public REST API endpoint for automated denied-party screening against 14 U.S. federal sanctions lists.

Endpoint Specification

          GET https://hscodedb.com/api/screening?name={query}
        

Request Parameters

Parameter	Type	Required	Description
name	String	Yes	Target entity or person name to screen (min 2 characters, URL-encoded).

cURL Example

curl -X GET "https://hscodedb.com/api/screening?name=Acme"   -H "Accept: application/json"

Sample Response (JSON 200 OK)

{
  "total": 1,
  "sources": ["BIS Denied Persons List", "OFAC SDN List"],
  "results": [
    {
      "name": "ACME LOGISTICS TRADING CORP",
      "alt_names": ["Acme Global"],
      "source": "Denied Persons List (DPL)",
      "programs": ["Export Administration Regulations (EAR)"],
      "country": "China",
      "addresses": ["123 Trade Zone, Shanghai"],
      "remarks": "Order denying export privileges",
      "source_information_url": "https://www.bis.doc.gov/"
    }
  ]
}

Usage Policy & Rate Limits

Rate Limit: 100 requests per minute per IP address.
CORS: Cross-Origin Resource Sharing (Access-Control-Allow-Origin: *) enabled for client-side applications.
Edge Caching: Successful queries are cached for 15 minutes (s-maxage=900) on Cloudflare edge.
Data Source: U.S. International Trade Administration (ITA) Consolidated Screening List API.

Compliance Disclaimer: Screening results are provided for informational reference only. Official export control and sanction determinations are governed by U.S. BIS, OFAC, and State Department regulations.