---
title: "Retrieves airline based on code (IATA or ICAO)"
url: "https://developer.schiphol.nl/apis/schiphol-public-flight-api-4-public-prd/versions/7e467a47-1065-4998-b293-ef9bb4efbe24/operations/getAirlinesByCode"
---

> Full API specification: https://developer.schiphol.nl/apis/schiphol-public-flight-api-4-public-prd/versions/7e467a47-1065-4998-b293-ef9bb4efbe24.md

# Retrieves airline based on code (IATA or ICAO)

`GET` `/airlines/{airline}`

Operation ID: `getAirlinesByCode`

Retrieve airline based on IATA code or ICAO code.

## Path parameters

- `airline` (string, required) - IATA / ICAO code

## Header parameters

- `Accept` (string, required) - Only 'application/json' is allowed

## Responses

- `200` - OK
- `400` - Bad request
- `404` - Not Found

## OpenAPI definition

```yaml
openapi: 3.0.1
info:
  title: Schiphol Public Flight API
  version: 4.2.0
servers:
  - url: https://{environment}.schiphol.nl/public/public-flights/v4
    variables:
      environment:
        enum:
          - api
          - api-acc
        default: api
paths:
  /airlines/{airline}:
    get:
      summary: Retrieves airline based on code (IATA or ICAO)
      description: Retrieve airline based on IATA code or ICAO code.
      operationId: getAirlinesByCode
      parameters:
        - $ref: "#/components/parameters/AcceptHeader"
        - name: airline
          in: path
          description: IATA / ICAO code
          required: true
          schema:
            maxLength: 3
            minLength: 2
            type: string
      responses:
        "200":
          description: OK
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Airline"
        "400":
          description: Bad request
          content: {}
        "404":
          description: Not Found
          content: {}
security:
  - bearerAuth: []
components:
  parameters:
    AcceptHeader:
      name: Accept
      in: header
      description: Only 'application/json' is allowed
      required: true
      style: simple
      schema:
        type: string
        example: application/json
  schemas:
    Airline:
      type: object
      properties:
        iata:
          type: string
        icao:
          type: string
        nvls:
          type: integer
          format: int64
        publicName:
          type: string
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
```