API Documentation

Everything you need to integrate airline logos into your application.

Authentication

All API requests require authentication via an API key. Include your key in the request header.

curl -H "Authorization: Bearer YOUR_API_KEY" \
  https://airlinestream.dev/api/v1/logos/UA/s/200x200.png -o ua-logo.png

Base URL
https://airlinestream.dev/api/v1

GET /logos/:code/:type/:size.:format

Retrieve an airline logo image by IATA or ICAO code.

Name	In	Required	Description
`code`	path	Required	IATA (2-letter) or ICAO (3-letter) airline code
`type`	path	Required	Logo type: s (square) or r (rectangular)
`size`	path	Required	Dimensions in WxH format (e.g., 200x200)
`format`	path	Required	Image format: png, jpg, gif, or svg

(binary image data with appropriate Content-Type header)

Retrieve a 200×200 square logo for United Airlines using IATA code UA.

curl -H "Authorization: Bearer YOUR_API_KEY" \
  https://airlinestream.dev/api/v1/logos/UA/s/200x200.png

Response:

Fetch a rectangular 350×100 logo for Emirates.

curl -H "Authorization: Bearer YOUR_API_KEY" \
  https://airlinestream.dev/api/v1/logos/EK/r/350x100.png

Response:

Get a compact 100×100 square Lufthansa logo.

curl -H "Authorization: Bearer YOUR_API_KEY" \
  https://airlinestream.dev/api/v1/logos/LH/s/100x100.png

Response:

Code	Description
`400`	Bad request — invalid parameters or dimensions
`401`	Unauthorized — missing or invalid API key
`403`	Forbidden — your plan does not allow this resource
`404`	Not found — airline code does not exist
`429`	Too many requests — rate limit exceeded
`502`	Bad gateway — upstream logo service unavailable

Rate limits depend on your subscription tier. The Starter plan allows 1,000 requests per month. Paid plans range from 50,000 to unlimited.

Get Your API Key