Browse the package catalog¶

Pulp CLI commands for these endpoints are generated from the OpenAPI spec in a separate package; until that is updated, use HTTP.

The content list (/pulp/api/v3/content/maven/package/) returns one row per POM-backed GAV. For catalog UIs and automation that need one row per (group_id, artifact_id), plus repository metrics, use the repository package index.

Do not use content/maven/artifact/ for catalog reads: that list is one row per file (jar, pom, checksums).

These endpoints default to the latest complete repository version. {pulp_id} is the repository UUID. Pass repository_version (HREF or PRN) to read a specific version of that repository.

List packages¶

http GET "${BASE_ADDR}/pulp/api/v3/repositories/maven/maven/${REPO_PK}/packages/?limit=10"

Pagination count is the number of distinct packages (group_id + artifact_id), not GAVs.

Each row includes both a simple version list and per-version metadata:

{
  "group_id": "com.example",
  "artifact_id": "hello",
  "last_updated": "2026-08-11T08:00:00.000000Z",
  "versions": ["5.3.18", "1.0.0"],
  "latest_releases": [
    {
      "version": "5.3.18",
      "release": "rhlw-00003",
      "created_at": "2026-08-11T08:00:00.000000Z"
    },
    {
      "version": "1.0.0",
      "release": "",
      "created_at": "2026-08-10T10:45:08.099362Z"
    }
  ]
}

set(versions) is always the same as set(latest_releases[].version). Both lists are newest-first using numeric-token version order (1.10 before 1.9 before 1.2). There is one latest_releases entry per logical version (after stripping a trailing rebuild suffix \.[a-zA-Z]+-[^.]+$ at the end of version: a ., letters, a -, then the rest of that last segment).

5.3.17.rhlw-00001, 5.3.17.rhlw-00001-n0001, and 5.3.18.lw-1 share bases 5.3.17 / 5.3.18. Versions that are not that last-segment shape are unchanged: 4.3.0-redhat-1, 5.3.18-anything, 5.3.18.anything. 5.3.180 is a different version than 5.3.18.

version is that base. release is the stripped suffix without the leading dot (rhlw-00001 or rhlw-00001-n0001), otherwise empty.

created_at is when that logical version entered the repository: RepositoryContent.pulp_created of the selected newest rebuild, falling back to the content unit's pulp_created.

last_updated is when the package was last updated in this repository version: the latest RepositoryContent.pulp_created among all MavenPackage units for that (group_id, artifact_id) (any rebuild), falling back to the content unit's pulp_created. A rebuild of an older version uploaded yesterday updates last_updated even if a newer version number already exists.

There is no …/builds/ endpoint. Clients that want nested builds[] load every rebuild of one base version from the content list (see Get one version) and group locally.

Ordering¶

Default order is group_id, artifact_id (the catalog package name; clients may concatenate those as groupId:artifactId). Pass ordering to change it:

http GET "${BASE_ADDR}/pulp/api/v3/repositories/maven/maven/${REPO_PK}/packages/" \
  ordering==group_id
http GET "${BASE_ADDR}/pulp/api/v3/repositories/maven/maven/${REPO_PK}/packages/" \
  ordering==-last_updated

Allowed fields: group_id, artifact_id, last_updated. Prefix with - for descending. ordering=group_id (without artifact_id) still sorts by artifact_id in the same direction. last_updated uses group_id, artifact_id as a stable tiebreaker.

Search¶

http GET "${BASE_ADDR}/pulp/api/v3/repositories/maven/maven/${REPO_PK}/packages/" \
  search==junit
http GET "${BASE_ADDR}/pulp/api/v3/repositories/maven/maven/${REPO_PK}/packages/" \
  search==foo:junit

search is case-insensitive (ILIKE) and matches contains (%term%), not prefix.

No : — group_id contains the term or artifact_id contains the term. oo hits foo.bar:bar-junit. junit hits bar-junit.
One : — group_id contains the left part and artifact_id contains the right part. foo:junit hits foo.bar:bar-junit. foo:test does not.
A third : segment is ignored (Maven group:artifact:version). foo.bar:bar-junit:1.0.0 still matches foo.bar:bar-junit.
foo: is group-only contains. :junit is artifact-only contains. Empty or : does not filter.

group_id__istartswith and artifact_id__istartswith stay independent case-insensitive prefix filters and combine with search using AND. Typeahead should use search.

Prefix filters¶

http GET "${BASE_ADDR}/pulp/api/v3/repositories/maven/maven/${REPO_PK}/packages/" \
  group_id__istartswith==com.example

group_id__istartswith and artifact_id__istartswith are case-insensitive (ILIKE). Prefix search belongs on this index, not on the flat content list.

Repository metrics¶

http GET "${BASE_ADDR}/pulp/api/v3/repositories/maven/maven/${REPO_PK}/metrics/"

{
  "package_count": 3,
  "version_count": 5,
  "build_count": 6
}

Counts use MavenPackage units in that repository version (the same identity as PackageList), not MavenArtifact files:

Field	Identity
`package_count`	distinct `(group_id, artifact_id)`
`version_count`	distinct `(group_id, artifact_id, base_version)` after rebuild-suffix strip
`build_count`	distinct `(group_id, artifact_id, full version)`

Until rebuild suffixes exist, version_count equals build_count.

List versions of a package¶

Use the existing content API. collapse_builds=true keeps one unit per logical version (group_id + artifact_id + base_version), the one with the latest pulp_created. Do not nest rebuilds on this list. Clients can drain Pulp next if the page is full.

http GET "${BASE_ADDR}/pulp/api/v3/content/maven/package/" \
  group_id==com.example \
  artifact_id==hello \
  collapse_builds==true \
  repository_version=="${LATEST_VERSION_HREF}"

Every content row includes base_version (stripped version; equal to version when there is no rebuild suffix).

Get one version¶

Omit collapse_builds. Filter with group_id, artifact_id, and base_version so 5.3.17 also hits 5.3.17.rhlw-00001 and 5.3.17.rhlw-00001-n0001, and does not match 5.3.170. Clients map the flat GAV list to nested builds[].

http GET "${BASE_ADDR}/pulp/api/v3/content/maven/package/" \
  group_id==com.example \
  artifact_id==hello \
  base_version==5.3.18

version remains exact. version__startswith is case-sensitive; if you use it as a matcher, pass {version}. (trailing dot) so 5.3.18 does not match 5.3.180. Prefer base_version.