Just like the docs say, you can use that endpoint, with either the user_id or user_login querystring param, to get the details of a stream.
If the channel is live you’ll get a stream object in the results, if the channels is offline you’ll get an empty data array.