{
  "openapi": "3.0.3",
  "info": {
    "title": "NGA Earth-Info REST API",
    "description": "The National Geospatial-Intelligence Agency (NGA) Earth-Info REST API provides programmatic access to GPS ephemeris products, Earth Orientation Parameter Predictions (EOPP), Navdata clock state files, and short-term orbit prediction products published by the NGA Office of Geomatics. Authoritative interactive documentation is published in OpenAPI format on the Earth-Info portal.",
    "version": "1.0.0",
    "contact": {
      "name": "NGA Office of Geomatics",
      "email": "geomatics@nga.mil",
      "url": "https://earth-info.nga.mil/"
    }
  },
  "servers": [
    {
      "url": "https://earth-info.nga.mil",
      "description": "NGA Earth-Info production endpoint"
    }
  ],
  "tags": [
    {
      "name": "Ephemeris",
      "description": "GPS ephemeris products, including Center of Mass and Antenna Phase Center variants."
    },
    {
      "name": "EOPP",
      "description": "Earth Orientation Parameter Predictions in multiple formats."
    },
    {
      "name": "Orbit",
      "description": "Short-term orbit prediction products."
    },
    {
      "name": "Clock",
      "description": "Navdata clock state files."
    }
  ],
  "paths": {
    "/api/ephemeris/center-of-mass": {
      "get": {
        "tags": ["Ephemeris"],
        "summary": "Download GPS ephemeris (Center of Mass)",
        "description": "Returns the GPS ephemeris product referenced to the satellite Center of Mass for the specified date.",
        "operationId": "getEphemerisCenterOfMass",
        "parameters": [
          {
            "name": "date",
            "in": "query",
            "required": true,
            "description": "Target date in YYYY-MM-DD format.",
            "schema": {"type": "string", "format": "date"}
          }
        ],
        "responses": {
          "200": {
            "description": "Ephemeris file.",
            "content": {
              "application/octet-stream": {
                "schema": {"type": "string", "format": "binary"}
              }
            }
          }
        }
      }
    },
    "/api/ephemeris/antenna-phase-center": {
      "get": {
        "tags": ["Ephemeris"],
        "summary": "Download GPS ephemeris (Antenna Phase Center)",
        "description": "Returns the GPS ephemeris product referenced to the Antenna Phase Center (APC) for the specified date.",
        "operationId": "getEphemerisAntennaPhaseCenter",
        "parameters": [
          {
            "name": "date",
            "in": "query",
            "required": true,
            "description": "Target date in YYYY-MM-DD format.",
            "schema": {"type": "string", "format": "date"}
          }
        ],
        "responses": {
          "200": {
            "description": "Ephemeris file.",
            "content": {
              "application/octet-stream": {
                "schema": {"type": "string", "format": "binary"}
              }
            }
          }
        }
      }
    },
    "/api/eopp": {
      "get": {
        "tags": ["EOPP"],
        "summary": "Download Earth Orientation Parameter Predictions",
        "description": "Returns Earth Orientation Parameter Prediction data for the specified date in the requested format.",
        "operationId": "getEopp",
        "parameters": [
          {
            "name": "date",
            "in": "query",
            "required": true,
            "description": "Target date in YYYY-MM-DD format.",
            "schema": {"type": "string", "format": "date"}
          },
          {
            "name": "format",
            "in": "query",
            "required": false,
            "description": "EOPP product format.",
            "schema": {"type": "string", "enum": ["txt", "dat", "iers"]}
          }
        ],
        "responses": {
          "200": {
            "description": "EOPP file.",
            "content": {
              "application/octet-stream": {
                "schema": {"type": "string", "format": "binary"}
              }
            }
          }
        }
      }
    },
    "/api/clock-state": {
      "get": {
        "tags": ["Clock"],
        "summary": "Download Navdata clock state file",
        "description": "Returns the Navdata clock state file for the specified date.",
        "operationId": "getClockState",
        "parameters": [
          {
            "name": "date",
            "in": "query",
            "required": true,
            "description": "Target date in YYYY-MM-DD format.",
            "schema": {"type": "string", "format": "date"}
          }
        ],
        "responses": {
          "200": {
            "description": "Clock state file.",
            "content": {
              "application/octet-stream": {
                "schema": {"type": "string", "format": "binary"}
              }
            }
          }
        }
      }
    },
    "/api/orbit/9-day": {
      "get": {
        "tags": ["Orbit"],
        "summary": "Download 9-day orbit prediction",
        "description": "Returns the 9-day GPS orbit prediction product for the specified date.",
        "operationId": "getOrbit9Day",
        "parameters": [
          {
            "name": "date",
            "in": "query",
            "required": true,
            "description": "Target date in YYYY-MM-DD format.",
            "schema": {"type": "string", "format": "date"}
          }
        ],
        "responses": {
          "200": {
            "description": "9-day orbit prediction file.",
            "content": {
              "application/octet-stream": {
                "schema": {"type": "string", "format": "binary"}
              }
            }
          }
        }
      }
    },
    "/api/orbit/30-day": {
      "get": {
        "tags": ["Orbit"],
        "summary": "Download 30-day orbit prediction",
        "description": "Returns the 30-day GPS orbit prediction product for the specified date.",
        "operationId": "getOrbit30Day",
        "parameters": [
          {
            "name": "date",
            "in": "query",
            "required": true,
            "description": "Target date in YYYY-MM-DD format.",
            "schema": {"type": "string", "format": "date"}
          }
        ],
        "responses": {
          "200": {
            "description": "30-day orbit prediction file.",
            "content": {
              "application/octet-stream": {
                "schema": {"type": "string", "format": "binary"}
              }
            }
          }
        }
      }
    }
  },
  "components": {
    "schemas": {}
  }
}