Skip to main content
GET
/
providers
/
{org}
/
{name}
/
versions
/
{version}
Get Version Detail
curl --request GET \
  --url https://api.example.com/providers/{org}/{name}/versions/{version}
import requests

url = "https://api.example.com/providers/{org}/{name}/versions/{version}"

response = requests.get(url)

print(response.text)
const options = {method: 'GET'};

fetch('https://api.example.com/providers/{org}/{name}/versions/{version}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));
<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.example.com/providers/{org}/{name}/versions/{version}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}
package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.example.com/providers/{org}/{name}/versions/{version}"

	req, _ := http.NewRequest("GET", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}
HttpResponse<String> response = Unirest.get("https://api.example.com/providers/{org}/{name}/versions/{version}")
  .asString();
require 'uri'
require 'net/http'

url = URI("https://api.example.com/providers/{org}/{name}/versions/{version}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)

response = http.request(request)
puts response.read_body
{
  "prefix": "<string>",
  "name": "<string>",
  "version": "<string>",
  "runtime_version": "<string>",
  "canonical": "<string>",
  "created_at": "2023-11-07T05:31:56Z",
  "updated_at": "2023-11-07T05:31:56Z",
  "wheel_url": "<string>",
  "wheel_sha256": "<string>",
  "package_name": "<string>",
  "entrypoint": [
    "<string>"
  ],
  "source_hash": "<string>",
  "build_id": "<string>",
  "schemas": [
    {}
  ],
  "changelog": "<string>",
  "status": "building",
  "published_at": "2023-11-07T05:31:56Z",
  "error_message": "<string>"
}
{
  "detail": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>",
      "input": "<unknown>",
      "ctx": {}
    }
  ]
}

Path Parameters

​
org
string
required
​
name
string
required
​
version
string
required

Response

Successful Response

A published version of a provider.

Identity fields (frozen): prefix: Namespace token of the owning provider. name: Provider short name this version belongs to. version: Semantic version string (e.g., "1.0.0").

Build metadata: runtime_version: Pinned runtime version this version targets. wheel_url: HTTPS URL of the published Python wheel. Sole artifact pointer for wheel-published versions; see :attr:WheelProviderVersionCreate.wheel_url for accepted registry forms. wheel_sha256: Optional SHA-256 digest of the wheel bytes, verified at publish time and forwarded to runtime installs. package_name: Optional importable Python package name inside a wheel-published provider. When absent, the runtime attempts to infer it from installed wheel metadata. entrypoint: Optional override of the runtime entrypoint command (e.g. ["python", "-m", "custom_runtime"]). None keeps the default python -m pragma_runtime.entrypoint. source_hash: SHA-256 of the source tarball on legacy rows.

Provider introspection: schemas: Resource type schemas extracted from the provider.

State (system-managed): status: Build/publish lifecycle status. published_at: Timestamp when version was published. error_message: Error details when build fails.

​
prefix
string
required
​
name
string
required
​
version
string
required
​
runtime_version
string
required
​
canonical
string
required
read-only

Slash-joined prefix/name canonical string of the owning provider.

Returns: Display form of the provider identity this version belongs to.

​
created_at
string<date-time>
​
updated_at
string<date-time>
​
wheel_url
string | null
​
wheel_sha256
string | null
Pattern: ^[0-9a-f]{64}$
​
package_name
string | null
Required string length: 1 - 200
​
entrypoint
string[] | null
​
source_hash
string | null
​
build_id
string | null
​
schemas
Schemas · object[] | null
​
changelog
string | null
​
status
enum<string>
default:building

Build/publish status for a provider version.

Available options:
building,
published,
failed,
yanked
​
published_at
string<date-time> | null
​
error_message
string | null