title: REST: How to return back the next action url in response body?
body: <p>We have created an API to get user details. To get any particular user details, one needs to enter a verified number. </p>
  
  <p>The API looks like:</p>
  
  <pre><code>GET /api/details/?number=983984348&amp;userid=123
  </code></pre>
  
  <p>Here userid is the id of the user who's detail we need and the number is mobile-number of person who wants to get those details. If the number is verified, we get back details of <code>user 123</code>. If the number is not verified, we send back status as Not Verified.</p>
  
  <p>If the client gets not verified status back, the client needs to hit verification API. The API looks like:</p>
  
  <pre><code>/api/verify/?number=983984348
  </code></pre>
  
  <p>Once this API is hit, client gets URL that needs to be hit to verify.</p>
  
  <p>Currently, we have hard-coded this API url <code>/api/verify/?number=983984348</code> at each client BUT as per <code>HATEOAS</code> it's incorrect as it recommends it should be guided by server.</p>
  
  <p>I have no clue how should this API url be sent from client to server i.e using simple response body OR in response headers? Can someone explain me how such navigation should be guided from the server to the client?</p>