Get needs templates by product

This endpoint returns the needs templates that have been applied to a product or section within a period not exceeding 31 days.

GET /api/v1/businesses/{businessId}/products/{productId}/needs-templates?fromDate={yyyy-MM-dd}&toDate={yyyy-MM-dd}

If the data included in the URL is correct, the response will contain the needs templates applied to the product or section for each of the days specified in the request interval.

Response example

[
    {
        "productId": "0001-GENERAL",
        "date": "2026/08/31",
        "id": "17537",
        "templateName": "Summer"
    },
    {
        "productId": "0001-GENERAL",
        "date": "2026/09/01",
        "id": "17536",
        "templateName": "General"
    }
]
Details

  • productId: external identifier of the product or section.

  • date: the date to which the needs template applies, in yyyy/MM/dd format.

  • id: internal identifier of the template in Orquest.

  • templateName: name configured in the system for the template.

As shown in the example, the request returns the needs template information applied on each day of the query interval.

Considerations

If the product specified in the URL does not exist in the business, the request will return a 404 Not Found error, specifying in the message not exists.

If the time interval specified in the URL exceeds 31 days, the request will return a 400 Bad Request error, specifying in the message Invalid days period.

If there are no needs templates applied for the specified time period, the request will return a 404 Not Found error, specifying in the message There is not needs template on the requested information.

Useful links

What are needs?

What are needs templates?