api: clarify query condition