Which control columns a destination carries
lookup_countryReturn the Commerce Country Chart row for a destination: which of the sixteen control columns are marked, with each reason expanded. Use this to see how heavily controlled a destination is, or to check the chart's spelling of a country before another lookup. Special-controls destinations such as Cuba, Iran, North Korea and Syria return embargoed with a referral, because the chart does not govern them and reading a blank row as permission would be badly wrong. A marked column means a licence is required for items controlled for that reason; it says nothing about any particular item until you pair it with an ECCN.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| country | Yes | Destination country name, e.g. Germany. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| status | Yes | Outcome of the lookup. Only `ok` carries an answer. `embargoed` means the chart does not govern the destination. `indeterminate` means the entry has no country-chart control in this data and the chart cannot answer for it, which is not the same as no licence being required. `ambiguous_country` means the name matched more than one row and you must ask which was meant. | |
| columns | No | Marked control columns, each with its reason code and expanded name. | |
| country | No | The chart row that was matched. | |
| referral | No | Where to look instead, for a special-controls destination. | |
| footnotes | No | Chart footnotes on this row, each with its number and text. They carry conditions the grid cannot show, such as the Russia and Belarus sanctions and the Crimea controls, and they can change the answer. | |
| candidates | No | Possible destinations, when the name matched more than one row. |