---
title: "GET /v2/package-vetting"
method: GET
path: "/v2/package-vetting"
deprecated: true
---

# GET /v2/package-vetting

`GET /v2/package-vetting`

> **Deprecated.**

Lists which participant node vetted what packages on which synchronizer.
This endpoint (GET /package-vetting) is deprecated and will be removed in a future release. Please use POST /package-vetting/list instead.

## Request body

- ListVettedPackagesRequest
  - `packageMetadataFilter` PackageMetadataFilter — Filter the VettedPackages by package metadata. A PackageMetadataFilter without package_ids and without package_name_prefixes matches any vetted package. Non-empty fields specify candidate values of which at least one must match. If both fields are set, then a candidate is returned if it matches one of the fields.
    - `packageIds` string[] — If this list is non-empty, any vetted package with a package ID in this list will match the filter. Optional: can be empty
    - `packageNamePrefixes` string[] — If this list is non-empty, any vetted package with a name matching at least one prefix in this list will match the filter. Optional: can be empty
  - `topologyStateFilter` TopologyStateFilter — Filter the vetted packages by the participant and synchronizer that they are hosted on. Empty fields are ignored, such that a ``TopologyStateFilter`` without participant_ids and without synchronizer_ids matches a vetted package hosted on any participant and synchronizer. Non-empty fields specify candidate values of which at least one must match. If both fields are set then at least one candidate value must match from each field.
    - `participantIds` string[] — If this list is non-empty, only vetted packages hosted on participants listed in this field match the filter. Query the current Ledger API's participant's ID via the public ``GetParticipantId`` command in ``PartyManagementService``. Optional: can be empty
    - `synchronizerIds` string[] — If this list is non-empty, only vetted packages from the topology state of the synchronizers in this list match the filter. Optional: can be empty
  - `pageToken` string — Pagination token to determine the specific page to fetch. Using the token guarantees that ``VettedPackages`` on a subsequent page are all greater (``VettedPackages`` are sorted by synchronizer ID then participant ID) than the last ``VettedPackages`` on a previous page. The server does not store intermediate results between calls chained by a series of page tokens. As a consequence, if new vetted packages are being added and a page is requested twice using the same token, more packages can be returned on the second call. Leave unspecified (i.e. as empty string) to fetch the first page. Optional
  - `pageSize` integer — Maximum number of ``VettedPackages`` results to return in a single page. If the page_size is unspecified (i.e. left as 0), the server will decide the number of results to be returned. If the page_size exceeds the maximum supported by the server, an error will be returned. To obtain the server's maximum consult the PackageService descriptor available in the VersionService. Optional

## Response `200`

- ListVettedPackagesResponse
  - `vettedPackages` VettedPackages[] — All ``VettedPackages`` that contain at least one ``VettedPackage`` matching both a ``PackageMetadataFilter`` and a ``TopologyStateFilter``. Sorted by synchronizer_id then participant_id. Optional: can be empty
    - `packages` VettedPackage[], required — Sorted by package_name and package_version where known, and package_id as a last resort. Required: must be non-empty
      - `packageId` string, required — Package ID of this package Required
      - `validFromInclusive` string — The time from which this package is vetted. Empty if vetting time has no lower bound. Optional
      - `validUntilExclusive` string — The time until which this package is vetted. Empty if vetting time has no upper bound. Optional
      - `packageName` string — Name of this package. Only available if the package has been uploaded to the current participant. Optional
      - `packageVersion` string — Version of this package. Only available if the package has been uploaded to the current participant. Optional
    - `participantId` string, required — Participant on which these packages are vetted. Required
    - `synchronizerId` string, required — Synchronizer on which these packages are vetted. Required
    - `topologySerial` integer, required — Serial of last ``VettedPackages`` topology transaction of this participant and on this synchronizer. Required
  - `nextPageToken` string — Pagination token to retrieve the next page. Empty string if there are no further results. Optional

## Other responses

- `400` — Invalid value, Invalid value for: body
- `default`

---

[API](https://skmtc.dev/canton/apis/json-ledger-api-http-endpoints.md) · [All operations](https://skmtc.dev/canton/apis/json-ledger-api-http-endpoints/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/canton/json-ledger-api-http-endpoints/revisions/296292e8b8f1/schema)