Management APIs / Registry

Get the contents of a published package

GEThttps://api.spice.ai/v1/registry/packages/{orgName}/{packageName}/contents

Returns the manifest, README, and GitHub facts of a published package, read from its public repository. Needs no authentication. The org and name match without regard to case. A part that GitHub cannot return is null, and the manifest then carries an error.

Path parameters

  • orgNamestringRequired

  • packageNamestringRequired

Responses

200The package contentsapplication/json
  • manifestobjectRequired

    3 properties
    • yamlstring | nullRequired

      The raw spicepod.yaml

    • pathstring | nullRequired

      Repository-relative path of the manifest

    • errorstring | nullRequired

      Why the manifest is missing

  • readmestring | nullRequired

    The README as Markdown

  • repositoryobject | nullRequired

    11 properties
    • html_urlstringRequired

    • descriptionstring | nullRequired

    • homepagestring | nullRequired

    • starsintegerRequired

    • forksintegerRequired

    • open_issuesintegerRequired

    • topicsarray of stringRequired

    • licenseobject | nullRequired

      3 properties
      • keystringRequired

      • namestringRequired

      • urlstring | nullRequired

    • default_branchstringRequired

    • pushed_atstring (date-time) | nullRequired

    • updated_atstring (date-time) | nullRequired

404No published package has this org and name.

503The registry could not be loaded. Try again later.

OpenAPIapi.spice.ai/openapi.json

curl "https://api.spice.ai/v1/registry/packages/<orgName>/<packageName>/contents"
{
  "manifest": {
    "yaml": "string",
    "path": "string",
    "error": "string"
  },
  "readme": "string",
  "repository": {
    "html_url": "string",
    "description": "string",
    "homepage": "string",
    "stars": 0,
    "forks": 0,
    "open_issues": 0,
    "topics": [
      "string"
    ],
    "license": {
      "key": "string",
      "name": "string",
      "url": "string"
    },
    "default_branch": "string",
    "pushed_at": "2026-01-01T00:00:00Z",
    "updated_at": "2026-01-01T00:00:00Z"
  }
}

application/json