Show product details.

get

https://api-us.bluestonepim.com/pim/products/{id}

Returns the full details of a single product by its internal ID, including its metadata, attributes,
categories, relations and assets. Fails if no product with the specified ID exists. For a lighter summary of a
product without the full data set, use the product overview endpoint (GET /products/{id}/overview) instead.

For more detailed information on how to work with the Management API (MAPI) in Bluestone PIM, refer to our help
pages Get started with Management API.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Path Params

string

required

The internal ID for the product you want to retrieve.

Example: 634c26e14cedfd0001775e9f

Query Params

archiveState

string

Specifies the archive state of the entity. The default value is active.

Headers

context

string

Specifies the context in which to operate. If omitted, the default context en is used.

In Bluestone PIM, the context is generally synonymous with the language setting. The context determines how product information is tailored and presented based on language or other local specifications.

For more detailed information on how context relates to language settings in Bluestone PIM, refer to the Languages and Context documentation.

Note: The default context is identified by the ID "en". IDs for additional contexts begin with a lowercase "L", not with the digit "1", followed by a number. This naming convention helps distinguish between default and custom contexts within Bluestone PIM.

context-fallback

boolean

Specifies whether to enable the fallback mechanism for the context. If omitted, the default value true will be used. When set to true, the system will provide a default translation or relevant information if the requested context's specific translation is missing.

For more detailed information on how context relates to language settings in Bluestone PIM, refer to the Languages and Context documentation.

Note: Setting the context-fallback parameter to false disables the fallback mechanism. In this configuration, if a translation or specific context information is not available, the system will not provide an alternative or default content. This ensures that only content that matches the exact context ID requested is returned, potentially leading to cases where no content is available if the specific translation is missing.

string

enum

Defaults to application/full+json

Generated from available response content types

Allowed:

Responses

Language

Credentials

OAuth2

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/full+json

application/json

200OK This response indicates that the request to retrieve a product was successful. The response body contains the details of the product, formatted as a JSON object.

400Bad Request This response indicates that the server could not understand the request due to invalid syntax. It is typically triggered by client-side input errors such as improperly formatted requests, missing required fields, or invalid data values.

404Not Found This response indicates that the requested resource could not be found on the server. It typically occurs when no resource matches the requested URI, or the resource identifier used in the request does not exist.