The Ingredient API from Tandoor Recipes — 2 operation(s) for ingredient.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.curl "https://apis.io/api/v1/apis/tandoor:tandoor-ingredient-api"curl "https://apis.io/api/v1/apis?limit=25"Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
openapi: 3.2.0
info:
title: Tandoor Ingredient API
version: 0.0.0 (2.6.13)
x-logo:
url: /static/assets/brand_logo.svg
backgroundColor: '#FFFFFF'
altText: Tandoor logo
href: /
description: Tandoor API Docs
tags:
- name: Ingredient
paths:
/api/ingredient/:
get:
operationId: apiIngredientList
description: logs request counts to redis cache total/per user/
parameters:
- in: query
name: food
schema:
type: integer
description: ID of food to filter for
- name: page
required: false
in: query
description: A page number within the paginated result set.
schema:
type: integer
- name: page_size
required: false
in: query
description: Number of results to return per page.
schema:
type: integer
- in: query
name: unit
schema:
type: integer
description: ID of unit to filter for
tags:
- Ingredient
security:
- ApiKeyAuth: []
responses:
'200':
content:
application/json:
schema:
$ref: '#/components/schemas/PaginatedIngredientList'
description: ''
summary: Api ingredient list
x-summary-source: derived
post:
operationId: apiIngredientCreate
description: logs request counts to redis cache total/per user/
tags:
- Ingredient
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/Ingredient'
application/x-www-form-urlencoded:
schema:
$ref: '#/components/schemas/Ingredient'
multipart/form-data:
schema:
$ref: '#/components/schemas/Ingredient'
required: true
security:
- ApiKeyAuth: []
responses:
'201':
content:
application/json:
schema:
$ref: '#/components/schemas/Ingredient'
description: ''
summary: Api ingredient create
x-summary-source: derived
/api/ingredient/{id}/:
get:
operationId: apiIngredientRetrieve
description: logs request counts to redis cache total/per user/
parameters:
- in: path
name: id
schema:
type: integer
description: A unique integer value identifying this ingredient.
required: true
tags:
- Ingredient
security:
- ApiKeyAuth: []
responses:
'200':
content:
application/json:
schema:
$ref: '#/components/schemas/Ingredient'
description: ''
summary: Api ingredient retrieve
x-summary-source: derived
put:
operationId: apiIngredientUpdate
description: logs request counts to redis cache total/per user/
parameters:
- in: path
name: id
schema:
type: integer
description: A unique integer value identifying this ingredient.
required: true
tags:
- Ingredient
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/Ingredient'
application/x-www-form-urlencoded:
schema:
$ref: '#/components/schemas/Ingredient'
multipart/form-data:
schema:
$ref: '#/components/schemas/Ingredient'
required: true
security:
- ApiKeyAuth: []
responses:
'200':
content:
application/json:
schema:
$ref: '#/components/schemas/Ingredient'
description: ''
summary: Api ingredient update
x-summary-source: derived
patch:
operationId: apiIngredientPartialUpdate
description: logs request counts to redis cache total/per user/
parameters:
- in: path
name: id
schema:
type: integer
description: A unique integer value identifying this ingredient.
required: true
tags:
- Ingredient
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/PatchedIngredient'
application/x-www-form-urlencoded:
schema:
$ref: '#/components/schemas/PatchedIngredient'
multipart/form-data:
schema:
$ref: '#/components/schemas/PatchedIngredient'
security:
- ApiKeyAuth: []
responses:
'200':
content:
application/json:
schema:
$ref: '#/components/schemas/Ingredient'
description: ''
summary: Api ingredient partial update
x-summary-source: derived
delete:
operationId: apiIngredientDestroy
description: logs request counts to redis cache total/per user/
parameters:
- in: path
name: id
schema:
type: integer
description: A unique integer value identifying this ingredient.
required: true
tags:
- Ingredient
security:
- ApiKeyAuth: []
responses:
'204':
description: No response body
summary: Api ingredient destroy
x-summary-source: derived
components:
schemas:
PaginatedIngredientList:
type: object
required:
- count
- results
properties:
count:
type: integer
example: 123
next:
type:
- string
- 'null'
format: uri
example: http://api.example.org/accounts/?page=4
previous:
type:
- string
- 'null'
format: uri
example: http://api.example.org/accounts/?page=2
results:
type: array
items:
$ref: '#/components/schemas/Ingredient'
timestamp:
type: string
format: date-time
PropertyType:
type: object
description: Adds nested create feature
properties:
id:
type: integer
readOnly: false
name:
type: string
maxLength: 128
unit:
type:
- string
- 'null'
maxLength: 64
description:
type:
- string
- 'null'
maxLength: 512
order:
type: integer
default: 0
open_data_slug:
type:
- string
- 'null'
maxLength: 128
fdc_id:
type:
- integer
- 'null'
maximum: 2147483647
minimum: -2147483648
required:
- name
ShoppingList:
type: object
description: Adds nested create feature
properties:
id:
type: integer
readOnly: false
name:
type: string
maxLength: 32
description:
type: string
color:
type:
- string
- 'null'
maxLength: 7
required: []
FoodInheritField:
type: object
description: "Moves `UniqueValidator`'s from the validation stage to the save stage.\nIt solves the problem with nested validation for unique fields on update.\n\nIf you want more details, you can read related issues and articles:\nhttps://github.com/beda-software/drf-writable-nested/issues/1\nhttp://www.django-rest-framework.org/api-guide/validators/#updating-nested-serializers\n\nExample of usage:\n```\n class Child(models.Model):\n field = models.CharField(unique=True)\n\n\nclass Parent(models.Model):\n child = models.ForeignKey('Child')\n\n\nclass ChildSerializer(UniqueFieldsMixin, serializers.ModelSerializer):\n class Meta:\n model = Child\n\n\nclass ParentSerializer(NestedUpdateMixin, serializers.ModelSerializer):\n child = ChildSerializer()\n\n class Meta:\n model = Parent\n```\n\nNote: `UniqueFieldsMixin` must be applied only on the serializer\nwhich has unique fields.\n\nNote: When you are using both mixins\n(`UniqueFieldsMixin` and `NestedCreateMixin` or `NestedUpdateMixin`)\nyou should put `UniqueFieldsMixin` ahead."
properties:
id:
type: integer
readOnly: false
name:
type:
- string
- 'null'
field:
type:
- string
- 'null'
required: []
Unit:
type: object
description: "Moves `UniqueValidator`'s from the validation stage to the save stage.\nIt solves the problem with nested validation for unique fields on update.\n\nIf you want more details, you can read related issues and articles:\nhttps://github.com/beda-software/drf-writable-nested/issues/1\nhttp://www.django-rest-framework.org/api-guide/validators/#updating-nested-serializers\n\nExample of usage:\n```\n class Child(models.Model):\n field = models.CharField(unique=True)\n\n\nclass Parent(models.Model):\n child = models.ForeignKey('Child')\n\n\nclass ChildSerializer(UniqueFieldsMixin, serializers.ModelSerializer):\n class Meta:\n model = Child\n\n\nclass ParentSerializer(NestedUpdateMixin, serializers.ModelSerializer):\n child = ChildSerializer()\n\n class Meta:\n model = Parent\n```\n\nNote: `UniqueFieldsMixin` must be applied only on the serializer\nwhich has unique fields.\n\nNote: When you are using both mixins\n(`UniqueFieldsMixin` and `NestedCreateMixin` or `NestedUpdateMixin`)\nyou should put `UniqueFieldsMixin` ahead."
properties:
id:
type: integer
readOnly: false
name:
type: string
maxLength: 128
minLength: 1
plural_name:
type:
- string
- 'null'
maxLength: 128
description:
type:
- string
- 'null'
base_unit:
type:
- string
- 'null'
maxLength: 256
open_data_slug:
type:
- string
- 'null'
maxLength: 128
required:
- name
FoodSimple:
type: object
properties:
id:
type: integer
readOnly: false
name:
type: string
maxLength: 128
minLength: 1
plural_name:
type:
- string
- 'null'
maxLength: 128
required:
- name
Ingredient:
type: object
description: Adds nested create feature
properties:
id:
type: integer
readOnly: false
food:
allOf:
- $ref: '#/components/schemas/Food'
unit:
allOf:
- $ref: '#/components/schemas/Unit'
amount:
type: number
format: double
conversions:
type: array
items: {}
readOnly: true
note:
type:
- string
- 'null'
maxLength: 256
order:
type: integer
maximum: 2147483647
minimum: -2147483648
is_header:
type: boolean
no_amount:
type: boolean
original_text:
type:
- string
- 'null'
maxLength: 512
used_in_recipes:
type: array
items: {}
readOnly: true
checked:
type: boolean
readOnly: true
default: false
description: Just laziness to have a checked field on the frontend API client
required:
- amount
- checked
- conversions
- food
- unit
- used_in_recipes
SupermarketCategory:
type: object
description: "Moves `UniqueValidator`'s from the validation stage to the save stage.\nIt solves the problem with nested validation for unique fields on update.\n\nIf you want more details, you can read related issues and articles:\nhttps://github.com/beda-software/drf-writable-nested/issues/1\nhttp://www.django-rest-framework.org/api-guide/validators/#updating-nested-serializers\n\nExample of usage:\n```\n class Child(models.Model):\n field = models.CharField(unique=True)\n\n\nclass Parent(models.Model):\n child = models.ForeignKey('Child')\n\n\nclass ChildSerializer(UniqueFieldsMixin, serializers.ModelSerializer):\n class Meta:\n model = Child\n\n\nclass ParentSerializer(NestedUpdateMixin, serializers.ModelSerializer):\n child = ChildSerializer()\n\n class Meta:\n model = Parent\n```\n\nNote: `UniqueFieldsMixin` must be applied only on the serializer\nwhich has unique fields.\n\nNote: When you are using both mixins\n(`UniqueFieldsMixin` and `NestedCreateMixin` or `NestedUpdateMixin`)\nyou should put `UniqueFieldsMixin` ahead."
properties:
id:
type: integer
readOnly: false
name:
type: string
maxLength: 128
minLength: 1
description:
type:
- string
- 'null'
open_data_slug:
type:
- string
- 'null'
maxLength: 128
required:
- name
Food:
type: object
description: "Moves `UniqueValidator`'s from the validation stage to the save stage.\nIt solves the problem with nested validation for unique fields on update.\n\nIf you want more details, you can read related issues and articles:\nhttps://github.com/beda-software/drf-writable-nested/issues/1\nhttp://www.django-rest-framework.org/api-guide/validators/#updating-nested-serializers\n\nExample of usage:\n```\n class Child(models.Model):\n field = models.CharField(unique=True)\n\n\nclass Parent(models.Model):\n child = models.ForeignKey('Child')\n\n\nclass ChildSerializer(UniqueFieldsMixin, serializers.ModelSerializer):\n class Meta:\n model = Child\n\n\nclass ParentSerializer(NestedUpdateMixin, serializers.ModelSerializer):\n child = ChildSerializer()\n\n class Meta:\n model = Parent\n```\n\nNote: `UniqueFieldsMixin` must be applied only on the serializer\nwhich has unique fields.\n\nNote: When you are using both mixins\n(`UniqueFieldsMixin` and `NestedCreateMixin` or `NestedUpdateMixin`)\nyou should put `UniqueFieldsMixin` ahead."
properties:
id:
type: integer
readOnly: false
name:
type: string
maxLength: 128
minLength: 1
plural_name:
type:
- string
- 'null'
maxLength: 128
description:
type: string
shopping:
type: string
readOnly: true
recipe:
allOf:
- $ref: '#/components/schemas/RecipeSimple'
url:
type:
- string
- 'null'
maxLength: 1024
properties:
type:
- array
- 'null'
items:
$ref: '#/components/schemas/Property'
properties_food_amount:
type: number
format: double
properties_food_unit:
allOf:
- $ref: '#/components/schemas/Unit'
fdc_id:
type:
- integer
- 'null'
maximum: 2147483647
minimum: -2147483648
food_onhand:
type:
- boolean
- 'null'
supermarket_category:
allOf:
- $ref: '#/components/schemas/SupermarketCategory'
parent:
type: integer
readOnly: true
numchild:
type: integer
readOnly: true
inherit_fields:
type:
- array
- 'null'
items:
$ref: '#/components/schemas/FoodInheritField'
full_name:
type: string
description: 'Returns a string representation of a tree node and it''s ancestors,
e.g. ''Cuisine > Asian > Chinese > Catonese''.'
readOnly: true
ignore_shopping:
type: boolean
substitute:
type:
- array
- 'null'
items:
$ref: '#/components/schemas/FoodSimple'
substitute_siblings:
type: boolean
substitute_children:
type: boolean
substitute_onhand:
type: boolean
readOnly: true
child_inherit_fields:
type:
- array
- 'null'
items:
$ref: '#/components/schemas/FoodInheritField'
open_data_slug:
type:
- string
- 'null'
maxLength: 128
shopping_lists:
type: array
items:
$ref: '#/components/schemas/ShoppingList'
required:
- full_name
- name
- numchild
- parent
- shopping
- substitute_onhand
PatchedIngredient:
type: object
description: Adds nested create feature
properties:
id:
type: integer
readOnly: false
food:
allOf:
- $ref: '#/components/schemas/Food'
unit:
allOf:
- $ref: '#/components/schemas/Unit'
amount:
type: number
format: double
conversions:
type: array
items: {}
readOnly: true
note:
type:
- string
- 'null'
maxLength: 256
order:
type: integer
maximum: 2147483647
minimum: -2147483648
is_header:
type: boolean
no_amount:
type: boolean
original_text:
type:
- string
- 'null'
maxLength: 512
used_in_recipes:
type: array
items: {}
readOnly: true
checked:
type: boolean
readOnly: true
default: false
description: Just laziness to have a checked field on the frontend API client
RecipeSimple:
type: object
description: Adds nested create feature
properties:
id:
type: integer
readOnly: false
name:
type: string
maxLength: 128
url:
type: string
readOnly: true
required:
- name
- url
Property:
type: object
description: "Moves `UniqueValidator`'s from the validation stage to the save stage.\nIt solves the problem with nested validation for unique fields on update.\n\nIf you want more details, you can read related issues and articles:\nhttps://github.com/beda-software/drf-writable-nested/issues/1\nhttp://www.django-rest-framework.org/api-guide/validators/#updating-nested-serializers\n\nExample of usage:\n```\n class Child(models.Model):\n field = models.CharField(unique=True)\n\n\nclass Parent(models.Model):\n child = models.ForeignKey('Child')\n\n\nclass ChildSerializer(UniqueFieldsMixin, serializers.ModelSerializer):\n class Meta:\n model = Child\n\n\nclass ParentSerializer(NestedUpdateMixin, serializers.ModelSerializer):\n child = ChildSerializer()\n\n class Meta:\n model = Parent\n```\n\nNote: `UniqueFieldsMixin` must be applied only on the serializer\nwhich has unique fields.\n\nNote: When you are using both mixins\n(`UniqueFieldsMixin` and `NestedCreateMixin` or `NestedUpdateMixin`)\nyou should put `UniqueFieldsMixin` ahead."
properties:
id:
type: integer
readOnly: false
property_amount:
type:
- number
- 'null'
format: double
property_type:
$ref: '#/components/schemas/PropertyType'
required:
- property_amount
- property_type
securitySchemes:
ApiKeyAuth:
type: apiKey
in: header
name: Authorization