younifyd
Menu

Get Product Models

Get list of product models

GET/api/rest/v1/product-models

Use it in a workflow

  1. Add a step and choose the Akeneo connector.
  2. Pick the Get Product Models action (under Product model).
  3. Fill in the fields below, then reference the result from later steps as {{getProductModels.response.data}}.

Request

Query parameters

searchstring

Filter product models, for more details see the [Filters](https://api.akeneo.com/documentation/filter.html).

scopestring

Filter product values to return scopable attributes for the given channel as well as the non localizable/non scopable attributes. It is useful for retrieving product information specific to a particular sales channel, which is essential for channel-specific applications. For more details see the [Filter product values via channel](https://api.akeneo.com/documentation/filter.html#via-channel) section.

localesstring

Filter product values to return localizable attributes for the given locales as well as the non localizable/non scopable attributes. It is useful for retrieving product information in specific languages, which is essential for multi-locale applications. For more details see the [Filter product values via locale](https://api.akeneo.com/documentation/filter.html#via-locale) section.

attributesstring

Filter product values to only return those concerning the given attributes. It is useful for limiting the response to specific attributes, reducing payload size and improving performance. For more details see the [Filter product values via attributes](https://api.akeneo.com/documentation/filter.html#via-attributes) section.

pagination_typestring

Specify which pagination method to use for navigating through large datasets. It is useful for choosing between different pagination strategies based on your specific use case and performance requirements. See [Pagination](https://api.akeneo.com/documentation/pagination.html) section for more details.

One ofpagesearch_afterDefault "page"

pageinteger

Specify which page of results to retrieve when using pagination. It is useful for navigating through large datasets by breaking them into smaller, manageable pages. See [Pagination](https://api.akeneo.com/documentation/pagination.html) section for more details.

Default 1

search_afterstring

Cursor when using the `search_after` pagination method type. It is essential for navigating through pages in cursor-based pagination, providing more efficient pagination for large datasets. Should never be set manually, see [Pagination](https://api.akeneo.com/documentation/pagination.html) section for more details.

Default "cursor to the first page"

limitinteger

Specify the maximum number of results to return per page. It is useful for controlling the amount of data returned in a single request, especially when dealing with large datasets. See [Pagination](https://api.akeneo.com/documentation/pagination.html) section for more details.

Default 10

search_scopestring

Filter scopes based on specific criteria. If you need to filter on several attributes on the same scope, you can use this parameter, to avoid repeating yourself for each attribute. For more details see the [Filters](https://api.akeneo.com/documentation/filter.html#search_scope-query-parameter) section.

search_localestring

Filter locales based on specific criteria. If you need to filter on several attributes on the same locale, you can use this parameter, to avoid repeating yourself for each attribute. For more details see the [Filters](https://api.akeneo.com/documentation/filter.html#search_locale-query-parameter) section.

convert_measurementsboolean

Convert measurement attribute values to the appropriate unit for the channel provided by the `scope` parameter. When set to `true`, the `scope` parameter is required.

Default false

with_countboolean

Return the count of items in the response. Be careful with that, on a big catalog, it can decrease performance in a significant way. It is useful for understanding the size of the dataset being returned, especially when dealing with large collections. Use it judiciously to avoid performance issues.

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

with_attribute_optionsboolean

Return labels of attribute options in the response. 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 model quality scores in the response.

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

Response

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

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