npm package health API

npm package health API: dependency-hygiene facts straight from the npm registry — latest version, all dist-tags, last-modified timestamp, total published versions, deprecation status with message, runtime dependency count, and weekly downloads. For scoped packages, URL-encode the slash in the name. Use for dependency auditing, supply-chain security checks, version freshness, and update agents maintaining package.json. Cached up to 1 hour per package.

Paid test badge: not yet. The checks above are free: we call the tool without paying and read the payment request it sends back. The Verified badge needs paid calls whose answers match the promised output, and nobody can buy a badge.

Endpoint

GET https://gateway.stride20k.com/dev/npm/:packageName

Our checks, last 30 days

Example input (from the provider)

{
  "method": "GET",
  "pathParams": {
    "packageName": "hono"
  },
  "queryParams": {},
  "type": "http"
}

Promised output schema (from the provider)

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "input": {
      "additionalProperties": false,
      "properties": {
        "method": {
          "enum": [
            "GET"
          ],
          "type": "string"
        },
        "pathParams": {
          "properties": {
            "packageName": {
              "description": "npm package name (lowercase). For scoped packages, URL-encode the slash in the name.",
              "pattern": "(@[a-z0-9-~][a-z0-9-._~]*/)?[a-z0-9-~][a-z0-9-._~]*",
              "type": "string"
            }
          },
          "required": [
            "packageName"
          ],
          "type": "object"
        },
        "queryParams": {
          "properties": {},
          "type": "object"
        },
        "type": {
          "const": "http",
          "type": "string"
        }
      },
      "required": [
        "type",
        "method"
      ],
      "type": "object"
    },
    "output": {
      "properties": {
        "example": {
          "properties": {
            "data": {
              "properties": {
                "dependencyCount": {
                  "description": "Runtime dependency count of the latest version.",
                  "type": "integer"
                },
                "deprecated": {
                  "description": "false, true, or the deprecation message string for the latest version.",
                  "type": [
                    "boolean",
                    "string"
                  ]
                },
                "distTags": {
                  "description": "All dist-tags (latest, next, beta, ...).",
                  "type": "object"
                },
                "lastModified": {
                  "description": "Registry last-modified timestamp, ISO 8601.",
                  "type": "string"
                },
                "latestVersion": {
                  "description": "Version currently tagged 'latest'.",
                  "type": "string"
                },
                "package": {
                  "description": "Canonical package name.",
                  "type": "string"
                },
                "versionCount": {
                  "description": "Total published versions.",
                  "type": "integer"
                },
                "weeklyDownloads": {
                  "description": "Downloads in the last 7 days, or null if unavailable.",
                  "type": "integer"
                }
              },
              "required": [
                "package",
                "latestVersion",
                "deprecated"
              ],
              "type": "object"
            },
            "endpoint": {
              "description": "Always \"/dev/npm/:packageName\".",
              "type": "string"
            },
            "meta": {
              "properties": {
                "attribution": {
                  "description": "Licensing attribution when the source requires it.",
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "cached": {
                  "description": "Whether this response was served from cache.",
                  "type": "boolean"
                },
                "fetchedAt": {
                  "description": "ISO 8601 time the data was actually retrieved from the upstream.",
                  "type": "string"
                },
                "source": {
                  "description": "Upstream source: npm registry.",
                  "type": "string"
                }
              },
              "required": [
                "source",
                "cached",
                "fetchedAt"
              ],
              "type": "object"
            },
            "ok": {
              "description": "true on success.",
              "type": "boolean"
            }
          },
          "required": [
            "ok",
            "endpoint",
            "data",
            "meta"
          ],
          "type": "object"
        },
        "type": {
          "type": "string"
        }
      },
      "required": [
        "type"
      ],
      "type": "object"
    }
  },
  "required": [
    "input"
  ],
  "type": "object"
}

This page as JSON