A typical bulk get API endpoint includes an ids input argument, which is an array of identifiers. By default, the Lana API returns items in the same order as their identifiers in the ids argument. If at least one item is not found, the API call will return a not found error. However, you can override this behavior by setting the loose input argument to true
. When loose is set to true
, the Lana API might return fewer items than requested, and in no particular order.
Additional Considerations
-
Prior to performing a request, the Lana API endpoint de-duplicates ids arguments and returns objects as if there were no duplicates. As a best practice, you should avoid such scenarios by de-duplicating ids on your end.
-
Some bulk get API endpoints can be invoked without using the ids argument. In this case, the API returns all objects. This is generally applicable to collections with strict maximum count restrictions, making it suitable to return all items at once, if requested.