USGS Mineral Resources

Methods (6)

• searchDeposits

  read

  MRDS deposits worldwide. Filter commodity (2-letter code), country (FIPS), US state, dev_stat, bbox.

  Input schema

  {
    "type": "object",
    "properties": {
      "commodity": {
        "type": "string",
        "examples": [
          "CU"
        ]
      },
      "country": {
        "type": "string",
        "examples": [
          "CI"
        ]
      },
      "state": {
        "type": "string"
      },
      "fips_code": {
        "type": "string"
      },
      "dev_stat": {
        "type": "string"
      },
      "bbox": {
        "type": "array",
        "items": {
          "type": "number"
        }
      },
      "count": {
        "type": "number",
        "examples": [
          100
        ]
      },
      "startIndex": {
        "type": "number"
      }
    },
    "additionalProperties": false
  }

  commodity is matched against code_list with PropertyIsLike "%CODE%".

• getDepositById

  read

  Full deposit record — 26+ subtables (commodities, materials, ages, ore body, references).

  Input schema

  {
    "type": "object",
    "properties": {
      "dep_id": {
        "type": "integer",
        "examples": [
          10058048
        ],
        "oneOf": [
          {
            "type": "string"
          },
          {
            "type": "number"
          }
        ]
      }
    },
    "additionalProperties": false,
    "required": [
      "dep_id"
    ]
  }

  Source: mrdata.usgs.gov/mrds/json/{dep_id}. GeoJSON Feature.

• searchByBbox

  read

  Spatial-only deposit search. bbox is [minX, minY, maxX, maxY] in WGS84.

  Input schema

  {
    "type": "object",
    "properties": {
      "minX": {
        "type": "number",
        "examples": [
          -112.2
        ]
      },
      "minY": {
        "type": "number",
        "examples": [
          40.4
        ]
      },
      "maxX": {
        "type": "number",
        "examples": [
          -111.9
        ]
      },
      "maxY": {
        "type": "number",
        "examples": [
          40.7
        ]
      },
      "count": {
        "type": "number"
      }
    },
    "additionalProperties": false,
    "required": [
      "minX",
      "minY",
      "maxX",
      "maxY"
    ]
  }

  Skips XML filter; uses WFS BBOX URL shortcut for speed.

• searchUsminFeatures

  read

  US conterminous mine features (Mine Shaft / Adit / Prospect / Tailings). Requires state.

  Input schema

  {
    "type": "object",
    "properties": {
      "state": {
        "type": "string",
        "examples": [
          "AZ"
        ]
      },
      "county": {
        "type": "string"
      },
      "ftr_type": {
        "type": "string",
        "examples": [
          "Mine Shaft"
        ]
      },
      "bbox": {
        "type": "array",
        "items": {
          "type": "number"
        }
      },
      "count": {
        "type": "number"
      }
    },
    "additionalProperties": false,
    "required": [
      "state"
    ]
  }

  USMIN does not cover Alaska, Hawaii, PR, or international.

• countDeposits

  read

  Count deposits via WFS resultType=hits. Slice by commodity / country / state.

  Input schema

  {
    "type": "object",
    "properties": {
      "commodity": {
        "type": "string",
        "examples": [
          "LI"
        ]
      },
      "country": {
        "type": "string"
      },
      "state": {
        "type": "string",
        "examples": [
          "NV"
        ]
      }
    },
    "additionalProperties": false
  }

  Unfiltered global counts time out (>120s).

• getServiceInfo

  read

  Endpoints, layer fields, pagination conventions, distinct enum values, upstream quirks.

  Input schema

  {
    "type": "object",
    "properties": {},
    "additionalProperties": false
  }