Api Endpoint

Forest Packages

Detect whether normalized public npm or PyPI package registry state changed since a saved fingerprint. Returns a deterministic SHA-256 fingerprint for package/version existence, latest/resolved version, deprecation or yank state, license and runtime requirement. No dependency graph, vulnerability scan or registry mutation. Base mainnet USDC

Open interactive test console

Offering

Provider
http--forest-gas-station-mainnet--lcjl27p8lmjs.code.run
Method
POST
Offering type
Api Endpoint
Transport type
http
Category
Development
Delivery
Not provided
Pricing model
Not provided
x402 version
2

Endpoint context

URL
https://http--forest-gas-station-mainnet--lcjl27p8lmjs.code.run/package/changed
MIME type
Not provided
First seen
2026-10-16T01:50:45.949Z
Last seen
Tags
package, npm, pypi, registry, fingerprint

Payment pricing

x402 payment terms are the authoritative price for calling this endpoint.

Payment option 1
0.002 USDC
Atomic price: 2000 · Network: eip155:8453 · Asset: USDC · Scheme: exact
Raw x402 terms
[
  {
    "scheme": "exact",
    "network": "eip155:8453",
    "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
    "amount": "2000",
    "payTo": "0xb48D918151311F982d542eF5C84cc1cd54CFf7a9"
  }
]

Observed health

Status
Reachable
Latest latency
259 ms
Average latency
768 ms
HTTP status
405
Last checked
Reachability
100% over 13 checks

Latency is measured to the first response headers. A reachable result does not verify response accuracy or merchant identity.

Input schema

{
  "additionalProperties": false,
  "properties": {
    "body": {
      "additionalProperties": false,
      "properties": {
        "ecosystem": {
          "description": "Public ecosystem value used to scope this lookup.",
          "enum": [
            "npm",
            "pypi"
          ]
        },
        "package": {
          "description": "Public package name to inspect.",
          "maxLength": 214,
          "minLength": 1,
          "type": "string"
        },
        "previous_hash": {
          "description": "Earlier result hash used to detect a material change.",
          "pattern": "^[a-fA-F0-9]{64}$",
          "type": [
            "string",
            "null"
          ]
        },
        "version": {
          "description": "Package version whose public metadata should be checked.",
          "maxLength": 128,
          "minLength": 1,
          "type": "string"
        }
      },
      "required": [
        "ecosystem",
        "package"
      ],
      "type": "object"
    },
    "bodyType": {
      "enum": [
        "json",
        "form-data",
        "text"
      ],
      "type": "string"
    },
    "method": {
      "enum": [
        "POST"
      ],
      "type": "string"
    },
    "type": {
      "const": "http",
      "type": "string"
    }
  },
  "required": [
    "type",
    "method",
    "bodyType",
    "body"
  ],
  "type": "object"
}

Output schema

{
  "properties": {
    "example": {
      "additionalProperties": false,
      "properties": {
        "capability": {
          "const": "package.changed",
          "description": "Public capability value used to scope this lookup."
        },
        "data": {
          "additionalProperties": false,
          "description": "Public data value used to scope this lookup.",
          "properties": {
            "changed": {
              "description": "Public changed value used to scope this lookup.",
              "type": [
                "boolean",
                "null"
              ]
            },
            "ecosystem": {
              "description": "Public ecosystem value used to scope this lookup.",
              "enum": [
                "npm",
                "pypi"
              ]
            },
            "fingerprint_fields": {
              "description": "Public fingerprint fields value used to scope this lookup.",
              "items": {
                "enum": [
                  "ecosystem",
                  "package",
                  "exists",
                  "requested_version",
                  "requested_version_exists",
                  "resolved_version",
                  "latest_version",
                  "outdated",
                  "deprecated",
                  "yanked",
                  "license",
                  "requires_runtime"
                ]
              },
              "maxItems": 12,
              "minItems": 12,
              "type": "array"
            },
            "new_hash": {
              "description": "Public new hash value used to scope this lookup.",
              "pattern": "^[a-fA-F0-9]{64}$",
              "type": "string"
            },
            "package": {
              "description": "Public package name to inspect.",
              "type": "string"
            },
            "previous_hash": {
              "description": "Earlier result hash used to detect a material change.",
              "pattern": "^[a-fA-F0-9]{64}$",
              "type": [
                "string",
                "null"
              ]
            },
            "scope": {
              "const": "package_registry_metadata_only_no_dependency_graph",
              "description": "Public scope value used to scope this lookup."
            },
            "state": {
              "additionalProperties": false,
              "description": "Public state value used to scope this lookup.",
              "properties": {
                "deprecated": {
                  "description": "Public requested version exists value used to scope this lookup.",
                  "type": [
                    "boolean",
                    "null"
                  ]
                },
                "ecosystem": {
                  "description": "Public ecosystem value used to scope this lookup.",
                  "enum": [
                    "npm",
                    "pypi"
                  ]
                },
                "exists": {
                  "description": "Public exists value used to scope this lookup.",
                  "type": "boolean"
                },
                "latest_version": {
                  "description": "Public requested version value used to scope this lookup.",
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "license": {
                  "description": "Public requested version value used to scope this lookup.",
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "outdated": {
                  "description": "Public requested version exists value used to scope this lookup.",
                  "type": [
                    "boolean",
                    "null"
                  ]
                },
                "package": {
                  "description": "Public package name to inspect.",
                  "type": "string"
                },
                "requested_version": {
                  "description": "Public requested version value used to scope this lookup.",
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "requested_version_exists": {
                  "description": "Public requested version exists value used to scope this lookup.",
                  "type": [
                    "boolean",
                    "null"
                  ]
                },
                "requires_runtime": {
                  "description": "Public requested version value used to scope this lookup.",
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "resolved_version": {
                  "description": "Public requested version value used to scope this lookup.",
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "yanked": {
                  "description": "Public requested version exists value used to scope this lookup.",
                  "type": [
                    "boolean",
                    "null"
                  ]
                }
              },
              "required": [
                "ecosystem",
                "package",
                "exists",
                "requested_version",
                "requested_version_exists",
                "resolved_version",
                "latest_version",
                "outdated",
                "deprecated",
                "yanked",
                "license",
                "requires_runtime"
              ],
              "type": "object"
            }
          },
          "required": [
            "ecosystem",
            "package",
            "changed",
            "previous_hash",
            "new_hash",
            "state",
            "fingerprint_fields",
            "scope"
          ],
          "type": "object"
        },
        "meta": {
          "additionalProperties": false,
          "description": "Public meta value used to scope this lookup.",
          "properties": {
            "cache": {
              "description": "Public cache value used to scope this lookup.",
              "enum": [
                "hit",
                "miss",
                "bypass"
              ]
            },
            "checked_at": {
              "description": "Public checked at value used to scope this lookup.",
              "type": "string"
            },
            "duration_ms": {
              "description": "Public duration ms value used to scope this lookup.",
              "minimum": 0,
              "type": "integer"
            },
            "provider": {
              "description": "Public provider value used to scope this lookup.",
              "type": [
                "string",
                "null"
              ]
            }
          },
          "required": [
            "provider",
            "checked_at",
            "cache",
            "duration_ms"
          ],
          "type": "object"
        },
        "ok": {
          "const": true,
          "description": "Public ok value used to scope this lookup."
        },
        "version": {
          "const": "1",
          "description": "Package version whose public metadata should be checked."
        }
      },
      "required": [
        "ok",
        "capability",
        "version",
        "data",
        "meta"
      ],
      "type": "object"
    },
    "type": {
      "type": "string"
    }
  },
  "required": [
    "type"
  ],
  "type": "object"
}