---
search:
  tags:
    - Recipes
    - GET
seo:
  description: >-
    A recipe of the account, or a public one, with its ingredients, instructions
    and… Reference for the GET /recipes/{recipe_id} endpoint in the Almendra
    API.
sidebar:
  label: Get a recipe
  badge: GET
title: Get a recipe
type: openapi-operation
---
A recipe of the account, or a public one, with its ingredients, instructions and nutrients.

Requires the `library:read` permission.

`GET /recipes/{recipe_id}`

**Responses**

- `200` — Recipe
- `400` — Invalid path parameter, query parameter or request body
- `401` — Missing or invalid API key
- `403` — The account behind the API key has no active paid plan, or the key lacks the permission this operation needs
- `404` — Recipe not found
- `429` — Rate limit exceeded (600 requests per 60 seconds); retry after \`Retry-After\` seconds
- `500` — Unexpected server error

Response example, 200:

```json
{
  "_id": "string",
  "name": "Quinua con pollo",
  "portions": 0,
  "preparationTimeMinutes": 0,
  "cookingTimeMinutes": 0,
  "caloriesKcal": 0,
  "proteinG": 0,
  "carbsG": 0,
  "fatG": 0,
  "tags": [
    "string"
  ],
  "imageUrl": "string",
  "isPublic": true,
  "isDraft": true,
  "createdByThisAccount": true,
  "difficulty": "string",
  "ingredients": [
    {
      "food": "string",
      "foodName": "string",
      "quantity": 0,
      "unit": "string"
    }
  ],
  "instructions": [
    "string"
  ],
  "nutrients": {
    "fiber_g": 0,
    "sodium_mg": 74,
    "iron_mg": 1
  },
  "measures": [
    {
      "amount": 1,
      "description": "taza",
      "grams": 240
    }
  ]
}
```
