# Unit Conversion

### Use case request example

#### API endpoint

Url:

[`GET /recipe/v2/{id}`](https://api.whisk.com/spec/#/RecipeAPI/RecipeAPI_GetRecipe)

Fields:

`RECIPE_FIELD_NORMALIZED_INGREDIENTS`

Request example(pls use your token and recipe id):

```bash
curl -X GET "https://api.whisk.com/recipe/v2/%RECIPE_ID%?fields=RECIPE_FIELD_NORMALIZED_INGREDIENTS" \
-H "accept: application/json" \
-H "Authorization: Bearer %USER_TOKEN%"
```

We use `RECIPE_FIELD_NORMALIZED_INGREDIENTS` field to have normalised ingredients with their measurements in response

Response example (for single normalised ingredient):

```json
{
                "analysis": {
                    "alternative_measurements": [
                        {
                            "amount": {
                                "quantity": 120,
                                "unit": "g"
                            },
                            "measurement_system": "MEASUREMENT_SYSTEM_METRIC"
                        },
                        {
                            "amount": {
                                "quantity": 0.5,
                                "unit": "cup"
                            },
                            "measurement_system": "MEASUREMENT_SYSTEM_IMPERIAL"
                        }
                    ],
                    "brand": {
                        "canonical_name": "CANNED FOODS"
                    },
                    "category": {
                        "canonical_name": "CANNED FOODS"
                    },
                    "comment": "drained",
                    "image_url": "<https://image-cdn.whisk.com/image/upload/v1552312241/custom_upload/44fa21d42ac048f6d14666536ec27991.jpg>",
                    "product": {
                        "canonical_name": "CANNED TOMATO",
                        "original_name": "canned tomatoes"
                    },
                    "quantity": 0.5,
                    "unit": "cup"
                },
                "id": "b5b42e89c2d9ba4948657ffd42093f078b1c4eb0:4:0",
                "source_text": "½ cup canned tomatoes (drained)",
                "text": "0.5 cup canned tomatoes"
            },
```

Default quantity and measurement should be taken from `analysis.quantity` and `analysis.unit` Default view would containt original ingredients quantity and measurment despite whether it metric or imperial.

If user switches measurement to Metric, on FE we should take quantity and measurement from `analysis.alternative_measurments.ammount.quantity` and `analysis.alternative_measurments.ammount.unit`

where `"measurement_system": "MEASUREMENT_SYSTEM_METRIC"`

Or `"measurement_system": "MEASUREMENT_SYSTEM_IMPERIAL"` for imperial.