Get Custom Ingredient Usage
List the organization's recipes that pin this custom ingredient. Backed by an eventually-consistent, near-real-time reverse index.
version_id is applied as a DynamoDB filter after the page is read, so a filtered page can return fewer than limit items — possibly zero — even when more matches exist further in. An empty page with meta.has_more: true is not an empty result set: keep paging with meta.cursor until meta.has_more is false. Unfiltered pages are unaffected.
Path Parameters
Custom ingredient ID
Query Parameters
Maximum number of recipes to return (1-100).
201 <= value <= 100Opaque pagination cursor returned in meta.cursor from a previous response. Omit on the first page.
Narrow to recipes pinned at exactly this custom-ingredient version. Omit to return recipes pinning any version. Applied as a DynamoDB filter after the page is read, so a filtered page can be short or empty while more matches exist further in.
Response Body
application/json
application/json
application/json
curl -X GET "https://api.bettermenu.live/studio/custom-ingredients/string/usage"{
"data": [
{
"recipe_id": "string",
"recipe_name": "string",
"recipe_status": "string",
"source": "standard",
"pinned_version_id": "string"
}
],
"meta": {
"version": "string",
"request_id": "string",
"timestamp": "string",
"cursor": "string",
"has_more": true
}
}{
"type": "https://api.bettermenu.live/errors/recipe_not_found",
"title": "Recipe Not Found",
"status": 400,
"detail": "Recipe rcpe_abc123 does not exist",
"code": "recipe_not_found",
"retryable": true,
"instance": "/api/v1/recipes/rcpe_abc123",
"trace_id": "req_xyz789",
"errors": [
{}
],
"invalid_ids": [
"f_abc123",
"f_xyz789"
]
}{
"detail": [
{
"loc": [
"string"
],
"msg": "string",
"type": "string",
"input": null,
"ctx": {}
}
]
}