---
title: "GET /v1/projects/{project}/locations/{location}/artifacts"
method: GET
path: "/v1/projects/{project}/locations/{location}/artifacts"
tags: ["Registry"]
---

# GET /v1/projects/{project}/locations/{location}/artifacts

`GET /v1/projects/{project}/locations/{location}/artifacts`

ListArtifacts returns matching artifacts.

## Path parameters

- `project` string, required
- `location` string, required

## Query parameters

- `pageSize` integer
- `pageToken` string
- `filter` string

## Response `200`

OK

- ListArtifactsResponse — Response message for ListArtifacts.
  - `artifacts` Artifact[] — The artifacts from the specified publisher.
    - `name` string — Resource name.
    - `createTime` string, date-time — Output only. Creation timestamp.
    - `updateTime` string, date-time — Output only. Last update timestamp.
    - `mimeType` string — A content type specifier for the artifact. Content type specifiers are Media Types (https://en.wikipedia.org/wiki/Media_type) with a possible "schema" parameter that specifies a schema for the stored information. Content types can specify compression. Currently only GZip compression is supported (indicated with "+gzip").
    - `sizeBytes` integer — Output only. The size of the artifact in bytes. If the artifact is gzipped, this is the size of the uncompressed artifact.
    - `hash` string — Output only. A SHA-256 hash of the artifact's contents. If the artifact is gzipped, this is the hash of the uncompressed artifact.
    - `contents` string, bytes — Input only. The contents of the artifact. Provided by API callers when artifacts are created or replaced. To access the contents of an artifact, use GetArtifactContents.
  - `nextPageToken` string — A token, which can be sent as `page_token` to retrieve the next page. If this field is omitted, there are no subsequent pages.

## Other responses

- `default` — Default error response

## Changes

- **2022-04-20** `60e792df4088` — 5 breaking, 1 info
  - for the `query` request parameter `pageSize`, the type/format was changed from `string`/`` to `integer`/`int32`
  - the response's body type/format changed from ``/`` to `object`/`` for status `200`
  - the `artifacts/items/` response's property type/format changed from ``/`` to `object`/`` for status `200`
  - the `artifacts/items/createTime` response's property type/format changed from `string`/`RFC3339` to `string`/`date-time` for status `200`
  - …2 more
- **2021-12-22** `ce92b3e601d4` — 7 warning, 8 info
  - deleted the `query` request parameter `page_size`
  - deleted the `query` request parameter `page_token`
  - removed the optional property `artifacts/items/create_time` from the response with the `200` status
  - removed the optional property `artifacts/items/mime_type` from the response with the `200` status
  - …11 more
- **2021-09-11** `2699b7373a24` — 1 info
  - endpoint added
- **2020-10-24** `9c2571d516e8` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/apigee/apis/registry-api/changes/v1/projects/:project/locations/:location/artifacts/get.md)

---

[API](https://skmtc.dev/apigee/apis/registry-api.md) · [All operations](https://skmtc.dev/apigee/apis/registry-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/apigee/registry-api/revisions/382ff6551970/schema)