> For the complete documentation index, see [llms.txt](https://vu-custom.gitbook.io/vu-custom/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://vu-custom.gitbook.io/vu-custom/admin-api/recipes/retrieving-recipes.md).

# Retrieving Recipes

Method : <mark style="color:green;">**GET**</mark>

{% code fullWidth="false" %}

```url
https://os.vucustom.com/api/v1/recipes/:recipe_id
```

{% endcode %}

Path Variables

<table><thead><tr><th width="187">Field Name</th><th>Description</th></tr></thead><tbody><tr><td>recipe_id</td><td>The 8 character token that represents the recipe, the data structure that contains selections made during the customization session. This is user generated.</td></tr><tr><td>api_version</td><td>current version is v1</td></tr></tbody></table>

<details>

<summary>Example Request</summary>

```
https://os.vucustom.com/api/v1/recipes/:recipe_id
```

</details>

{% tabs %}
{% tab title="200" %}
**`200 Successful response example`**

```json
{
    "data": {
        "token": "85e2fa21",
        "user_id": null,
        "sku": "XRS",
        "body": {
            "shell": {
                "tab": {
                    "name": "Shell",
                    "code": "shell"
                },
                "element": {
                    "type": "material",
                    "name": "Shell Color",
                    "code": "shell"
                },
                "value": {
                    "name": "White",
                    "code": "W",
                    "upcharge": 0,
                    "swatch": "#FFFFFF",
                    "companions": []
                },
                "companions": []
            },
            "jawbone": {
                "tab": {
                    "name": "Jawbone",
                    "code": "jawbone"
                },
                "element": {
                    "type": "material",
                    "name": "Jawbone",
                    "code": "jawbone"
                },
                "value": {
                    "name": "White",
                    "code": "W",
                    "upcharge": 0,
                    "swatch": "#FFFFFF",
                    "companions": []
                },
                "companions": []
            },
            "chinstrap": {
                "tab": {
                    "name": "Chinstrap",
                    "code": "chinstrap"
                },
                "element": {
                    "type": "material",
                    "name": "Chinstrap",
                    "code": "chinstrap"
                },
                "value": {
                    "name": "Scarlet Red",
                    "code": "S",
                    "upcharge": 9.99,
                    "swatch": "#FF0000",
                    "companions": []
                },
                "companions": [
                    {
                        "element": "chin_cup",
                        "value": "white"
                    }
                ]
            },
            "chin_washer": {
                "tab": {
                    "name": "Chin & Washer",
                    "code": "chin_washer"
                },
                "element": {
                    "type": "material",
                    "name": "Chin & Washer",
                    "code": "chin_washer"
                },
                "value": {
                    "name": "White",
                    "code": "W",
                    "upcharge": 0,
                    "swatch": "#FFFFFF",
                    "companions": []
                },
                "companions": []
            },
            "mask": {
                "tab": {
                    "name": "Mask",
                    "code": "mask"
                },
                "element": {
                    "type": "material",
                    "name": "Mask",
                    "code": "mask"
                },
                "value": {
                    "name": "White Pearl",
                    "code": "XPWP",
                    "upcharge": 30,
                    "swatch": "#FFFFFF",
                    "companions": []
                },
                "companions": []
            },
            "throat_guard": {
                "tab": {
                    "name": "Goalie Throat Guard",
                    "code": "throat_guard"
                },
                "element": {
                    "type": "material",
                    "name": "Goalie Throat Guard",
                    "code": "throat_guard"
                },
                "value": {
                    "name": "No Throat Guard",
                    "code": "none",
                    "upcharge": 0,
                    "swatch": "#FAFAFA",
                    "companions": []
                },
                "companions": []
            },
            "quick_clip": {
                "tab": {
                    "name": "Chinstrap",
                    "code": "chinstrap"
                },
                "element": {
                    "type": "list",
                    "name": "Fastener",
                    "code": "quick_clip"
                },
                "value": {
                    "name": "Traditional",
                    "code": "no",
                    "upcharge": "0"
                }
            },
            "black": {
                "tab": {
                    "name": "Ancillary Items",
                    "code": "ancillary_items",
                    "hidden": true
                },
                "element": {
                    "type": "material",
                    "name": "Black",
                    "code": "black"
                },
                "value": {
                    "name": "Black",
                    "code": "black",
                    "upcharge": 0,
                    "swatch": "#000000",
                    "companions": []
                },
                "companions": []
            },
            "metallics": {
                "tab": {
                    "name": "Ancillary Items",
                    "code": "ancillary_items",
                    "hidden": true
                },
                "element": {
                    "type": "material",
                    "name": "Metallics",
                    "code": "metallics"
                },
                "value": {
                    "name": "Silver",
                    "code": "silver",
                    "upcharge": 0,
                    "swatch": "#d8d8d8",
                    "companions": []
                },
                "companions": []
            },
            "grey": {
                "tab": {
                    "name": "Ancillary Items",
                    "code": "ancillary_items",
                    "hidden": true
                },
                "element": {
                    "type": "material",
                    "name": "Grey",
                    "code": "grey"
                },
                "value": {
                    "name": "Grey",
                    "code": "grey",
                    "upcharge": 0,
                    "swatch": "#707372",
                    "companions": []
                },
                "companions": []
            },
            "chin_cup": {
                "tab": {
                    "name": "Ancillary Items",
                    "code": "ancillary_items",
                    "hidden": true
                },
                "element": {
                    "type": "material",
                    "name": "Chin Cup",
                    "code": "chin_cup"
                },
                "value": {
                    "name": "White",
                    "code": "white",
                    "upcharge": 0,
                    "swatch": "#FFFFFF",
                    "companions": []
                },
                "companions": []
            }
        },
        "created_at": "2023-12-06T19:27:10.785+00:00",
        "images": {
            "shell": "https://silhouette3.jtbcustom.com/api/recipes/85e2fa21/images/shell",
            "thumbnail": "https://silhouette3.jtbcustom.com/api/recipes/85e2fa21/images/thumbnail"
        }
    }
}
```

{% endtab %}

{% tab title="401 " %}
**`401 Unauthorized`**

`The client doesn’t have correct authentication credentials.`

```
{
"errors": "[API] Invalid API key or secret (unrecognized login or wrong password)"
}
```

{% endtab %}

{% tab title="403" %}
**`403 Forbidden`**

`The server is refusing to respond. This is typically caused by incorrect access.`
{% endtab %}

{% tab title="404" %}
**`404 Not Found`**

`The requested resource was not found but could be available again in the future.`
{% endtab %}

{% tab title="422" %}
**`422 Unprocessable Entity`**
{% endtab %}

{% tab title="5xx" %}
**`5xx Errors`**

`An internal error occurred in VU Admin.`
{% endtab %}
{% endtabs %}