# aviationapis ACARS Message Decoder

> aviationapis ACARS Message Decoder is a paid API for AI agents from aviationapis.com, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-15).

Decodes and parses raw ACARS aircraft messages, extracting structured data such as position, altitude, label description, and coordinates

## Facts

- Endpoint: POST https://aviationapis.com/decode-acars
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/aviationapis-acars-message-decoder-bf1e36de
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_aIVIat80sUuzErFF2C01o

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability aviationapis-acars-message-decoder-bf1e36de -d '<json body>'
```

Example prompt: Decode this ACARS message for me — label '80', text 'POS N3742.5 W12222.1/ALT 37000/UAL123' — and tell me the aircraft's position, altitude, and what that label means.

## When to prefer this

Use this endpoint when you have a raw or partially structured ACARS message and need to extract machine-readable position, altitude, or operational data from it. Ideal for aviation monitoring systems, flight tracking pipelines, or AI agents processing aircraft datalink messages in real time.

## Known failure modes

- Malformed or unrecognized ACARS message text returns parsing error
- Missing both 'raw' and 'text' fields results in bad request
- Unsupported or unknown ACARS label may return null label_description
- Payment failure via x402 protocol results in 402 response before processing

## How this service works

Pay-per-call aviation data APIs for AI agents, settled in USDC via the x402 protocol.

## Output

Returns a structured JSON object containing the decoded ACARS message fields including latitude, longitude, altitude in feet, label description (e.g. 'Position report'), and the original text and label echoed back.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "raw": {
   "type": "string",
   "description": "Alternatively, the full raw message"
  },
  "text": {
   "type": "string",
   "description": "The ACARS message text/body"
  },
  "label": {
   "type": "string",
   "description": "ACARS message label, e.g. '80', 'H1', 'A9', '5Z'"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "raw": null,
  "text": "POS N3742.5 W12222.1/ALT 37000/UAL123",
  "label": "80",
  "latitude": 37.425,
  "longitude": -122.221,
  "altitude_ft": 37000,
  "label_description": "Position report"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/aviationapis-acars-message-decoder-bf1e36de/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from aviationapis.com](https://www.zero.xyz/host/aviationapis.com/llms.txt)
