---
title: "Get artifact metadata"
method: GET
path: "/groups/{groupId}/artifacts/{artifactId}"
tags: ["Metadata"]
---

# Get artifact metadata

`GET /groups/{groupId}/artifacts/{artifactId}`

Gets the metadata for an artifact in the registry, based on the latest version. If the latest version of the artifact is marked as `DISABLED`, the next available non-disabled version will be used. The returned metadata includes
both generated (read-only) and editable metadata (such as name and description).

This operation can fail for the following reasons:

* No artifact with this `artifactId` exists  or all versions are `DISABLED` (HTTP error `404`)
* A server error occurred (HTTP error `500`)

## Response `200`

The artifact's metadata.

- ArtifactMetaData
  - `name` string
  - `description` string
  - `owner` string, required
  - `createdOn` string, date-time, required
  - `modifiedBy` string, required
  - `modifiedOn` string, date-time, required
  - `artifactType` string, required
  - `labels` Labels — User-defined name-value pairs. Name and value must be strings.
  - `groupId` string, required — An ID of a single artifact group.
  - `artifactId` string, required — The ID of a single artifact.
  - `contractMetadata` ContractMetadata — Contract metadata for an artifact.
    - `status` 'DRAFT' | 'STABLE' | 'DEPRECATED' — The contract lifecycle status.
    - `ownerTeam` string — The team that owns the contract.
    - `ownerDomain` string — The domain the contract belongs to.
    - `supportContact` string — Support contact email.
    - `classification` 'PUBLIC' | 'INTERNAL' | 'CONFIDENTIAL' | 'RESTRICTED' — Data classification level.
    - `stage` 'DEV' | 'STAGE' | 'PROD' — Promotion stage.
    - `stableDate` string — ISO-8601 date when contract became stable.
    - `deprecatedDate` string — ISO-8601 date when contract was deprecated.
    - `deprecationReason` string — Reason for deprecation.
    - `compatibilityGroup` string — Compatibility group for schema evolution scoping.

## Other responses

- `401` — Common response for all operations that can return a `401` error indicating authentication is required.
- `403` — Common response for all operations that can return a `403` error indicating the user is authenticated but not authorized.
- `404` — Common response for all operations that can return a `404` error.
- `500` — Common response for all operations that can fail with an unexpected server error.

---

[API](https://skmtc.net/apicurio/apis/apicurio-registry-api-v3.md) · [All operations](https://skmtc.net/apicurio/apis/apicurio-registry-api-v3/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/apicurio/apicurio-registry-api-v3/revisions/c39cb56d7dbc/schema)