DTN PIREP API

openapi: 3.2.0
info:
  title: Dtn PIREP API
  version: '1.0'
  description: 'Operations tagged PIREP across 2 of this provider''s published API definitions: dtn-pireps-api-openapi.json, dtn-websocket-api-openapi.json. Each path carries the servers of the definition it was published in.'
servers:
- url: https://aviation.api.dtn.com
security:
- clientCredentials: []
tags:
- name: PIREP
  description: On demand PIREPS via API
paths:
  /v1/pireps/:
    get:
      tags:
      - PIREP
      summary: Get active PIREPs
      description: Get all available PIREPs, potentially filtered by various query parameters.  All specified filter parameters must be satisfied for an object to be returned in the response.  For some PIREPs coordinate locations can not be determined, thus they will have longitude=0 & latitude=0 in output and thus would not be correctly obtained by a spatial filter.  Most data fields will not be present when they have no defined value.
      responses:
        '200':
          $ref: '#/components/responses/PirepSuccess'
        '400':
          $ref: '#/components/responses/PirepBadRequest'
        '401':
          $ref: '#/components/responses/ErrorUnauthorized'
      parameters:
      - $ref: '#/components/parameters/QueryOffset'
      - $ref: '#/components/parameters/QueryLimit'
      - $ref: '#/components/parameters/QueryPirepUnitSystem'
      - $ref: '#/components/parameters/QueryBbox'
      - $ref: '#/components/parameters/QueryPolygon'
      - $ref: '#/components/parameters/QueryCircle'
      - $ref: '#/components/parameters/QueryCorridor'
      - $ref: '#/components/parameters/QueryDistanceUnits'
      - $ref: '#/components/parameters/QueryIsValidAt'
      - $ref: '#/components/parameters/QueryInsertedAfter'
      - $ref: '#/components/parameters/QueryInsertedThrough'
      - $ref: '#/components/parameters/QueryAircraftTypes'
      - $ref: '#/components/parameters/QueryAircraftSizes'
      - $ref: '#/components/parameters/QueryNavaidIds'
      - $ref: '#/components/parameters/QueryMinFlightLevelFt'
      - $ref: '#/components/parameters/QueryMaxFlightLevelFt'
      - $ref: '#/components/parameters/QueryMinTurbulenceScore'
      - $ref: '#/components/parameters/QueryMaxTurbulenceScore'
      - $ref: '#/components/parameters/QueryMinIcingScore'
      - $ref: '#/components/parameters/QueryMaxIcingScore'
      security:
      - clientCredentials: []
    servers:
    - url: https://aviation.api.dtn.com
components:
  parameters:
    QueryMinTurbulenceScore:
      name: minTurbulenceScore
      description: Minimum turbulence score.  Limits to objects whose `turbulenceScore` is greater than or equal to this.
      in: query
      required: false
      schema:
        type: integer
        minimum: 0
        maximum: 10
    QueryInsertedThrough:
      name: insertedThrough
      description: UTC timestamp in format `YYYY-MM-DD hh:mm:ss.fff`.  Limits to objects whose `insertedDateTime` is not later than that specified value.  This allows to acquire only data that became available through this time.  Requires use of fractional seconds for full precision.  Allowed values relative to the current time vary depending on the data type.  A data insertion time value being accepted through this parameter does not mean there will be applicable data to return in response.
      in: query
      required: false
      schema:
        type: string
        pattern: ^\d{4}-\d{2}-\d{2} \d{2}:\d{2}:\d{2}(\.\d+)?
    QueryMaxIcingScore:
      name: maxIcingScore
      description: Maximum icing score.  Limits to objects whose `icingScore` value is less than or equal to this.
      in: query
      required: false
      schema:
        type: integer
        minimum: 0
        maximum: 10
    QueryInsertedAfter:
      name: insertedAfter
      description: UTC timestamp in format `YYYY-MM-DD hh:mm:ss.fff`.  Limits to objects whose `insertedDateTime` is later than that specified value.  This allows to acquire only data that became available after this time.  Requires use of fractional seconds for full precision.  Allowed values relative to the current time vary depending on the data type.  A data insertion time value being accepted through this parameter does not mean there will be applicable data to return in response.
      in: query
      required: false
      schema:
        type: string
        pattern: ^\d{4}-\d{2}-\d{2} \d{2}:\d{2}:\d{2}(\.\d+)?
    QueryPirepUnitSystem:
      name: unitSystem
      description: 'Identifier for units system used for numerical output values in PIREP.  Must be either `default` or `metric`.  Default is `default`.  Field units depending on unit system:<br>                * `temperature`: default=`degC`, metric=`degC`<br>                * `visibility`: default=`mi`, metric=`m`<br>                * `windSpeed`: default=`kts`, metric=`m/s`<br>                * `flightLevel`: default=`ft`, metric=`m`<br>                * `turbulenceBase#`/`turbulenceTop#`: default=`ft`, metric=`m`<br>                * `icingBase#`/`icingTop#`: default=`ft`, metric=`m`<br>                * `weatherBase#`/`weatherTop#`: default=`ft`, metric=`m`<br>                * `coverageBase#`/`coverageTop#`: default=`ft`, metric=`m`'
      in: query
      required: false
      explode: false
      schema:
        type: string
        enum:
        - default
        - metric
        default: default
    QueryIsValidAt:
      name: isValidAt
      description: UTC timestamp in format `YYYY-MM-DD hh:mm:ss`.  Limits to objects whose `validDateTime` is not earlier than the specified value and whose `expirationDateTime` is later than that specified value.  Allowed values relative to the current time vary depending on the data type.  A valid time value being accepted through this parameter does not mean there will be applicable data to return in response.
      in: query
      required: false
      schema:
        type: string
        pattern: ^\d{4}-\d{2}-\d{2} \d{2}:\d{2}:\d{2}
    QueryLimit:
      name: limit
      description: Provide no more than this many items in the response set.
      in: query
      required: false
      schema:
        type: integer
        default: 1000
        minimum: 1
        maximum: 10000
    QueryBbox:
      name: bbox
      description: Bounding box coordinates in the format `<min_X>,<min_Y>,<max_X>,<max_Y>`.  The `X,Y` coordinates must be consistent with the `srid` (`4326` for longitude/latitude by default).  Limits to objects within or intersecting the area so defined.  No more than one of `bbox`, `polygon`, `circle`, and `corridor` may be used in one request.  Requests with bbox definition of area that crosses antimeridian will fail.
      in: query
      required: false
      schema:
        type: string
    QueryCircle:
      name: circle
      description: Circle coordinates and radius distance in the format `<X>,<Y>,<RADIUS>`.  The `X,Y` coordinates must be consistent with the `srid` (`4326` for longitude/latitude by default).  The `<RADIUS>` defines the distance (in default or `distanceUnits`-specified units) from the defined point.  Limits to objects within or intersecting the area so defined.  No more than one of `bbox`, `polygon`, `circle`, and `corridor` may be used in one request.  Requests with circle definition of area that crosses antimeridian will fail.  The larger the defined area, the more its shape on projected map will differ from true circle on spherical coordinates.  Maximum allowed <RADIUS> is 400nm (and equal lengths for different `distanceUnits`).
      in: query
      required: false
      schema:
        type: string
    QueryPolygon:
      name: polygon
      description: Polygon coordinates in the format `<X_0>,<Y_0>,<X_1>,<Y_1>...,<X_n>,<Y_n>`.  The `X,Y` coordinates must be consistent with the `srid` (`4326` for longitude/latitude by default).  Must provide between 3 and 40 coordinates.  If the last `X,Y` does not match the first `X,Y`, the first `X,Y` is copied to the end to close the polygon.  Limits to objects within or intersecting the area so defined.  No more than one of `bbox`, `polygon`, `circle`, and `corridor` may be used in one request.  Requests with polygon definition of area that crosses antimeridian will fail or give unexpected results.
      in: query
      required: false
      schema:
        type: string
    QueryAircraftTypes:
      name: aircraftTypes
      description: Comma-separated list of aircraft type values.  Limits to objects whose `aircraftType` value matches one of specified parameter values.  Note that aircraftType is not specified properly and cannot be obtained for all reports.
      in: query
      required: false
      schema:
        type: string
    QueryMaxFlightLevelFt:
      name: maxFlightLevelFt
      description: Maximum flight level in feet.  Limits to objects whose `flightLevel` value is less than or equal to this.  Must set value in knots even if output `unitSystem` would not give response in feet.
      in: query
      required: false
      schema:
        type: integer
        minimum: 0
        maximum: 60000
    QueryOffset:
      name: offset
      description: Skip over this many into the response set; used for paginated results.
      in: query
      required: false
      schema:
        type: integer
        default: 0
    QueryNavaidIds:
      name: navaidIds
      description: Comma-separated list of Navaid identifier values.  Limits to objects whose `navaidId` value matches one of specified parameter values.
      in: query
      required: false
      schema:
        type: string
    QueryMaxTurbulenceScore:
      name: maxTurbulenceScore
      description: Maximum turbulence score.  Limits to objects whose `turbulenceScore` value is less than or equal to this.
      in: query
      required: false
      schema:
        type: integer
        minimum: 0
        maximum: 10
    QueryMinFlightLevelFt:
      name: minFlightLevelFt
      description: Minimum flight level in feet.  Limits to objects whose `flightLevel` is greater than or equal to this.  Must set value in feet even if output `unitSystem` would not give response in feet.
      in: query
      required: false
      schema:
        type: integer
        minimum: 0
        maximum: 60000
    QueryCorridor:
      name: corridor
      description: Line coordinates and distance from the line in the format `<X_0>,<Y_0>,<X_1>,<Y_1>...,<X_n>,<Y_n>,<HALFWIDTH>`.  The `X,Y` coordinates must be consistent with the `srid` (`4326` for longitude/latitude by default).  Must provide between 2 and 40 coordinates for the line.  The `<HALFWIDTH>` defines the distance (in default or `distanceUnits`-specified units) from the line defined by the coordinates out to which to create encompassing shape.  Limits to objects within or intersecting the area so defined.  No more than one of `bbox`, `polygon`, `circle`, and `corridor` may be used in one request.  Requests with corridor definition of area that crosses antimeridian will fail or give unexpected results.  The larger the defined area, the more its shape on projected map will differ from true corridor on spherical coordinates.  Maximum allowed <HALFWIDTH> is 200nm (and equal lengths for different `distanceUnits`).
      in: query
      required: false
      schema:
        type: string
    QueryDistanceUnits:
      name: distanceUnits
      description: Units identifier for distances in definition for circle or corridor spatial filter.  Default is `nm` (nautical miles).
      in: query
      required: false
      schema:
        type: string
        enum:
        - nm
        - km
        - m
        - sm
        default: nm
    QueryMinIcingScore:
      name: minIcingScore
      description: Minimum icing score.  Limits to objects whose `icingScore` is greater than or equal to this.
      in: query
      required: false
      schema:
        type: integer
        minimum: 0
        maximum: 10
    QueryAircraftSizes:
      name: aircraftSizes
      description: Comma-separated list of aircraft size values.  Limits to objects whose `aircraftSize` value matches one of specified parameter values.  Note that aircraftSize cannot be determined based on aircraftType for all reports, but can use `null` to include reports with undefined aircraftSize.
      in: query
      required: false
      schema:
        type: array
        items:
          type: string
          enum:
          - S
          - I
          - L
          - 'null'
    QueryLimit_2:
      name: limit
      description: Provide no more than this many items in the response set.  Default = 1000
      in: query
      required: false
      schema:
        type: integer
        default: 1000
        minimum: 1
        maximum: 10000
    QueryOffset_2:
      name: offset
      description: Skip over this many into the response set; used for paginated results.  Default = 0
      in: query
      required: false
      schema:
        type: integer
        default: 0
    QueryStationId:
      name: stationId
      description: Station identifier, e.g., `KIND`, `CYYC`
      in: query
      required: true
      schema:
        type: string
  schemas:
    Meta:
      title: Meta
      description: Meta data attached to every response
      required:
      - name
      - request_id
      - start_timestamp
      - end_timestamp
      - execution_time
      type: object
      properties:
        name:
          type: string
        request_id:
          type: string
        start_timestamp:
          type: integer
        end_timestamp:
          type: integer
        execution_time:
          type: integer
    GeoJsonObject:
      description: 'GeoJSon object The coordinate reference system for all GeoJSON coordinates is a geographic coordinate reference system, using the World Geodetic System 1984 (WGS 84) datum, with longitude and latitude units of decimal degrees. This is equivalent to the coordinate reference system identified by the Open Geospatial Consortium (OGC) URN An OPTIONAL third-position element SHALL be the height in meters above or below the WGS 84 reference ellipsoid. In the absence of elevation values, applications sensitive to height or depth SHOULD interpret positions as being at local ground or sea level.

        '
      externalDocs:
        url: https://tools.ietf.org/html/rfc7946#section-3
      type: object
      properties:
        type:
          type: string
          enum:
          - Feature
          - FeatureCollection
          - Point
          - MultiPoint
          - LineString
          - MultiLineString
          - Polygon
          - MultiPolygon
          - GeometryCollection
        bbox:
          description: 'A GeoJSON object MAY have a member named "bbox" to include information on the coordinate range for its Geometries, Features, or FeatureCollections. The value of the bbox member MUST be an array of length 2*n where n is the number of dimensions represented in the contained geometries, with all axes of the most southwesterly point followed by all axes of the more northeasterly point. The axes order of a bbox follows the axes order of geometries.

            '
          type: array
          items:
            type: number
      required:
      - type
      discriminator:
        propertyName: type
    PirepItem:
      type: object
      required:
      - validDateTime
      - insertedDateTime
      - navaidId
      - aircraftType
      - aircraftSize
      - flightLevel
      - flightLevelType
      - turbulenceScore
      - icingScore
      - rawTxt
      properties:
        validDateTime:
          type: string
          format: date-time
        insertedDateTime:
          type: string
          format: date-time
        navaidId:
          type: string
        aircraftType:
          type: string
        aircraftSize:
          type: string
        flightLevel:
          type: number
        flightLevelType:
          type: string
        turbulenceScore:
          type: number
        icingScore:
          type: number
        rawTxt:
          type: string
        temperature:
          type: number
        windSpeed:
          type: number
        windDirection:
          type: number
        visibility:
          type: number
    PirepFeature:
      description: GeoJSon 'Feature' object
      externalDocs:
        url: https://tools.ietf.org/html/rfc7946#section-3.2
      allOf:
      - $ref: '#/components/schemas/GeoJsonObject'
      - type: object
        required:
        - geometry
        - properties
        properties:
          geometry:
            allOf:
            - {}
            - $ref: '#/components/schemas/Geometry'
          properties:
            $ref: '#/components/schemas/PirepItem'
          id:
            oneOf:
            - type: number
            - type: string
    PirepFeatureCollection:
      description: GeoJSon 'FeatureCollection' object
      externalDocs:
        url: https://tools.ietf.org/html/rfc7946#section-3.3
      allOf:
      - $ref: '#/components/schemas/GeoJsonObject'
      - type: object
        required:
        - features
        properties:
          features:
            type: array
            items:
              $ref: '#/components/schemas/PirepFeature'
    Geometry:
      type: object
      description: GeoJSon geometry
      discriminator:
        propertyName: type
      required:
      - type
      externalDocs:
        url: http://geojson.org/geojson-spec.html#geometry-objects
      properties:
        type:
          type: string
          enum:
          - Point
          - LineString
          - Polygon
          - MultiPoint
          - MultiLineString
          - MultiPolygon
          description: the geometry type
    Error:
      title: Error
      description: Error
      required:
      - type
      - title
      - status
      - detail
      - meta
      type: object
      properties:
        url:
          type: string
        type:
          enum:
          - internal-server-error
          - unauthorized
          - bad-request
          - service-unavailable
          - forbidden
          - not-found
          type: string
        title:
          type: string
        status:
          type: number
        detail:
          type: string
        instance:
          type: string
        errors:
          type: array
          items:
            type: object
        meta:
          $ref: '#/components/schemas/Meta'
    PirepItem_2:
      type: object
      required:
      - raw_text
      - typeOfAircraft
      - stationId
      - issueOffice
      - validDateTime
      - flightLevelLow
      - flightLevelHigh
      properties:
        raw_text:
          type: string
        typeOfAircraft:
          type: string
        stationId:
          type: string
        issueOffice:
          type: string
        validDateTime:
          type: string
          format: date-time
        flightLevelLow:
          type: number
        flightLevelHigh:
          type: number
  responses:
    ErrorUnauthorized:
      description: Unauthorized
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
          example:
            type: unauthorized
            title: Error while authenticating the user
            status: 401
            detail: Missing Authorization token.
            instance: urn:dtn:aviation-api:/v1/notams/KIND:requestId:19e1b83a-cb2e-4460-b687-ce9d0c50b4b6
            meta:
              name: v1.notams.KIND
              uuid: d64fc634-9bee-430d-8ab1-200337e6e9b2
              request_id: 19e1b83a-cb2e-4460-b687-ce9d0c50b4b6
              start_timestamp: 1714019217213
              end_timestamp: 1714019217246
              execution_time: 33
    PirepSuccess:
      description: Successful
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/PirepFeatureCollection'
          examples:
            Success:
              $ref: '#/components/examples/PirepSuccessResponse'
    PirepBadRequest:
      description: Bad Request
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
          examples:
            BadRequest:
              $ref: '#/components/examples/PirepBadRequestResponse'
  examples:
    PirepSuccessResponse:
      value:
        url: https://aviation.api.dtn.com/v1/pireps/?distanceUnits=nm&navaidIds=OWB,EVV
        type: FeatureCollection
        features:
        - type: Feature
          geometry:
            type: Point
            coordinates:
            - -87.167
            - 37.74
          properties:
            navaidId: OWB
            aircraftType: MD11
            aircraftSize: L
            rawTxt: EVV UA /OV OWB/TM 1752/FL190/TP MD11/TB NEG
            validDateTime: '2025-01-23T17:52:00.000Z'
            insertedDateTime: '2025-01-23T18:02:03.000Z'
            flightLevel: 19000
            flightLevelType: LEVEL
            turbulenceScore: 1
            icingScore: 0
            turbulenceBase1: 19000
            turbulenceTop1: 19000
            turbulenceIntensity1: NEG
            unitSystem: default
        - type: Feature
          geometry:
            type: Point
            coordinates:
            - -87.531
            - 38.038
          properties:
            navaidId: EVV
            aircraftType: CRJ2
            aircraftSize: I
            rawTxt: EVV UA /OV EVV/TM 1921/FLDURD/TP CRJ2/SK BKN050-TOPS068
            validDateTime: '2025-01-23T19:21:00.000Z'
            insertedDateTime: '2025-01-23T19:25:39.000Z'
            flightLevel: 0
            flightLevelType: DURD
            turbulenceScore: 0
            icingScore: 0
            coverage1: BKN
            coverageBase1: 5000
            coverageTop1: 6800
            unitSystem: default
        - type: Feature
          geometry:
            type: Point
            coordinates:
            - -87.167
            - 37.74
          properties:
            navaidId: OWB
            aircraftType: CL60
            aircraftSize: I
            rawTxt: OWB UA /OV OWB/TM 1859/FL230/TP CL60/TB NEG
            validDateTime: '2025-01-23T18:59:00.000Z'
            insertedDateTime: '2025-01-23T19:32:08.000Z'
            flightLevel: 23000
            flightLevelType: LEVEL
            turbulenceScore: 1
            icingScore: 0
            turbulenceBase1: 23000
            turbulenceTop1: 23000
            turbulenceIntensity1: NEG
            unitSystem: default
        - type: Feature
          geometry:
            type: Point
            coordinates:
            - -87.531
            - 38.038
          properties:
            navaidId: EVV
            aircraftType: PC12
            aircraftSize: S
            rawTxt: EVV UA /OV EVV/TM 1928/FLDURC/TP PC12/SK SCT032
            validDateTime: '2025-01-23T19:28:00.000Z'
            insertedDateTime: '2025-01-23T19:32:04.000Z'
            flightLevel: 0
            flightLevelType: DURC
            turbulenceScore: 0
            icingScore: 0
            coverage1: SCT
            coverageBase1: 3200
            coverageTop1: 0
            unitSystem: default
        - type: Feature
          geometry:
            type: Point
            coordinates:
            - -87.531
            - 38.038
          properties:
            navaidId: EVV
            aircraftType: BE36
            aircraftSize: S
            rawTxt: EVV UA /OV EVV/TM 1943/FL060/TP BE36/TA M07/IC TRACE RIME
            validDateTime: '2025-01-23T19:43:00.000Z'
            insertedDateTime: '2025-01-23T19:45:15.000Z'
            temperature: -7
            flightLevel: 6000
            flightLevelType: LEVEL
            turbulenceScore: 0
            icingScore: 2
            icingBase1: 6000
            icingTop1: 6000
            icingType1: RIME
            icingIntensity1: TRACE
            unitSystem: default
        meta:
          name: v1.pireps.?navaidIds=OWB,EVV
          uuid: e2be64ac-fd9d-4208-b429-787e36226a1a
          request_id: 1d05f133-9054-49eb-a849-92a58f80fd5b
          start_timestamp: 1737663016812
          end_timestamp: 1737663017501
          execution_time: 689
    PirepBadRequestResponse:
      value:
        url: https://aviation.api.dtn.com/v1/pireps?circle=-97,48,200&distanceUnits=nm&minFlightLevelFt=14000&maxFlightLevelFt=7000
        type: bad-request
        title: Invalid Request
        status: 400
        detail: Validation failed.
        instance: urn:dtn:aviation-api:/v1/pireps/:requestId:45a0ce39-d5ea-483b-811b-e22b9fb71428
        errors:
        - message: '`minFlightLevelFt` must not be greater than `maxFlightLevelFt`'
          parameter: minFlightLevelFt
          value: 14000
        - message: '`minFlightLevelFt` must not be greater than `maxFlightLevelFt`'
          parameter: maxFlightLevelFt
          value: 7000
        meta:
          name: v1.pireps.?circle=-97,48,200&distanceUnits=nm&minFlightLevelFt=14000&maxFlightLevelFt=7000
          uuid: ced14d2f-45f4-4fa4-b102-583eef1e370d
          request_id: 45a0ce39-d5ea-483b-811b-e22b9fb71428
          start_timestamp: 1737663193013
          end_timestamp: 1737663193202
          execution_time: 189
    PirepSuccessResponse_2:
      value:
        url: https://aviation.api.dtn.com/v1/pireps/?stationId=IND&limit=2
        type: FeatureCollection
        features:
        - type: Feature
          geometry:
            type: Point
            coordinates:
            - -77.2
            - 39.933
          properties:
            raw_text: MDT UA /OV 10S HAR/TM 2355/FL070/TP SR22/SK OVC069/TA -9/IC -RIME
            typeOfAircraft: SR22
            stationId: HAR
            issueOffice: MDT
            validDateTime: '2024-04-24T23:55:00.000Z'
            flightLevelLow: 7000
            flightLevelHigh: 7000
        - type: Feature
          geometry:
            type: Point
            coordinates:
            - -71.437
            - 42.934
          properties:
            raw_text: MHT UUA /OV MHT/TM 2356/FL010/TP BE99/RM DURD RWY35 +-10KTS BLO010
            typeOfAircraft: BE99
            stationId: MHT
            issueOffice: MHT
            validDateTime: '2024-04-24T23:56:00.000Z'
            flightLevelLow: 1000
            flightLevelHigh: 1000
        - type: Feature
          geometry:
            type: Point
            coordinates:
            - 0
            - 0
          properties:
            raw_text: SAT UA /OV 1TT8 /TM 2357 /FL008 /TP P28A /SK SKC
            typeOfAircraft: P28A
            stationId: 1TT8
            issueOffice: SAT
            validDateTime: '2024-04-24T23:57:00.000Z'
            flightLevelLow: 800
            flightLevelHigh: 800
        - type: Feature
          geometry:
            type: Point
            coordinates:
            - -82.61
            - 40.731
          properties:
            raw_text: CLE UA /OV 7 SW MFD/TM 2330/FLDURC/TP P28A/SK B043 T055/TA 4/IC TRACE   CLEAR
            typeOfAircraft: P28A
            stationId: MFD
            issueOffice: CLE
            validDateTime: '2024-04-24T23:30:00.000Z'
            flightLevelLow: 0
            flightLevelHigh: 0
        - type: Feature
          geometry:
            type: Point
            coordinates:
            - -79.105
            - 34.178
          properties:
            raw_text: FLO UA /OV FLO090030/TM 0000/FL150/TP A319/SK TOP150
            typeOfAircraft: A319
            stationId: FLO
            issueOffice: FLO
            validDateTime: '2024-04-25T00:00:00.000Z'
            flightLevelLow: 15000
            flightLevelHigh: 15000
        - type: Feature
          geometry:
            type: Point
            coordinates:
            - -85.302
            - 33.306
          properties:
            raw_text: LGC UA /OV LGC326022/TM 0001/FL290/TP B737/TB CONS LGT CHOP/RM   ZTLFD-03
            typeOfAircraft: B737
            stationId: LGC
            issueOffice: LGC
            validDateTime: '2024-04-25T00:01:00.000Z'
            flightLevelLow: 29000
            flightLevelHigh: 29000
        - type: Feature
          geometry:
            type: Point
            coordinates:
            - -77.2
            - 40.1
          properties:
            raw_text: MDT UA /OV HAR/TM 0003/FL070/TP C182/TB -6/IC -RIME
            typeOfAircraft: C182
            stationId: HAR
            issueOffice: MDT
            validDateTime: '2024-04-25T00:03:00.000Z'
            flightLevelLow: 7000
            flightLevelHigh: 7000
        - type: Feature
          geometry:
            type: Point
            coordinates:
            - 0
            - 0
          properties:
            raw_text: PAE UA /OV PAET/TM 0000/FL025/TP B738/SK OVC015-TOP025/RM DURD
            typeOfAircraft: B738
            stationId: PAET
            issueOffice: PAE
            validDateTime: '2024-04-25T00:00:00.000Z'
            flightLevelLow: 2500
            flightLevelHigh: 2500
        - type: Feature
          geometry:
            type: Point
            coordinates:
            - -106.732
            - 35.038
          properties:
            raw_text: ABQ UA /OV ABQ272007/TM 2352/FL161/TP CRJ7/TB CONS/RM ZAB/FDCS
            typeOfAircraft: CRJ7
            stationId: ABQ
            issueOffice: ABQ
            validDateTime: '2024-04-24T23:52:00.000Z'
            flightLevelLow: 16100
            flightLevelHigh: 16100
        - type: Feature
          geometry:
            type: Point
            coordinates:
            - -102.812
            - 36.643
          properties:
            raw_text: AMA UA /OV DHT340040/TM 0006/FL330/TP A21N/TB MOD CHOP/RM ZAB/FDCS
            typeOfAircraft: A21N
            stationId: DHT
            issueOffice: AMA
            validDateTime: '2024-04-25T00:06:00.000Z'
            flightLevelLow: 33000
            flightLevelHigh: 33000
        meta:
          name: v1.pireps?stationId=IND&limit=10
          uuid: 88787e61-8907-41e1-9efa-4103af2108d3
          request_id: 091fee2b-b6cf-483e-b8db-ed38c0b131be
          start_timestamp: 1714681278028
          end_timestamp: 1714681279690
          execution_time: 1662
    PirepBadRequestResponse_2:
      value:
        url: https://aviation.api.dtn.comv1/pireps?stationId=IND&offset=-1
        type: bad-request
        title: Invalid Request
        status: 400
        detail: Validation failed.
        instance: urn:dtn:aviation-api:/v1/pireps:requestId:0a73a828-8415-4bb7-ac36-02322a3f0e19
        errors:
        - message: '`offset` query must be Integer zero or greater'
          parameter: offset
          value: -1
        meta:
          name: v1.pireps?stationId=IND&offset=-1
          uuid: e288fbbb-cd74-4c54-8c8e-78d0939fa309
          request_id: 0a73a828-8415-4bb7-ac36-02322a3f0e19
          start_timestamp: 1714683025786
          end_timestamp: 1714683026098
          execution_time: 312
  securitySchemes:
    clientCredentials:
      type: oauth2
      x-receive-token-in: request-body
      flows:
        clientCredentials:
          tokenUrl: https://api.auth.dtn.com/v1/tokens/authorize
      description: "# Using DAIS for M2M/API Auth\nYou have been given a Client ID and a Client Secret, which are used to request a DTN Access Token. DTN Access Tokens are required when making calls to each and every DTN API endpoint. The following information provides additional details on these tokens and how they are generated.\n## What is an Access Token and how is it different from an API Key?\nAn API Key is a random string of characters that an API uses to authorize whether or not a calling client has approved access to an endpoint. These keys are a non-standard approach to API authorization and are generally issued on a per-API basis.\n\nAn Access Token is also a string of characters but is a base-64 encoded JavaScript Object Notation Web Token, or JWT. JWTs are a widely accepted standard that use OAuth concepts and approaches. \n\nBoth API Keys and Access Tokens are used in an Authorization Request Header as a Bearer, meaning there is no difference in where you put this string of characters when you make calls to DTN APIs.\n## How to generate an Access Token?\nWhen requested, an Access Token is generated for your specific Client (ID/Secret) and for a specific API. The DTN Auth and Identity Service (DAIS) generates new Access Tokens for your client. The DAIS endpoint is `POST https://api.auth.dtn.com/v1/tokens/authorize`.\n\nThis endpoint takes two Header parameters:\n  * `Content-Type: application/json`\n  * `Accept: application/json`\n\nThis endpoint takes four parameters in the Request Body:\n  * `grant_type`: this should always be client_credentials for generating machine-to-machine tokens.\n  * `client_i

# --- truncated at 32 KB (42 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/dtn/refs/heads/main/openapi/dtn-pirep-api-openapi.yml