> ## Documentation Index > Fetch the complete documentation index at: https://www.worldmonitor.app/docs/llms.txt > Use this file to discover all available pages before exploring further. # GetChinaCorridorControlTowers > GetChinaCorridorControlTowers composes reviewed China logistics corridors from existing source caches. Conditions retain canonical provenance and explicit unavailable states; the response never emits a single risk score. ## OpenAPI ````yaml /api/SupplyChainService.openapi.yaml get /api/supply-chain/v1/get-china-corridor-control-towers openapi: 3.1.0 info: title: SupplyChainService API version: 1.0.0 servers: - url: https://api.worldmonitor.app security: - WorldMonitorKey: [] - ApiKeyHeader: [] paths: /api/supply-chain/v1/get-china-corridor-control-towers: get: tags: - SupplyChainService summary: GetChinaCorridorControlTowers description: >- GetChinaCorridorControlTowers composes reviewed China logistics corridors from existing source caches. Conditions retain canonical provenance and explicit unavailable states; the response never emits a single risk score. operationId: GetChinaCorridorControlTowers parameters: - name: jmespath in: query description: >- Optional JMESPath expression applied server-side to project or reduce the JSON response before it is returned (mirrors the MCP jmespath argument). Invalid expressions, expressions larger than 1024 UTF-8 bytes, or projections that exceed the 256 KB output cap return HTTP 400 with a {_jmespath_error, original_keys} envelope. Grammar and worked examples: https://www.worldmonitor.app/docs/mcp-jmespath. required: false example: keys(@) schema: type: string responses: '200': description: Successful response content: application/json: example: generatedAt: '2026-07-25T12:00:00.000Z' payloadJson: >- {"generatedAt":"2026-07-25T12:00:00.000Z","corridors":[{"id":"china-yangtze-river-delta","name":"Yangtze River Delta","description":"Reviewed coastal logistics corridor joining Shanghai, Jiangsu, and Zhejiang gateways.","boundary":[{"lat":28.4,"lon":118.2},{"lat":28.4,"lon":123.2},{"lat":33.4,"lon":123.2},{"lat":33.4,"lon":118.2},{"lat":28.4,"lon":118.2}],"nodes":[{"id":"china-node:yrd-port-shanghai","name":"Shanghai","type":"port","lat":31.1918,"lon":121.6442,"sourceOwner":"IMF PortWatch","sourceSelector":{"family":"port","id":"port1188"}}],"availability":"partial","conditions":[{"family":"port","providerId":"portwatch","availability":"available","reason":null,"sourceSignals":[{"id":"signal:portwatch:port1188:2026-07-25T11:00:00.000Z","family":"port","selectorId":"port1188","availability":"available","publisher":{"id":"publisher:imf-portwatch","name":"IMF PortWatch","type":"official"},"sourceUrl":"https://portwatch.imf.org/","sourceScope":"node","observationTime":"2026-07-25T11:00:00.000Z","observationTimePrecision":"instant","releaseTime":null,"releaseTimePrecision":"unknown","retrievalTime":"2026-07-25T11:05:00.000Z","retrievalTimePrecision":"instant","revision":null,"transportFreshness":"fresh","contentFreshness":"current","summary":"PortWatch activity observation available for Shanghai.","metrics":{"tankerCalls30d":14}}],"provenance":{"contractVersion":"decision-signal-provenance/v1","signalId":"signal:corridor-condition:china-yangtze-river-delta:port:2026-07-25T11:00:00.000Z","familyId":"composed_corridor_condition","claims":{"publisher":{"status":"known","value":{"id":"publisher:worldmonitor-derived","name":"WorldMonitor derived output","type":"derived_output","registryReference":null}},"observation_time":{"status":"known","value":{"role":"observation","value":"2026-07-25T11:00:00.000Z","precision":"instant"}},"source_url":{"status":"not_applicable","reason":"The corridor condition links source URLs through its input signals."},"original_reference":{"status":"not_applicable","reason":"The corridor condition is composed from multiple source records."},"original_language":{"status":"not_applicable","reason":"The deterministic composition has no original-language text."},"translation":{"status":"not_applicable","reason":"The deterministic composition has no translated source text."},"effective_time":{"status":"known","value":{"role":"effective","value":"2026-07-25T11:00:00.000Z","precision":"instant"}},"publication_time":{"status":"not_applicable","reason":"The computed condition is not a publisher release."},"retrieval_time":{"status":"known","value":{"role":"retrieval","value":"2026-07-25T11:05:00.000Z","precision":"instant"}},"revision":{"status":"known","value":{"vintageId":"china-yangtze-river-delta:port:2026-07-25T11:00:00.000Z","sequence":1,"state":"original"}},"supersession":{"status":"known","value":{"state":"current"}},"extraction_confidence":{"status":"not_applicable","reason":"Each input signal owns its extraction confidence."},"classification_confidence":{"status":"known","value":{"score":1,"method":"exact-reviewed-selector/v1"}},"corroboration":{"status":"known","value":{"state":"single_source","sourceSignalIds":["signal:portwatch:port1188:2026-07-25T11:00:00.000Z"]}},"transport_freshness":{"status":"known","value":{"state":"fresh","assessedAt":"2026-07-25T12:00:00.000Z","lastSuccessAt":"2026-07-25T11:05:00.000Z"}},"content_freshness":{"status":"known","value":{"state":"current","assessedAt":"2026-07-25T12:00:00.000Z","contentAsOf":"2026-07-25T11:00:00.000Z"}},"derivation":{"status":"known","value":{"methodId":"worldmonitor:china-corridor-condition","methodVersion":"1","computedAt":"2026-07-25T12:00:00.000Z","inputSignalIds":["signal:portwatch:port1188:2026-07-25T11:00:00.000Z"]}}}}},{"family":"aviation","providerId":"provider:aviation","availability":"unavailable","reason":"No reviewed source observation is available in this example.","sourceSignals":[],"provenance":null},{"family":"hazard","providerId":"provider:hazard","availability":"unavailable","reason":"No reviewed source observation is available in this example.","sourceSignals":[],"provenance":null},{"family":"power_energy","providerId":"provider:power_energy","availability":"unavailable","reason":"No reviewed source observation is available in this example.","sourceSignals":[],"provenance":null},{"family":"strategic_industry","providerId":"provider:strategic_industry","availability":"unavailable","reason":"No reviewed source observation is available in this example.","sourceSignals":[],"provenance":null},{"family":"trade","providerId":"provider:trade","availability":"unavailable","reason":"No reviewed source observation is available in this example.","sourceSignals":[],"provenance":null}]},{"id":"china-greater-bay-area","name":"Greater Bay Area","description":"Reviewed Pearl River Delta corridor connecting Guangdong, Hong Kong, and Macao-facing port, airport, and industrial gateways.","boundary":[{"lat":20.5,"lon":111.5},{"lat":20.5,"lon":115.8},{"lat":24.8,"lon":115.8},{"lat":24.8,"lon":111.5},{"lat":20.5,"lon":111.5}],"nodes":[{"id":"china-node:gba-port-shekou","name":"Shekou Shenzhen","type":"port","lat":22.47,"lon":113.9,"sourceOwner":"IMF PortWatch","sourceSelector":{"family":"port","id":"port1189"}}],"availability":"partial","conditions":[{"family":"port","providerId":"portwatch","availability":"available","reason":null,"sourceSignals":[{"id":"signal:portwatch:port1189:2026-07-25T11:00:00.000Z","family":"port","selectorId":"port1189","availability":"available","publisher":{"id":"publisher:imf-portwatch","name":"IMF PortWatch","type":"official"},"sourceUrl":"https://portwatch.imf.org/","sourceScope":"node","observationTime":"2026-07-25T11:00:00.000Z","observationTimePrecision":"instant","releaseTime":null,"releaseTimePrecision":"unknown","retrievalTime":"2026-07-25T11:05:00.000Z","retrievalTimePrecision":"instant","revision":null,"transportFreshness":"fresh","contentFreshness":"current","summary":"PortWatch activity observation available for Shekou Shenzhen.","metrics":{"tankerCalls30d":14}}],"provenance":{"contractVersion":"decision-signal-provenance/v1","signalId":"signal:corridor-condition:china-greater-bay-area:port:2026-07-25T11:00:00.000Z","familyId":"composed_corridor_condition","claims":{"publisher":{"status":"known","value":{"id":"publisher:worldmonitor-derived","name":"WorldMonitor derived output","type":"derived_output","registryReference":null}},"observation_time":{"status":"known","value":{"role":"observation","value":"2026-07-25T11:00:00.000Z","precision":"instant"}},"source_url":{"status":"not_applicable","reason":"The corridor condition links source URLs through its input signals."},"original_reference":{"status":"not_applicable","reason":"The corridor condition is composed from multiple source records."},"original_language":{"status":"not_applicable","reason":"The deterministic composition has no original-language text."},"translation":{"status":"not_applicable","reason":"The deterministic composition has no translated source text."},"effective_time":{"status":"known","value":{"role":"effective","value":"2026-07-25T11:00:00.000Z","precision":"instant"}},"publication_time":{"status":"not_applicable","reason":"The computed condition is not a publisher release."},"retrieval_time":{"status":"known","value":{"role":"retrieval","value":"2026-07-25T11:05:00.000Z","precision":"instant"}},"revision":{"status":"known","value":{"vintageId":"china-greater-bay-area:port:2026-07-25T11:00:00.000Z","sequence":1,"state":"original"}},"supersession":{"status":"known","value":{"state":"current"}},"extraction_confidence":{"status":"not_applicable","reason":"Each input signal owns its extraction confidence."},"classification_confidence":{"status":"known","value":{"score":1,"method":"exact-reviewed-selector/v1"}},"corroboration":{"status":"known","value":{"state":"single_source","sourceSignalIds":["signal:portwatch:port1189:2026-07-25T11:00:00.000Z"]}},"transport_freshness":{"status":"known","value":{"state":"fresh","assessedAt":"2026-07-25T12:00:00.000Z","lastSuccessAt":"2026-07-25T11:05:00.000Z"}},"content_freshness":{"status":"known","value":{"state":"current","assessedAt":"2026-07-25T12:00:00.000Z","contentAsOf":"2026-07-25T11:00:00.000Z"}},"derivation":{"status":"known","value":{"methodId":"worldmonitor:china-corridor-condition","methodVersion":"1","computedAt":"2026-07-25T12:00:00.000Z","inputSignalIds":["signal:portwatch:port1189:2026-07-25T11:00:00.000Z"]}}}}},{"family":"aviation","providerId":"provider:aviation","availability":"unavailable","reason":"No reviewed source observation is available in this example.","sourceSignals":[],"provenance":null},{"family":"hazard","providerId":"provider:hazard","availability":"unavailable","reason":"No reviewed source observation is available in this example.","sourceSignals":[],"provenance":null},{"family":"power_energy","providerId":"provider:power_energy","availability":"unavailable","reason":"No reviewed source observation is available in this example.","sourceSignals":[],"provenance":null},{"family":"strategic_industry","providerId":"provider:strategic_industry","availability":"unavailable","reason":"No reviewed source observation is available in this example.","sourceSignals":[],"provenance":null},{"family":"trade","providerId":"provider:trade","availability":"unavailable","reason":"No reviewed source observation is available in this example.","sourceSignals":[],"provenance":null}]},{"id":"china-bohai-rim","name":"Bohai Rim","description":"Reviewed northern maritime-industrial corridor spanning Beijing-Tianjin, Hebei, Shandong, Liaoning, and their major gateways.","boundary":[{"lat":35.5,"lon":116},{"lat":35.5,"lon":123.5},{"lat":42.2,"lon":123.5},{"lat":42.2,"lon":116},{"lat":35.5,"lon":116}],"nodes":[{"id":"china-node:bohai-port-qingdao","name":"Qingdao","type":"port","lat":36.07,"lon":120.32,"sourceOwner":"IMF PortWatch","sourceSelector":{"family":"port","id":"port1069"}}],"availability":"partial","conditions":[{"family":"port","providerId":"portwatch","availability":"available","reason":null,"sourceSignals":[{"id":"signal:portwatch:port1069:2026-07-25T11:00:00.000Z","family":"port","selectorId":"port1069","availability":"available","publisher":{"id":"publisher:imf-portwatch","name":"IMF PortWatch","type":"official"},"sourceUrl":"https://portwatch.imf.org/","sourceScope":"node","observationTime":"2026-07-25T11:00:00.000Z","observationTimePrecision":"instant","releaseTime":null,"releaseTimePrecision":"unknown","retrievalTime":"2026-07-25T11:05:00.000Z","retrievalTimePrecision":"instant","revision":null,"transportFreshness":"fresh","contentFreshness":"current","summary":"PortWatch activity observation available for Qingdao.","metrics":{"tankerCalls30d":14}}],"provenance":{"contractVersion":"decision-signal-provenance/v1","signalId":"signal:corridor-condition:china-bohai-rim:port:2026-07-25T11:00:00.000Z","familyId":"composed_corridor_condition","claims":{"publisher":{"status":"known","value":{"id":"publisher:worldmonitor-derived","name":"WorldMonitor derived output","type":"derived_output","registryReference":null}},"observation_time":{"status":"known","value":{"role":"observation","value":"2026-07-25T11:00:00.000Z","precision":"instant"}},"source_url":{"status":"not_applicable","reason":"The corridor condition links source URLs through its input signals."},"original_reference":{"status":"not_applicable","reason":"The corridor condition is composed from multiple source records."},"original_language":{"status":"not_applicable","reason":"The deterministic composition has no original-language text."},"translation":{"status":"not_applicable","reason":"The deterministic composition has no translated source text."},"effective_time":{"status":"known","value":{"role":"effective","value":"2026-07-25T11:00:00.000Z","precision":"instant"}},"publication_time":{"status":"not_applicable","reason":"The computed condition is not a publisher release."},"retrieval_time":{"status":"known","value":{"role":"retrieval","value":"2026-07-25T11:05:00.000Z","precision":"instant"}},"revision":{"status":"known","value":{"vintageId":"china-bohai-rim:port:2026-07-25T11:00:00.000Z","sequence":1,"state":"original"}},"supersession":{"status":"known","value":{"state":"current"}},"extraction_confidence":{"status":"not_applicable","reason":"Each input signal owns its extraction confidence."},"classification_confidence":{"status":"known","value":{"score":1,"method":"exact-reviewed-selector/v1"}},"corroboration":{"status":"known","value":{"state":"single_source","sourceSignalIds":["signal:portwatch:port1069:2026-07-25T11:00:00.000Z"]}},"transport_freshness":{"status":"known","value":{"state":"fresh","assessedAt":"2026-07-25T12:00:00.000Z","lastSuccessAt":"2026-07-25T11:05:00.000Z"}},"content_freshness":{"status":"known","value":{"state":"current","assessedAt":"2026-07-25T12:00:00.000Z","contentAsOf":"2026-07-25T11:00:00.000Z"}},"derivation":{"status":"known","value":{"methodId":"worldmonitor:china-corridor-condition","methodVersion":"1","computedAt":"2026-07-25T12:00:00.000Z","inputSignalIds":["signal:portwatch:port1069:2026-07-25T11:00:00.000Z"]}}}}},{"family":"aviation","providerId":"provider:aviation","availability":"unavailable","reason":"No reviewed source observation is available in this example.","sourceSignals":[],"provenance":null},{"family":"hazard","providerId":"provider:hazard","availability":"unavailable","reason":"No reviewed source observation is available in this example.","sourceSignals":[],"provenance":null},{"family":"power_energy","providerId":"provider:power_energy","availability":"unavailable","reason":"No reviewed source observation is available in this example.","sourceSignals":[],"provenance":null},{"family":"strategic_industry","providerId":"provider:strategic_industry","availability":"unavailable","reason":"No reviewed source observation is available in this example.","sourceSignals":[],"provenance":null},{"family":"trade","providerId":"provider:trade","availability":"unavailable","reason":"No reviewed source observation is available in this example.","sourceSignals":[],"provenance":null}]},{"id":"china-western-land-sea-corridor","name":"Western Land-Sea Corridor","description":"Reviewed western corridor linking inland manufacturing hubs, Xinjiang land crossings, and Guangxi gateways to regional and maritime routes.","boundary":[{"lat":20.4,"lon":106.2},{"lat":20.4,"lon":110.4},{"lat":32.5,"lon":110.4},{"lat":47,"lon":91},{"lat":47,"lon":78.5},{"lat":41,"lon":78.5},{"lat":27,"lon":99.7},{"lat":22,"lon":105.8},{"lat":20.4,"lon":106.2}],"nodes":[{"id":"china-node:western-port-qinzhou","name":"Qinzhou","type":"port","lat":21.6788,"lon":108.6383,"sourceOwner":"IMF PortWatch","sourceSelector":{"family":"port","id":"port1071"}}],"availability":"partial","conditions":[{"family":"port","providerId":"portwatch","availability":"available","reason":null,"sourceSignals":[{"id":"signal:portwatch:port1071:2026-07-25T11:00:00.000Z","family":"port","selectorId":"port1071","availability":"available","publisher":{"id":"publisher:imf-portwatch","name":"IMF PortWatch","type":"official"},"sourceUrl":"https://portwatch.imf.org/","sourceScope":"node","observationTime":"2026-07-25T11:00:00.000Z","observationTimePrecision":"instant","releaseTime":null,"releaseTimePrecision":"unknown","retrievalTime":"2026-07-25T11:05:00.000Z","retrievalTimePrecision":"instant","revision":null,"transportFreshness":"fresh","contentFreshness":"current","summary":"PortWatch activity observation available for Qinzhou.","metrics":{"tankerCalls30d":14}}],"provenance":{"contractVersion":"decision-signal-provenance/v1","signalId":"signal:corridor-condition:china-western-land-sea-corridor:port:2026-07-25T11:00:00.000Z","familyId":"composed_corridor_condition","claims":{"publisher":{"status":"known","value":{"id":"publisher:worldmonitor-derived","name":"WorldMonitor derived output","type":"derived_output","registryReference":null}},"observation_time":{"status":"known","value":{"role":"observation","value":"2026-07-25T11:00:00.000Z","precision":"instant"}},"source_url":{"status":"not_applicable","reason":"The corridor condition links source URLs through its input signals."},"original_reference":{"status":"not_applicable","reason":"The corridor condition is composed from multiple source records."},"original_language":{"status":"not_applicable","reason":"The deterministic composition has no original-language text."},"translation":{"status":"not_applicable","reason":"The deterministic composition has no translated source text."},"effective_time":{"status":"known","value":{"role":"effective","value":"2026-07-25T11:00:00.000Z","precision":"instant"}},"publication_time":{"status":"not_applicable","reason":"The computed condition is not a publisher release."},"retrieval_time":{"status":"known","value":{"role":"retrieval","value":"2026-07-25T11:05:00.000Z","precision":"instant"}},"revision":{"status":"known","value":{"vintageId":"china-western-land-sea-corridor:port:2026-07-25T11:00:00.000Z","sequence":1,"state":"original"}},"supersession":{"status":"known","value":{"state":"current"}},"extraction_confidence":{"status":"not_applicable","reason":"Each input signal owns its extraction confidence."},"classification_confidence":{"status":"known","value":{"score":1,"method":"exact-reviewed-selector/v1"}},"corroboration":{"status":"known","value":{"state":"single_source","sourceSignalIds":["signal:portwatch:port1071:2026-07-25T11:00:00.000Z"]}},"transport_freshness":{"status":"known","value":{"state":"fresh","assessedAt":"2026-07-25T12:00:00.000Z","lastSuccessAt":"2026-07-25T11:05:00.000Z"}},"content_freshness":{"status":"known","value":{"state":"current","assessedAt":"2026-07-25T12:00:00.000Z","contentAsOf":"2026-07-25T11:00:00.000Z"}},"derivation":{"status":"known","value":{"methodId":"worldmonitor:china-corridor-condition","methodVersion":"1","computedAt":"2026-07-25T12:00:00.000Z","inputSignalIds":["signal:portwatch:port1071:2026-07-25T11:00:00.000Z"]}}}}},{"family":"aviation","providerId":"provider:aviation","availability":"unavailable","reason":"No reviewed source observation is available in this example.","sourceSignals":[],"provenance":null},{"family":"hazard","providerId":"provider:hazard","availability":"unavailable","reason":"No reviewed source observation is available in this example.","sourceSignals":[],"provenance":null},{"family":"power_energy","providerId":"provider:power_energy","availability":"unavailable","reason":"No reviewed source observation is available in this example.","sourceSignals":[],"provenance":null},{"family":"strategic_industry","providerId":"provider:strategic_industry","availability":"unavailable","reason":"No reviewed source observation is available in this example.","sourceSignals":[],"provenance":null},{"family":"trade","providerId":"provider:trade","availability":"unavailable","reason":"No reviewed source observation is available in this example.","sourceSignals":[],"provenance":null}]}]} upstreamUnavailable: false schema: $ref: '#/components/schemas/GetChinaCorridorControlTowersResponse' '400': description: Validation error content: application/json: schema: oneOf: - $ref: '#/components/schemas/ValidationError' - $ref: '#/components/schemas/JmespathProjectionError' '401': description: Missing or invalid API key. content: application/json: schema: $ref: '#/components/schemas/UnauthorizedError' '403': description: >- API access requires an active subscription (the API key's subscription is inactive or expired). content: application/json: schema: $ref: '#/components/schemas/ForbiddenError' '429': description: Rate limit exceeded. headers: X-RateLimit-Limit: description: Maximum requests allowed in the active rate-limit window. schema: type: string X-RateLimit-Remaining: description: Requests remaining in the active rate-limit window. schema: type: string X-RateLimit-Reset: description: >- Unix epoch milliseconds when the active rate-limit window resets. schema: type: string Retry-After: description: Seconds to wait before retrying the request. schema: type: string content: application/json: schema: oneOf: - $ref: '#/components/schemas/Error' - $ref: '#/components/schemas/RateLimitError' default: description: Gateway or handler error response. content: application/json: schema: oneOf: - $ref: '#/components/schemas/Error' - $ref: '#/components/schemas/GatewayError' components: schemas: GetChinaCorridorControlTowersResponse: type: object properties: payloadJson: contentMediaType: application/json contentSchema: $ref: '#/components/schemas/ChinaCorridorControlTowerResponse' type: string description: >- Canonical JSON keeps the shared #5581 provenance envelope byte-for-byte equivalent across cache, API, UI, and later MCP adapters. generatedAt: type: string upstreamUnavailable: description: >- True only when every reviewed corridor is unavailable. Agents and API callers must treat true as upstream degradation, not as evidence that corridor conditions are normal or zero. type: boolean ValidationError: type: object properties: violations: type: array items: $ref: '#/components/schemas/FieldViolation' description: List of validation violations required: - violations description: >- ValidationError is returned when request validation fails. It contains a list of field violations describing what went wrong. JmespathProjectionError: description: >- Returned when a REST jmespath projection is invalid or exceeds the expression/output byte limits. properties: _jmespath_error: description: Projection error discriminator and details. type: string original_keys: description: Top-level keys or shape of the unprojected response. items: type: string type: array required: - _jmespath_error - original_keys type: object UnauthorizedError: type: object properties: error: type: string description: Human-readable error message. required: - error description: >- Returned when the API key is missing, malformed, or lacks current API access. ForbiddenError: type: object properties: error: type: string description: Human-readable entitlement failure reason. requiredTier: type: integer format: int32 description: Minimum entitlement tier required for this endpoint. currentTier: type: integer format: int32 description: Caller entitlement tier when known. planKey: type: string description: Caller plan key when known. required: - error description: >- Returned when a PRO-gated endpoint denies access because the caller has no resolved authenticated user, entitlements cannot be verified, or the caller lacks the required entitlement tier. Error: type: object properties: message: type: string description: Error message (e.g., 'user not found', 'database connection failed') description: >- Error is returned when a handler encounters an error. It contains a simple error message that the developer can customize. RateLimitError: type: object description: Returned when a gateway or handler rate limit rejects the request. properties: error: type: string description: Human-readable rate-limit failure reason. required: - error GatewayError: type: object description: >- Returned by gateway infrastructure errors before an RPC handler runs, such as origin, routing, method, authentication, or quota checks. properties: error: oneOf: - type: string - type: object additionalProperties: true description: Gateway error reason or structured gateway failure details. required: - error FieldViolation: type: object properties: field: type: string description: >- The field path that failed validation (e.g., 'user.email' for nested fields). For header validation, this will be the header name (e.g., 'X-API-Key') description: type: string description: >- Human-readable description of the validation violation (e.g., 'must be a valid email address', 'required field missing') required: - field - description description: FieldViolation describes a single validation error for a specific field. securitySchemes: WorldMonitorKey: type: apiKey in: header name: X-WorldMonitor-Key description: User-issued WorldMonitor API key. ApiKeyHeader: type: apiKey in: header name: X-Api-Key description: Alias header for the WorldMonitor API key (X-WorldMonitor-Key). ````