aid: tandoor
name: Tandoor Recipes
description: >-
  Tandoor Recipes is an open-source, self-hostable recipe management, meal planning and shopping-list
  application built on Django and django-rest-framework, developed in Falkensee, Germany and offered
  both as freely self-hosted software (Docker, Kubernetes, Unraid, Synology, TrueNAS) and as a paid
  hosted service at app.tandoor.dev. Every feature of the product is driven by one REST API — recipes,
  steps, ingredients, foods, units, unit conversions, properties and nutrition, keywords, meal plans,
  meal types, shopping lists and shopping-list entries, supermarkets and supermarket category
  ordering, pantry inventory, recipe books, cook/view logs, spaces and households, user preferences,
  invite and share links, storage backends and external recipe sync, import/export of a dozen recipe
  formats, URL/image/PDF recipe scraping, an AI import and property-extraction pipeline routed through
  LiteLLM, and the Open Data food/unit/store reference database. The API is described by a live
  drf-spectacular OpenAPI 3.0.3 document served without authentication at /openapi/ on every instance,
  covering 244 paths and 462 operations across 244 component schemas, and it is the same contract the
  official Vue 3 frontend is generated against.
url: https://raw.githubusercontent.com/api-evangelist/tandoor/refs/heads/main/apis.yml
image: https://raw.githubusercontent.com/TandoorRecipes/recipes/develop/docs/logo_color.svg
x-type: company
x-source: harvest:health-device-stack
specificationVersion: '0.20'
created: '2026-08-27'
modified: '2026-08-27'
tags:
  - Recipes
  - Meal Planning
  - Food
  - Nutrition
  - Shopping Lists
  - Open Source
  - Self-Hosted
  - Home Automation
  - Django
  - Open Data
tags_raw:
  - recipes
  - meal-planning
  - food
  - nutrition
  - shopping-lists
  - open-source
  - self-hosted
  - home-automation
  - django
  - open-data
apis:
  - name: Tandoor API
    description: >-
      The single REST API behind Tandoor Recipes, generated by django-rest-framework and described by a
      drf-spectacular OpenAPI 3.0.3 document. 244 paths / 462 operations covering recipes, steps and
      ingredients, foods, units and unit conversions, properties and nutrition, keywords, meal plans,
      shopping lists, supermarkets and category ordering, pantry inventory, recipe books, spaces and
      households, user preferences and permissions, invite/share links, external storage sync,
      import/export, URL and AI recipe import, and the Open Data reference database. Authentication is
      by an access token sent in the Authorization header (ApiKeyAuth in the spec) or by session
      cookie; page/page_size cursorless pagination is used on every list endpoint.
    humanURL: https://docs.tandoor.dev/
    baseURL: https://app.tandoor.dev/api/
    tags:
      - Recipes
      - Meal Planning
      - Food
      - Nutrition
      - Shopping Lists
      - Open Source
      - Self-Hosted
      - Open Data
    tags_raw:
      - recipes
      - meal-planning
      - food
      - nutrition
      - shopping-lists
      - open-source
      - self-hosted
      - open-data
    properties:
      - type: OpenAPI
        url: openapi/tandoor-api-openapi.yml
      - type: OpenAPI
        url: https://app.tandoor.dev/openapi/
      - type: Documentation
        url: https://docs.tandoor.dev/
      - type: Authentication
        url: authentication/tandoor-authentication.yml
      - type: Conventions
        url: conventions/tandoor-conventions.yml
      - type: DataModel
        url: data-model/tandoor-data-model.yml
      - type: Overlay
        url: overlays/tandoor-api-overlay.yaml
common:
  - type: DomainSecurity
    url: security/tandoor-domain-security.yml
  - type: Website
    url: https://tandoor.dev
  - type: DeveloperPortal
    url: https://docs.tandoor.dev/
  - type: Documentation
    url: https://docs.tandoor.dev/
  - type: GettingStarted
    url: https://docs.tandoor.dev/install/docker/
  - type: Support
    url: https://tandoor.dev/support/
  - type: HelpCenter
    url: https://community.tandoor.dev/
  - type: GitHubOrganization
    url: https://github.com/TandoorRecipes
  - type: SourceCode
    url: https://github.com/TandoorRecipes/recipes
  - type: Pricing
    url: https://tandoor.dev/#pricing
  - type: SignUp
    url: https://app.tandoor.dev/accounts/signup/
  - type: Login
    url: https://app.tandoor.dev/accounts/login/
  - type: TermsOfService
    url: https://tandoor.dev/terms/
  - type: PrivacyPolicy
    url: https://tandoor.dev/privacy/
  - type: StatusPage
    url: https://status.tandoor.dev/status/tandoor
  - type: ChangeLog
    url: https://github.com/TandoorRecipes/recipes/releases
  - type: ChangeLog
    url: changelog/tandoor-changelog.yml
  - type: Security
    url: https://github.com/TandoorRecipes/recipes/security/policy
  - type: Plans
    url: plans/tandoor-plans-pricing.yml
  - type: RateLimits
    url: rate-limits/tandoor-rate-limits.yml
  - type: Packages
    url: packages/tandoor-packages.yml
  - type: Lifecycle
    url: lifecycle/tandoor-lifecycle.yml
  - type: Conformance
    url: conformance/tandoor-conformance.yml
  - type: LLMsTxt
    url: llms/tandoor-llms.txt
  - type: Authentication
    url: authentication/tandoor-authentication.yml
  - type: Conventions
    url: conventions/tandoor-conventions.yml
  - type: DataModel
    url: data-model/tandoor-data-model.yml
  - type: AgentSkill
    url: skills/_index.yml
  - type: VulnerabilityDisclosure
    url: security/tandoor-vulnerability-disclosure.yml
maintainers:
  - FN: Kin Lane
    email: kin@apievangelist.com
  - FN: APIs.json
    email: info@apis.io
x-enrichment:
  date: '2026-08-27'
  status: enriched
  artifacts_added: 17
  pass: local-v1