Get Product Uuid By Uuid

Get a product

GET/api/rest/v1/products-uuid/{uuid}

Use it in a workflow

Add a step and choose the Akeneo connector.
Pick the Get Product Uuid By Uuid action (under Product [uuid]).
Fill in the fields below, then reference the result from later steps as {{getProductUuidByUuid.response.data}}.

Request

Path parameters

uuidstring (uuid)required

This path parameter is used to specify the unique identifier of the entity you want to retrieve or manipulate. It is essential for identifying the specific entity in the API requests. Ensure that the UUID is correctly formatted and corresponds to an existing entity in the system.

Query parameters

with_attribute_optionsboolean

Return labels of attribute options in the response. When set to `true`, the response will include human-readable labels for attribute options alongside their codes. This is useful for displaying human-readable labels instead of just option codes, which improves the user experience in frontend applications. If set to `false`, the response will only include option codes, which can improve performance. See [the `linked_data` format](https://api.akeneo.com/concepts/products.html#the-linked_data-format) section for more details.

Default false

with_asset_share_linksboolean

Return asset collection share link URLs in the response. When set to `true`, the response will include direct URLs to asset collections for sharing purposes. This is useful for accessing direct links to asset collections, which can be used for sharing or external integrations. If set to `false`, the response will not include share links, which can improve performance. See [the `linked_data` format](https://api.akeneo.com/concepts/products.html#the-linked_data-format) for more details.

Default false

with_enabled_assets_onlyboolean

When set to `true`, disabled assets are excluded from asset collection values in the response. Only assets with `status: "enabled"` are returned. When set to `false` (default), all assets are returned regardless of their status.

Default false

with_quality_scoresboolean

Return product quality scores in the response. When set to `true`, the response will include quality score information for each product. This is useful for assessing and monitoring product data quality, which is essential for maintaining high data standards and improving product information. If set to `false`, the response will not include quality scores, which can improve performance.

Default false

with_completenessesboolean

Return product completenesses information in the response. When set to `true`, the response will include detailed completeness information for each product. This is useful for understanding the data quality and completeness of products, which is essential for product management and quality assurance. If set to `false`, the response will not include completeness information, which can improve performance.

Default false

with_readinessstring

Return readiness information in the response. - `scores_only`: include readiness percentage scores only. - `detailed`: include readiness percentage scores together with the list of unmet requirements. When omitted, no readiness information is returned. Readiness is currently in beta and is available by request only. If you would like to participate, please reach out to your Customer Success Manager.

One ofscores_onlydetailed

with_root_parentboolean

Return the root parent product model code of a variant in the response. When set to `true`, the response will include the root parent product model code for each variant product. This is useful for understanding the hierarchical relationship between product variants and their parent models, which is essential for product catalog navigation. If set to `false`, the response will not include parent model information, which can improve performance.

Default false

with_workflow_execution_statusesboolean

Return an array of workflow_execution_statuses directly associated with the requested entity (product or product model) in the response. Statuses are level-specific and are not inherited from parent models. For a complete overview of a variant product, you must query the variant itself and its parent model(s) in separate requests. Each workflow object contains: - The overall execution status (e.g., in_progress, completed). - A list of all associated tasks.

Default false

Response

Returns 200 with an object. Read it in later steps with {{getProductUuidByUuid.response.data.<field>}}.

uuidstring

Product UUID

enabledboolean

Whether the product is enabled

Default true

familystring | null

[Family](https://api.akeneo.com/api-reference.html#Family) code from which the product inherits its attributes and attributes requirements. In the case of variant product, the given family should be the same as the product model family.

Default "null only in the case of a non variant product"

categoriesarray<string>

Codes of the [categories](https://api.akeneo.com/api-reference.html#Category) in which the product is classified

Default []

groupsarray<string>

Codes of the groups to which the product belong. Each string of the array is equal to an existing group code.

Default []

parentstring | null

Code of the parent [product model](https://api.akeneo.com/api-reference.html#Productmodel) when the product is a variant

Default null

root_parentstring

Code of the root parent product model when the product is a variant (only available when the `with_root_parent` is set to `true`).

Default "null"

valuesobject

Product attributes values. Each key is an attribute code, and the value is an array of value objects for that attribute. See [documentation](https://api.akeneo.com/concepts/products.html#focus-on-the-product-values) for details.

associationsobject

Several associations related to groups, product models and/or other products, grouped by association types

quantified_associationsobject

Several quantified associations related to products and/or product models, grouped by quantified association types

createdstring (date-time)

Date of creation

updatedstring (date-time)

Date of the last update

metadataobject

More information around the product

workflow_statusstring

Status of the product regarding the user permissions

One ofread_onlydraft_in_progressproposal_waiting_for_approvalworking_copy

quality_scoresarray<object>

Product quality scores for each channel/locale combination (only available when the `with_quality_scores` query parameter is set to `true`).

scopestring

Channel code for which the quality score is calculated

localestring

Locale code for which the quality score is calculated

datastring

Quality score value for the given channel/locale combination

One ofABCDE

completenessesarray<object>

Product completenesses for each channel/locale combination (only available when the `with_completenesses` query parameter is set to `true`).

scopestring

Channel code for which the completenesses score is calculated

localestring

Channel code for which the completenesses score is calculated

datainteger

Completenesses score value for the given channel/locale combination

readinessobject

Readiness scores (only available when the `with_readiness` query parameter is set to `scores_only` or `detailed`). Readiness is currently in beta and is available by request only. If you would like to participate, please reach out to your Customer Success Manager.

aggregated_scores_by_scopearray<object>2 fields

Aggregated readiness score per channel: the average of the per-locale scores within each readiness, then averaged across the readiness configurations that apply to that channel (equal weight) and rounded.

scores_by_scope_and_localeobject

Readiness scores grouped by readiness code, for each channel/locale combination

workflow_execution_statusesarray<object>

Workflow execution statuses of the product (only available when the `with_workflow_execution_statuses` query parameter is set to `true`)

uuidstring

Workflow execution UUID

statusstring

Status of the workflow execution

One ofin_progresscompleted

started_atstring (date-time)

Date and time when the workflow execution was started

completed_atstring | null

Date and time when the workflow execution was completed, null if still in progress

workflowobject3 fields

Workflow associated with the workflow execution

tasksarray<object>4 fields

Tasks associated with the workflow execution

json

{
  "uuid": "fc24e6c3-933c-4a93-8a81-e5c703d134d5",
  "enabled": true,
  "family": "smartphone",
  "categories": [
    "smartphones",
    "electronics"
  ],
  "groups": [
    "summer_collection",
    "sale"
  ],
  "parent": "my_super_battery",
  "root_parent": "my_super_battery",
  "values": {
    "description": [
      {
        "data": "T-shirt long sleeves Winter special, 100% wool",
        "locale": null,
        "scope": null
      }
    ]
  },
  "associations": {
    "X_SELL": {
      "groups": [],
      "products": [
        "product_1",
        "product_2"
      ],
      "product_models": [
        "product_model_1"
      ]
    },
    "UPSELL": {
      "groups": [
        "group_1"
      ],
      "products": [],
      "product_models": []
    }
  },
  "quantified_associations": {
    "PACK": {
      "products": [
        {
          "uuid": "fc24e6c3-933c-4a93-8a81-e5c703d134d5",
          "quantity": 2
        },
        {
          "uuid": "aaf518b2-f91e-40f1-a53a-78ce5e81a6f9",
          "quantity": 3
        }
      ],
      "product_models": [
        {
          "identifier": "product_model_1",
          "quantity": 1
        }
      ]
    }
  },
  "created": "2022-03-14T15:25:45+00:00",
  "updated": "2022-06-24T12:54:58+00:00"
}

Need more? See the Akeneo guide for connection setup and behaviour shared by every action.

Was this page helpful?