# Hermes Package Maintenance Snapshot

> Hermes Package Maintenance Snapshot is a paid API for AI agents from hermes-counterparty-api.onrender.com, paid per call via x402, $0.005/call, status unknown (last checked 2026-09-15).

Returns maintenance status, deprecation flags, license, version currency, and runtime requirements for a specific npm or PyPI package version.

## Facts

- Endpoint: POST https://hermes-counterparty-api.onrender.com/v1/package-maintenance-snapshot
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/hermes-package-maintenance-snapshot-ad336cf7
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_iuo-sxp0bpVhYshYqprkd

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability hermes-package-maintenance-snapshot-ad336cf7 -d '<json body>'
```

Example prompt: Can you check whether fastify version 5.6.0 on npm is still actively maintained, not deprecated, and whether it's the latest release?

## When to prefer this

Use this endpoint when you need authoritative, structured maintenance metadata for a specific package+version combination from npm or PyPI — especially when checking for deprecation, yanked status, license compliance, or version currency before adding or shipping a dependency. Prefer this over manual registry lookups or vulnerability scanners when you need a deterministic JSON response about package health rather than CVE/security data.

## Known failure modes

- Package name not found in the specified registry — returns error or empty result
- Version string does not exist for the given package — may return null fields or error
- Unsupported ecosystem value (anything other than 'npm' or 'PyPI') — validation error
- Registry upstream timeout causing stale or missing metadata
- Missing required fields (package, version, or ecosystem) — 422 validation error
- Payment not provided or insufficient — 402 Payment Required response

## How this service works

Agent utilities for company research, package maintenance intelligence, dependency vulnerability checks, counterparty availability, SEC company snapshots, OFAC sanctions screening, and deterministic JSON/CSV data-quality work. Company domain intelligence includes a free preview before the paid enrichment call.

## Output

A JSON object containing the package's deprecation and yanked status, current and requested version numbers, whether the requested version is the latest, license type, runtime requirements (Node.js or Python version), release timestamps and age in days, and any maintenance warnings.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "package": {
   "type": "string",
   "maxLength": 300,
   "minLength": 1,
   "description": "Exact package name"
  },
  "version": {
   "type": "string",
   "maxLength": 200,
   "minLength": 1,
   "description": "Exact package version"
  },
  "ecosystem": {
   "enum": [
    "npm",
    "PyPI"
   ],
   "type": "string",
   "description": "npm or PyPI registry ecosystem"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "query": {
   "package": "fastify",
   "version": "5.6.0",
   "ecosystem": "npm"
  },
  "source": {
   "provider": "npm registry",
   "metadata_url": "https://registry.npmjs.org/fastify"
  },
  "package": {
   "name": "fastify",
   "yanked": false,
   "license": "MIT",
   "runtime": {
    "node": ">=20",
    "python": null
   },
   "deprecated": false,
   "latest_version": "5.6.0",
   "requested_version": "5.6.0",
   "requested_is_latest": true
  },
  "release": {
   "package_created_at": null,
   "requested_age_days": null,
   "latest_published_at": null,
   "requested_published_at": null,
   "latest_release_age_days": null
  },
  "warnings": [],
  "schema_version": "1.0"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/hermes-package-maintenance-snapshot-ad336cf7/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from hermes-counterparty-api.onrender.com](https://www.zero.xyz/host/hermes-counterparty-api.onrender.com/llms.txt)