# 2s.io Aircraft Lookup by Tail Number or ICAO24

> 2s.io Aircraft Lookup by Tail Number or ICAO24 is a paid API for AI agents from 2s.io, paid per call via x402, $0.00144/call, status unknown (last checked 2026-09-14).

Look up a US-registered aircraft's airframe details by tail number (N-number) or ICAO24 Mode-S hex address

## Facts

- Endpoint: GET https://2s.io/api/aircraft/lookup
- Price: $0.00144/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/2s-io-aircraft-lookup-by-tail-number-or-icao24-5f65e19c
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_FWkOCHBYwPcdC535aRkx0

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 2s-io-aircraft-lookup-by-tail-number-or-icao24-5f65e19c
```

Example prompt: Can you look up the aircraft registration details for tail number N757F — I want to know the manufacturer, model, owner, and its ICAO24 Mode-S hex address so I can track it on ADS-B feeds?

## When to prefer this

Use this endpoint when you need to identify or enrich metadata for a US-registered aircraft from either its tail/N-number or its ICAO24 Mode-S transponder address. Ideal for enriching live ADS-B flight-tracking feeds with airframe metadata, identifying aircraft spotted visually or on radar, or verifying registration details. Best for US aircraft only — non-US registrations will not be found.

## Known failure modes

- 404 Not Found — no aircraft matches the provided tail number or icao24 hex (unregistered, deregistered, or non-US aircraft)
- 400 / validation error — neither or both of `tail` and `icao24` were provided (exactly one required)
- Invalid format for icao24 (must be 6-character hex string) or tail (must be a valid N-number)
- Aircraft exists in FAA records but not yet in the OpenSky database snapshot (~307k coverage, not 100% of all registered aircraft)

## How this service works

Look up a US-registered aircraft by tail number (N-number, e.g. N757F) or icao24 Mode-S hex (e.g. aa3487). Pass exactly one of `tail` or `icao24`. Returns the airframe: registration, manufacturer, model, ICAO type code + class, serial number, operator, owner, build year, engines, category, plus the icao24 Mode-S address that ADS-B transponders broadcast — use it to join live flight-tracking feeds. ~307k US airframes. 404 if no match. Source: OpenSky Network aircraft database (CC-BY-SA).

## Output

Returns a JSON object with the aircraft's FAA registration details including: tail/N-number, ICAO24 Mode-S hex address, manufacturer name, model, ICAO type code and class, serial number, operator, owner, build year, engine configuration, and aircraft category. Returns HTTP 404 if no matching aircraft is found. Covers ~307k US-registered airframes.

## Example request

```json
{
 "input": {
  "type": "http",
  "method": "GET",
  "queryParams": {
   "tail": "N757F"
  }
 }
}
```

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method",
    "queryParams"
   ],
   "properties": {
    "type": {
     "const": "http"
    },
    "method": {
     "const": "GET"
    },
    "queryParams": {
     "properties": {
      "tail": {
       "type": "string",
       "description": "Tail / N-number (e.g. N757F). Case-insensitive."
      },
      "icao24": {
       "type": "string",
       "description": "24-bit Mode-S hex (e.g. aa3487)."
      }
     }
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/2s-io-aircraft-lookup-by-tail-number-or-icao24-5f65e19c/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from 2s.io](https://www.zero.xyz/host/2s.io/llms.txt)