> ## 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. # ListAircraftEmergencies > ListAircraftEmergencies returns reported 7500, 7600 and 7700 signals independently of military classification. The 200 schema describes the unprojected response. With jmespath, the result may instead be any JSON value, including an array, scalar, or null. ## OpenAPI ````yaml /api/AviationService.openapi.yaml get /api/aviation/v1/list-aircraft-emergencies openapi: 3.1.0 info: title: AviationService API version: 1.0.0 servers: - url: https://api.worldmonitor.app security: - WorldMonitorKey: [] - ApiKeyHeader: [] paths: /api/aviation/v1/list-aircraft-emergencies: get: tags: - AviationService summary: ListAircraftEmergencies description: >- ListAircraftEmergencies returns reported 7500, 7600 and 7700 signals independently of military classification. The 200 schema describes the unprojected response. With jmespath, the result may instead be any JSON value, including an array, scalar, or null. operationId: ListAircraftEmergencies 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: feeds: - fetchedAt: 1717200000000 message: Synthetic example. source: adsb.lol squawk: '7500' status: available - fetchedAt: 1717200000000 message: Synthetic example. source: adsb.lol squawk: '7600' status: available - fetchedAt: 1717200000000 message: Synthetic example. source: adsb.lol squawk: '7700' status: available observations: - address: a00001 callsign: SYNTHETIC description: Synthetic example. No observed incident. militaryFlag: unknown observedAt: 0 source: adsb.lol squawk: '7500' schema: $ref: '#/components/schemas/ListAircraftEmergenciesResponse' '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). headers: X-Billing-Verification: description: >- Present when the 403 is a billing-provider-confirmed subscription lapse (value subscription_lapsed, matching the body `code`). schema: type: string 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' '503': description: >- Service unavailable. Billing-verification responses include code and X-Billing-Verification; other gateway infrastructure failures use the generic GatewayError shape. headers: Retry-After: description: Seconds to wait before retrying (1-60). schema: type: string X-Billing-Verification: description: >- Billing-verification state that produced this response (matches the body `code`). schema: type: string X-Validation-Mode: description: >- Present with value degraded when user API-key validation is temporarily unavailable. schema: type: string X-RateLimit-Mode: description: >- Present with value degraded when a fail-closed rate-limit dependency is unavailable. schema: type: string content: application/json: schema: oneOf: - $ref: '#/components/schemas/BillingVerificationError' - $ref: '#/components/schemas/GatewayError' default: description: Gateway or handler error response. content: application/json: schema: oneOf: - $ref: '#/components/schemas/Error' - $ref: '#/components/schemas/GatewayError' components: schemas: ListAircraftEmergenciesResponse: type: object properties: observations: type: array items: $ref: '#/components/schemas/EmergencyObservation' feeds: type: array items: $ref: '#/components/schemas/EmergencyFeed' description: >- ListAircraftEmergenciesResponse preserves observations and per-query availability. 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. code: type: string enum: - subscription_lapsed description: >- Machine-readable denial code, present when the 403 is a billing-provider-confirmed subscription lapse (mirrored in the X-Billing-Verification response header). 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 BillingVerificationError: type: object description: >- Returned with HTTP 503 when paid access cannot be confirmed right now: the billing provider is re-verifying a recently expired subscription, or the entitlement backend is unreachable. Retryable — honor Retry-After. properties: error: type: string description: Human-readable billing-verification failure reason. code: type: string enum: - renewal_verification_pending - renewal_verification_failed - entitlement_verification_unavailable description: >- Machine-readable billing-verification state, mirrored in the X-Billing-Verification response header. requiredTier: type: integer format: int32 description: >- Minimum entitlement tier required for this endpoint, when the denial came from a tier gate. required: - error - code 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 EmergencyObservation: type: object properties: address: type: string description: Provider address, including a non-ICAO prefix when present. squawk: type: string description: Exact four-character transponder code. source: type: string description: Observation provider. observedAt: type: integer format: int64 description: >- Last message time in epoch milliseconds, not squawk selection time. Zero means unknown.. Warning: Values > 2^53 may lose precision in JavaScript position: $ref: '#/components/schemas/EmergencyPosition' callsign: type: string description: Reported callsign, empty when unknown. registration: type: string description: Provider registration, empty when unknown. aircraftType: type: string description: Provider type code, empty when unknown. description: type: string description: Provider aircraft description, empty when unknown. militaryFlag: type: string description: >- Military database bit, set, not_set, or unknown. This is not admission criteria. altitudeFt: type: number format: double description: >- Barometric altitude in feet, absent when unknown or reported as ground. groundSpeedKts: type: number format: double description: Ground speed in knots, absent when unknown. description: >- EmergencyObservation is a reported Mode A code, not a confirmed incident. EmergencyFeed: type: object properties: source: type: string description: Provider name. squawk: type: string description: Requested squawk. status: type: string description: available, unavailable, or stale. fetchedAt: type: integer format: int64 description: >- Retrieval time in epoch milliseconds.. Warning: Values > 2^53 may lose precision in JavaScript message: type: string description: Safe status explanation. description: >- EmergencyFeed records success and failure separately for each exact code query. 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. EmergencyPosition: type: object properties: lat: type: number format: double description: Latitude in degrees. lon: type: number format: double description: Longitude in degrees. observedAt: type: integer format: int64 description: >- Provider position time in epoch milliseconds. Zero means unknown.. Warning: Values > 2^53 may lose precision in JavaScript description: EmergencyPosition keeps the position clock separate from last contact. 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). ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.