> ## Documentation Index
> Fetch the complete documentation index at: https://traddal.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# List blocked codes

> HS codes your organization has excluded from classification results.

Requires the `classify:read` scope.

Blocked codes never appear in your classification results — when every
suggestion for a request is blocked, the request returns
`success: false` with `blocked: true`.

<ParamField query="destination_country" type="string">
  Filter to one destination (ISO alpha-2). Omit to list every entry.
</ParamField>

<ResponseField name="entries" type="array">
  Each entry carries `id`, `hs_code`, `country_code`, `reason`, and
  `created_at`. (`blocklist` is returned too, as a legacy alias of the same
  array.)
</ResponseField>

<RequestExample>
  ```bash cURL theme={null}
  curl 'https://{partner}.mytraddal.com/admin/api/v1/classify/blocklist?destination_country=US' \
    -H 'Authorization: Bearer {access_token}'
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "success": true,
    "message": "",
    "entries": [
      {
        "id": 41,
        "hs_code": "4202923131",
        "country_code": "US",
        "reason": "Ruled out by our broker",
        "created_at": "2026-06-02T09:41:00.000Z"
      }
    ],
    "blocklist": [
      {
        "id": 41,
        "hs_code": "4202923131",
        "country_code": "US",
        "reason": "Ruled out by our broker",
        "created_at": "2026-06-02T09:41:00.000Z"
      }
    ]
  }
  ```
</ResponseExample>