National Interagency Fire Center Layer API

openapi: 3.2.0
info:
  title: NIFC ArcGIS REST Services FeatureServer Layer API
  description: The National Interagency Fire Center hosts an ArcGIS REST Services Directory exposing FeatureServer services that provide authoritative geospatial data on wildfire incidents, fire perimeters, dispatch boundaries, fuel treatments, weather stations, and related fire management resources. This specification documents the common ArcGIS REST conventions used by NIFC's hosted services.
  version: 1.0.0
  contact:
    name: National Interagency Fire Center
    url: https://data-nifc.opendata.arcgis.com
servers:
- url: https://services3.arcgis.com/T4QMspbfLg3qTGWY/ArcGIS/rest/services
  description: NIFC ArcGIS REST services
tags:
- name: Layer
paths:
  /{service}/FeatureServer/{layerId}:
    get:
      tags:
      - Layer
      summary: Get layer metadata
      description: Retrieve metadata for a specific layer in a FeatureServer.
      operationId: getLayer
      parameters:
      - name: service
        in: path
        required: true
        schema:
          type: string
      - name: layerId
        in: path
        required: true
        schema:
          type: integer
      - name: f
        in: query
        schema:
          type: string
          enum:
          - html
          - json
          - pjson
          default: json
      responses:
        '200':
          description: Layer metadata including fields, geometry type, and extent.
  /{service}/FeatureServer/{layerId}/query:
    get:
      tags:
      - Layer
      summary: Query a layer
      description: Query features from a NIFC FeatureServer layer using attribute and spatial filters. Supports paging, geometry filtering, output spatial reference, and return options.
      operationId: queryLayer
      parameters:
      - name: service
        in: path
        required: true
        schema:
          type: string
      - name: layerId
        in: path
        required: true
        schema:
          type: integer
      - name: where
        in: query
        description: SQL-like attribute filter.
        schema:
          type: string
      - name: objectIds
        in: query
        description: Comma-separated ObjectIDs to retrieve.
        schema:
          type: string
      - name: geometry
        in: query
        description: Geometry filter (point, envelope, polyline, polygon).
        schema:
          type: string
      - name: geometryType
        in: query
        schema:
          type: string
          enum:
          - esriGeometryPoint
          - esriGeometryMultipoint
          - esriGeometryPolyline
          - esriGeometryPolygon
          - esriGeometryEnvelope
      - name: inSR
        in: query
        description: Spatial reference of the input geometry.
        schema:
          type: string
      - name: spatialRel
        in: query
        schema:
          type: string
          enum:
          - esriSpatialRelIntersects
          - esriSpatialRelContains
          - esriSpatialRelCrosses
          - esriSpatialRelEnvelopeIntersects
          - esriSpatialRelIndexIntersects
          - esriSpatialRelOverlaps
          - esriSpatialRelTouches
          - esriSpatialRelWithin
      - name: outFields
        in: query
        description: Comma-separated list of fields to return, or '*' for all.
        schema:
          type: string
      - name: outSR
        in: query
        schema:
          type: string
      - name: returnGeometry
        in: query
        schema:
          type: boolean
          default: true
      - name: returnIdsOnly
        in: query
        schema:
          type: boolean
          default: false
      - name: returnCountOnly
        in: query
        schema:
          type: boolean
          default: false
      - name: orderByFields
        in: query
        schema:
          type: string
      - name: groupByFieldsForStatistics
        in: query
        schema:
          type: string
      - name: outStatistics
        in: query
        schema:
          type: string
      - name: resultOffset
        in: query
        schema:
          type: integer
      - name: resultRecordCount
        in: query
        schema:
          type: integer
      - name: f
        in: query
        schema:
          type: string
          enum:
          - html
          - json
          - pjson
          - geojson
          default: json
      responses:
        '200':
          description: Query result with features and geometry payload.