Sign in

v51

latestOpenAPI 3.0.3Apache 2.0raw.githubusercontent.com2026-08-01131107332.8 KB
Search
Versions

Search for versions by content

Returns a paginated list of all versions that match the posted content.

This operation can fail for the following reasons:

  • Provided content (request body) was empty (HTTP error 400)
  • A server error occurred (HTTP error 500)
post/search/versions

Query parameters

canonicalboolean

Parameter that can be set to true to indicate that the server should "canonicalize" the content when searching for matching artifacts. Canonicalization is unique to each artifact type, but typically involves removing any extra whitespace and formatting the content in a consistent manner. Must be used along with the artifactType query parameter.

artifactTypestring
Example:AVRO

Indicates the type of artifact represented by the content being used for the search. This is only needed when using the canonical query parameter, so that the server knows how to canonicalize the content prior to searching for matching versions.

offsetinteger

The number of versions to skip before starting to collect the result set. Defaults to 0.

limitinteger

The number of versions to return. Defaults to 20.

order'asc' | 'desc'

Sort order, ascending (asc) or descending (desc).

orderby'groupId' | 'artifactId' | 'version' | 'name' | 'createdOn' | 'modifiedOn' | 'globalId'

The field to sort by. Can be one of:

  • name
  • createdOn
groupIdstring

An ID of a single artifact group.

Example:"my-group"

Filter by group Id.

artifactIdstring

The ID of a single artifact.

Example:"example-artifact"

Filter by artifact Id.

skipCountboolean

Indicates whether to skip the total count query. When true, the total count is not computed and count will be 0 in the response. This can improve performance for large datasets.

Response

On a successful response, returns a result set of versions - one for each version in the registry that matches the criteria.

countinteger required

The total number of versions that matched the query (may be more than the number of versions returned in the result set).

Example response

{
  "versions": [
    {
      "groupId": "DemoGroup",
      "artifactId": "demo-artifact-id",
      "name": "Artifact Version Name",
      "description": "Description of the artifact version",
      "artifactType": "AVRO",
      "state": "ENABLED",
      "createdOn": "2018-02-10T09:30Z",
      "owner": "some text",
      "globalId": 37,
      "version": "1.0.7",
      "contentId": 62
    }
  ]
}