Get Product Details

7min
Returns all metadata for a product
GET
Request
Query Parameters
product
String
required
Product short code
include_latest_version
Boolean
optional
Includes details on latest installation file (default: false)
include_custom_fields
Boolean
optional
 Include product custom fields definition (default: false)
env
String
optional
Filter products by environment string (as defined by installation file "environment")
Header Parameters
Date
String
required
In RFC7231 format (see "License API Authorization"), eg.: Thu, 17 Nov 2022 20:51:35 GMT
Authorization
String
required
See "License API Authorization" article
Curl
Node.js
JS
Python
Ruby
import requests

url = "/api/v4/product_details?product=string"

payload={}
headers = {
   'Accept': 'application/json',
   'Date': 'string',
   'Authorization': 'string'
}

response = requests.request("GET", url, headers=headers, data=payload)

print(response.text)

import requests

url = "/api/v4/product_details?product=string"

payload={}
headers = {
   'Accept': 'application/json',
   'Date': 'string',
   'Authorization': 'string'
}

response = requests.request("GET", url, headers=headers, data=payload)

print(response.text)
Responses
200
404
{
    "product_id": 1683881296184003,
    "product_name": "p",
    "short_code": "p",
    "allow_trial": false,
    "trial_days": 0,
    "authorization_method": "license-key",
    "allow_overages": false,
    "max_overages": 0,
    "prevent_vm": false,
    "floating_timeout": 5,
    "metadata": {}
}
{
    "product_id": 1683881296184003,
    "product_name": "p",
    "short_code": "p",
    "allow_trial": false,
    "trial_days": 0,
    "authorization_method": "license-key",
    "allow_overages": false,
    "max_overages": 0,
    "prevent_vm": false,
    "floating_timeout": 5,
    "metadata": {}
}
﻿
Schema
Request Query Parameters
TypeScript
JSON Schema

﻿
Response Body
TypeScript
JSON Schema
type ProductDetailsResponseBody = {
    product_id: number;
    product_name: string;
    short_code: string;
    authorization_method: "license-key" | "user";
    floating_timeout: number;
    max_overages: number;
    trial_days: number;
    allow_overages: boolean;
    allow_trial: boolean;
    prevent_vm: boolean;
    metadata: JSON;
    
    // this property is only present if "include_custom_fields" query param is true
    custom_fields?: {
        id: number;
        name: string;
        default_value: string;
    }[] | undefined;
    
    // this property is only present if "include_latest_version" query param is true
    latest_version?: {
        version: string | null;
        environment: string | null;
        hash_md5: string | null;
        eula_link: string | null;
        release_notes_link: string | null;
        size: string | null;
        requires_version: string | null;
        channel: string | null;
        release_date: string | null;
        id: number;
        product_id: number;
        enabled: boolean;
        full_link: string | null;
        filename: string | null;
        created_at: string; // Date string in full ISO 8601 format, e.g. "2024-09-27T23:30:48.016Z"
        updated_at: string; // Date string in full ISO 8601 format, e.g. "2024-09-27T23:30:48.016Z"
    } | undefined;
}
type ProductDetailsResponseBody = {
    product_id: number;
    product_name: string;
    short_code: string;
    authorization_method: "license-key" | "user";
    floating_timeout: number;
    max_overages: number;
    trial_days: number;
    allow_overages: boolean;
    allow_trial: boolean;
    prevent_vm: boolean;
    metadata: JSON;
    
    // this property is only present if "include_custom_fields" query param is true
    custom_fields?: {
        id: number;
        name: string;
        default_value: string;
    }[] | undefined;
    
    // this property is only present if "include_latest_version" query param is true
    latest_version?: {
        version: string | null;
        environment: string | null;
        hash_md5: string | null;
        eula_link: string | null;
        release_notes_link: string | null;
        size: string | null;
        requires_version: string | null;
        channel: string | null;
        release_date: string | null;
        id: number;
        product_id: number;
        enabled: boolean;
        full_link: string | null;
        filename: string | null;
        created_at: string; // Date string in full ISO 8601 format, e.g. "2024-09-27T23:30:48.016Z"
        updated_at: string; // Date string in full ISO 8601 format, e.g. "2024-09-27T23:30:48.016Z"
    } | undefined;
}
﻿
If product does not have a version defined, it will return null
If product does not have any custom fields defined, it will return an empty array
Errors
If an error occurs, the response will have an HTTP status code of 400 or higher, and the response body will contain an error description in the following format:
TypeScript
JSON Schema
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "status": { "type": "number" },
    "code": { "type": "string" },
    "message": { "type": "string" }
  },
  "required": [
    "status",
    "code",
    "message"
  ],
  "additionalProperties": false
}
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "status": { "type": "number" },
    "code": { "type": "string" },
    "message": { "type": "string" }
  },
  "required": [
    "status",
    "code",
    "message"
  ],
  "additionalProperties": false
}
﻿
List of exceptions
unknown_product (400): Provided product was not found
missing_headers (400): Some headers are missing
missing_parameters (400): Some parameters are missing in the request: { params }
﻿
Updated 05 Mar 2025
Did this page help you?
List Products
Device Variables