---
title: "Get a provider version"
method: GET
path: "/provider-versions/{provider_version}"
tags: ["providers"]
---

# Get a provider version

`GET /provider-versions/{provider_version}`

## Request

- Base URL: `https://example.scalr.io/api/iacp/v3`
- URL: `https://example.scalr.io/api/iacp/v3/provider-versions/{provider_version}`
- Auth: HTTP bearer

Show details of a specific registry provider version.

## Path parameters

- `provider_version` string, required

## Query parameters

- `include` string[]
- `fields` object
  - `provider-readme` string: The comma-separated list of fields to return in response for ProviderReadme resource.
  - `provider-versions` string: The comma-separated list of fields to return in response for ProviderVersion resource.
  - `providers` string: The comma-separated list of fields to return in response for Provider resource.

## Response `200`

Success.

- ProviderVersionDocument: JSON:API Document. see: https://jsonapi.org/format/#document-structure
  - `data` ProviderVersion: The Terraform Registry Provider Version resource.
    - `attributes` object, required
      - `created-by-email` string, nullable: The email of the user who added the provider version.
      - `error-message` string, nullable: The error description when this provider version's status is `errored`.
      - `released-at` string, date-time, nullable: The timestamp when the provider version was released.
      - `size` integer, nullable: A blob size in bytes.
      - `status` 'pending' | 'uploaded' | 'errored': The provider version's current status.
      - `version` string, required: Semantic version.
    - `id` string
    - `links` object
      - `self` string
      - `upload` string, nullable: The URL to upload the tar.gz archive with provider version release files. Available only in the `create-provider-version` response.
    - `relationships` object, required
      - `gpg-key` object, required: The GPG key used to verify the signature of the provider version.
        - `data` object, required
          - `id` string, required
          - `type` 'gpg-keys' | '', required
      - `provider` object, required: The provider that the provider version belongs to.
        - `data` object, required
          - `id` string, required
          - `type` 'providers' | '', required
      - `readme` object: The README of the provider version.
        - `data` object, nullable, required
          - `id` string, required
          - `type` 'provider-readme' | '', required
    - `type` 'provider-versions', required
  - `included` object[]
  - `meta` object

## Other responses

- `404`: Provider version not found or user unauthorized to perform action.
- `4XX`: Client error.
- `5XX`: Server error.

---

[API](https://skmtc.dev/scalr/apis/scalr-iacp-api.md) - [All operations](https://skmtc.dev/scalr/apis/scalr-iacp-api/llms.txt) - [OpenAPI document](https://skmtc.dev/scalr/apis/scalr-iacp-api/revisions/d3e1dc85657a?raw)