Akeneo PIM REST API
  1. Product model
Akeneo PIM REST API
  • Authentication
    • Get authentication token
      POST
  • Overview
    • Get list of all endpoints
      GET
  • PAM asset category
    • Get list of PAM asset categories
      GET
    • Update/create several PAM asset categories
      PATCH
    • Create a new PAM asset category
      POST
    • Get a PAM asset category
      GET
    • Update/create a PAM asset category
      PATCH
  • Asset family
    • Get list of asset families
      GET
    • Get an asset family
      GET
    • Update/create an asset family
      PATCH
  • Asset
    • Get the list of the assets of a given asset family
      GET
    • Update/create several assets
      PATCH
    • Delete an asset
      DELETE
    • Get an asset of a given asset family
      GET
    • Update/create an asset
      PATCH
  • Asset attribute
    • Get the list of attributes of a given asset family
      GET
    • Get an attribute of a given asset family
      GET
    • Update/create an attribute of a given asset family
      PATCH
  • Asset attribute option
    • Get a list of attribute options of a given attribute for a given asset family
    • Get an attribute option for a given attribute of a given asset family
    • Update/create an asset attribute option for a given asset family
  • Asset media file
    • Create a new media file for an asset
    • Download the media file associated to an asset
  • PAM asset tag
    • Get list of PAM asset tags
    • Get a PAM asset tag
    • Update/create a PAM asset tag
  • PAM asset
    • Get list of PAM assets
    • Update/create several PAM assets
    • Create a new PAM asset
    • Get a PAM asset
    • Update/create a PAM asset
  • PAM asset reference file
    • Get a reference file
    • Upload a new reference file
    • Download a reference file
  • PAM asset variation file
    • Get a variation file
    • Upload a new variation file
    • Download a variation file
  • Association type
    • Get a list of association types
    • Update/create several association types
    • Create a new association type
    • Get an association type
    • Update/create an association type
  • Attribute group
    • Get list of attribute groups
    • Update/create several attribute groups
    • Create a new attribute group
    • Get an attribute group
    • Update/create an attribute group
  • Attribute
    • Get list of attributes
    • Update/create several attributes
    • Create a new attribute
    • Get an attribute
    • Update/create an attribute
  • Attribute option
    • Get list of attribute options
    • Update/create several attribute options
    • Create a new attribute option
    • Get an attribute option
    • Update/create an attribute option
  • Category
    • Get list of categories
    • Update/create several categories
    • Create a new category
    • Get a category
    • Update/create a category
    • Download a category media file [COMING SOON]
  • Channel
    • Get a list of channels
    • Update/create several channels
    • Create a new channel
    • Get a channel
    • Update/create a channel
  • Currency
    • Get a list of currencies
    • Get a currency
  • Family
    • Get list of families
    • Update/create several families
    • Create a new family
    • Get a family
    • Update/create a family
    • Create a new family variant
  • Family variant
    • Get list of family variants
    • Update/create several family variants
    • Get a family variant
    • Update/create a family variant
  • Locale
    • Get a list of locales
    • Get a locale
  • Measure family
    • Get list of measure familiy
    • Get a measure family
  • Measurement family
    • Get list of measurement families
    • Update/create several measurement families
  • Product media file
    • Get a list of product media files
    • Create a new product media file
    • Get a product media file
    • Download a product media file
  • Product model
    • Get list of product models
      GET
    • Update/create several product models
      PATCH
    • Create a new product model
      POST
    • Delete a product model
      DELETE
    • Get a product model
      GET
    • Update/create a product model
      PATCH
    • Get a draft
      GET
    • Submit a draft for approval
      POST
  • Product
    • Get list of products
    • Update/create several products
    • Create a new product
    • Delete a product
    • Get a product
    • Update/create a product
    • Get a draft
    • Submit a draft for approval
  • Published product
    • Get list of published products
    • Get a published product
  • Reference entity
    • Get list of reference entities
    • Get a reference entity
    • Update/create a reference entity
  • Reference entity media file
    • Create a new media file for a reference entity or a record
    • Download the media file associated to a reference entity or a record
  • Reference entity attribute
    • Get the list of attributes of a given reference entity
    • Get an attribute of a given reference entity
    • Update/create an attribute of a given reference entity
  • Reference entity attribute option
    • Get a list of attribute options of a given attribute for a given reference entity
    • Get an attribute option for a given attribute of a given reference entity
    • Update/create a reference entity attribute option
  • Reference entity record
    • Get the list of the records of a reference entity
    • Update/create several reference entity records
    • Get a record of a given reference entity
    • Update/create a record of a given reference entity
  • System
    • Get system information
    • Get system information
  • Catalogs
    • Get the list of owned catalogs
    • Create a new catalog
    • Delete a catalog
    • Get a catalog
    • Update a catalog
  • Catalog products
    • Get the list of product uuids
    • Get the list of products related to a catalog
    • Get a product related to a catalog
  • Product [identifier]
    • Get list of products
    • Update/create several products
    • Create a new product
    • Delete a product
    • Get a product
    • Update/create a product
    • Get a draft
    • Submit a draft for approval
  • Product [uuid]
    • Get list of products
    • Update/create several products
    • Create a new product
    • Delete a product
    • Get a product
    • Update/create a product
    • Get a draft
    • Submit a draft for approval
  1. Product model

Get a product model

GET
/api/rest/v1/product-models/{code}
Product model
This endpoint allows you to get the information about a given product model. In the Entreprise Edition, since the v2.0, permissions based on your user groups are applied to the product model you request.
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request GET '/api/rest/v1/product-models/'
Response Response Example
200 - Example 1
{
  "associations": {
    "PACK": {
      "groups": [],
      "product_models": [],
      "products": [
        "sunglass"
      ]
    }
  },
  "categories": [
    "summer_collection"
  ],
  "code": "model-biker-jacket-leather",
  "created": "2023-08-15T05:53:50.712Z",
  "family": "clothing",
  "family_variant": "clothing_material_size",
  "parent": "model-biker-jacket",
  "quality_scores": [
    {
      "data": "A",
      "locale": "en_US",
      "scope": "ecommerce"
    },
    {
      "data": "B",
      "locale": "fr_FR",
      "scope": "ecommerce"
    },
    {
      "data": "D",
      "locale": "en_US",
      "scope": "tablet"
    },
    {
      "data": "E",
      "locale": "fr_FR",
      "scope": "tablet"
    }
  ],
  "quantified_associations": {
    "PRODUCT_SET": {
      "product_models": [
        {
          "code": "model-biker-jacket-leather",
          "quantity": 2
        }
      ],
      "products": [
        {
          "identifier": "top",
          "quantity": 2
        },
        {
          "identifier": "cap",
          "quantity": 1
        }
      ]
    }
  },
  "updated": "2023-08-15T05:53:50.712Z",
  "values": {
    "collection": [
      {
        "data": [
          "summer_2017"
        ],
        "locale": null,
        "scope": null
      }
    ],
    "color": [
      {
        "data": "antique_white",
        "locale": null,
        "scope": null
      }
    ],
    "description": [
      {
        "data": "Biker jacket",
        "locale": "en_US",
        "scope": "ecommerce"
      }
    ],
    "material": [
      {
        "data": "leather",
        "locale": null,
        "scope": null
      }
    ],
    "name": [
      {
        "data": "Biker jacket",
        "locale": "en_US",
        "scope": null
      }
    ],
    "variation_name": [
      {
        "data": "Biker jacket leather",
        "locale": "en_US",
        "scope": null
      }
    ]
  }
}

Request

Path Params
code
string 
required
Code of the resource
Query Params
with_quality_scores
string 
optional
Return product model quality scores in the response. (Only available since the 6.0 version)

Responses

🟢200OK
application/json
Body
associations
object 
optional
Several associations related to groups, product and/or other product models, grouped by association types
associationTypeCode
object 
optional
categories
array[string]
optional
Codes of the categories in which the product model is categorized
code
string 
required
Product model code
created
string <dateTime>
optional
Date of creation
family
string 
optional
Family code from which the product inherits its attributes and attributes requirements (since the 3.2)
family_variant
string 
required
Family variant code from which the product model inherits its attributes and variant attributes
metadata
object 
optional
More information around the product model (only available since the v2.3 in the Enterprise Edition)
workflow_status
enum<string> 
optional
Status of the product model regarding the user permissions
Allowed values:
read_onlydraft_in_progressproposal_waiting_for_approvalworking_copy
parent
string 
optional
Code of the parent product model. This parent can be modified since the 2.3.
Default:
null
quality_scores
object 
optional
Product model quality scores for each channel/locale combination (only available since the 7.0 version and when the "with_quality_scores" query parameter is set to "true")
quantified_associations
object 
optional
Several quantified associations related to products and/or product models, grouped by quantified association types (only available since the 5.0)
quantifiedAssociationTypeCode
object 
optional
updated
string <dateTime>
optional
Date of the last update
values
object 
optional
Product model attributes values, see Product values section for more details
attributeCode
array [object {3}] 
optional
🟠401Authentication required
🟠404Resource not found
🟠406Not Acceptable
Modified at 2023-08-15 05:53:55
Previous
Delete a product model
Next
Update/create a product model
Built with