# Get Recipe Categories

This endpoint allows getting all available categories for a specific language.

## Get Recipe Categories

<mark style="color:green;">`POST`</mark> `https://graph.whisk.com/v1/recipes/categories`

#### Path Parameters

| Name    | Type   | Description                       |
| ------- | ------ | --------------------------------- |
| country | string | Country ISO code. Default is `gb` |
| limit   | number | Number of categories              |

{% tabs %}
{% tab title="200 " %}

```javascript
{
  "categories": [
    {
      "id": "quick-and-easy",
      "displayName": "Quick and easy",
      "image": {
        "url": "https://whisk-res.cloudinary.com/image/upload/v1523894700/custom_upload/ba4d7363cd46c736675d2cc08754f5bc.png",
        "width": 800,
        "height": 800
      }
    },
    {
      "id": "healthy-recipes",
      "displayName": "Healthy Recipes",
      "image": {
        "url": "https://whisk-res.cloudinary.com/image/upload/v1523894700/custom_upload/ba4d7363cd46c736675d2cc08754f5bc.png",
        "width": 800,
        "height": 800
      }
    },
    {
      "id": "holidays-and-events",
      "displayName": "Holidays and Events",
      "image": {
        "url": "https://whisk-res.cloudinary.com/image/upload/v1523894700/custom_upload/ba4d7363cd46c736675d2cc08754f5bc.png",
        "width": 800,
        "height": 800
      }
    },
    {
      "id": "baking",
      "displayName": "Baking",
      "image": {
        "url": "https://whisk-res.cloudinary.com/image/upload/v1523894700/custom_upload/ba4d7363cd46c736675d2cc08754f5bc.png",
        "width": 800,
        "height": 800
      }
    },
    {
      "id": "bbq-and-grilling",
      "displayName": "BBQ & Grilling",
      "image": {
        "url": "https://whisk-res.cloudinary.com/image/upload/v1523894700/custom_upload/ba4d7363cd46c736675d2cc08754f5bc.png",
        "width": 800,
        "height": 800
      }
    }
  ],
  "paging": {
    "cursors": {
      "after": "eyJpZCI6ImRlc3NlcnRzIiwiaW5kZXgiOjR9"
    }
  }
}
```

{% endtab %}
{% endtabs %}

### Sample Request

```bash
curl "https://graph.whisk.com/v1/recipes/categories?country=gb&limit=5" \
    -H "Accept: application/json" \
    -H "Authorization: Token <Access-Token>"
```

## Response

The result is a list of all available categories corresponding to the required region. You can use these categories for filtering recipes in [search](https://docs.whisk.com/master/api/recipe-discovery/recipe-search).

| ATTRIBUTE    | TYPE                                       | DESCRIPTION |
| ------------ | ------------------------------------------ | ----------- |
| categories\* | array \[[RecipeCategory](#recipecategory)] |             |
| paging       | [Paging](#paging)                          |             |

### RecipeCategory

| ATTRIBUTE     | TYPE            | DESCRIPTION |
| ------------- | --------------- | ----------- |
| id\*          | string          |             |
| displayName\* | string          |             |
| image         | ResponsiveImage |             |

### Paging

| ATTRIBUTE | TYPE                | DESCRIPTION |
| --------- | ------------------- | ----------- |
| cursors\* | [Cursors](#cursors) |             |

### Cursors

| ATTRIBUTE | TYPE   | DESCRIPTION |
| --------- | ------ | ----------- |
| after     | string |             |
| before    | string |             |