Country Trade Data (Exports, Imports, Balance & Partners)

{
  "type": "object",
  "required": [
    "country_code"
  ],
  "properties": {
    "year": {
      "type": "number"
    },
    "country_code": {
      "type": "string"
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "country_code",
    "country_name",
    "year",
    "total_exports_usd",
    "total_imports_usd",
    "trade_balance_usd",
    "top_exports",
    "top_imports",
    "top_partners",
    "data_source",
    "note"
  ],
  "properties": {
    "note": {
      "type": "string",
      "description": "A caveat about estimate quality. Observed as the SAME text -- '...based on 2023 published trade statistics' -- on both fixtures, including the germany-2022.json one requesting year 2022; this reads as a static disclaimer rather than one adjusted to the requested/returned year."
    },
    "year": {
      "type": "number",
      "description": "The trade data's reference year. Observed as 2023 when the optional `year` input was omitted (usa-trade.json) and as the requested 2022 when it was supplied (germany-2022.json)."
    },
    "data_source": {
      "type": "string",
      "description": "Observed as the literal string 'World Bank API + embedded product data' on both fixtures captured."
    },
    "top_exports": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "product": {
            "type": "string"
          },
          "value_usd": {
            "type": "number"
          },
          "share_percent": {
            "type": "number",
            "description": "Percent of total exports this product represents."
          }
        },
        "additionalProperties": true
      },
      "description": "5 entries on both fixtures captured."
    },
    "top_imports": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "product": {
            "type": "string"
          },
          "value_usd": {
            "type": "number"
          },
          "share_percent": {
            "type": "number",
            "description": "Percent of total imports this product represents."
          }
        },
        "additionalProperties": true
      },
      "description": "5 entries on both fixtures captured, same shape as top_exports."
    },
    "country_code": {
      "type": "string",
      "description": "Two-letter ISO country code the endpoint resolved to, e.g. 'US', 'DE' -- note this differs from the three-letter code accepted as input ('USA', 'DEU' on the two fixtures captured)."
    },
    "country_name": {
      "type": "string"
    },
    "top_partners": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "type": {
            "type": "string",
            "description": "'export' or 'import' -- which direction this partner relationship represents. Observed as exactly one of these two values on both fixtures captured."
          },
          "country": {
            "type": "string"
          },
          "trade_value_usd": {
            "type": "number"
          }
        },
        "additionalProperties": true
      },
      "description": "5 entries on both fixtures captured, mixing export-direction and import-direction partners in one list rather than two separate lists."
    },
    "total_exports_usd": {
      "type": "number"
    },
    "total_imports_usd": {
      "type": "number"
    },
    "trade_balance_usd": {
      "type": "number",
      "description": "Exports minus imports; observed negative on the US fixture (a trade deficit) and positive on the Germany fixture (a trade surplus)."
    }
  },
  "description": "The country trade record, as returned at routing.responseResultPath ($.output).",
  "additionalProperties": true
}