Atom feed of this document

 3.4.2. Get Version Details

Verb URI Description
GET For a US-based account, retrieve details about a specific Cloud Auth version.
GET For a UK-based account, retrieve details about a specific Cloud Auth version.

Normal Response Code(s): 200, 203

Error Response Code(s): badRequest (400), authFault (500), serviceUnavailable (503)

You can obtain additional information about a specific version by performing a GET on the base version URL; is an example of a base version URL for a US-based account. Version request URLs should always end with a trailing slash (/). If the slash is omitted, the server may respond with a 302 redirection request.

Format extensions may be placed after the base version URL's trailing slash: for example, in, .xml is a format extension.

This operation does not require a request body.


Example 3.7. API Version Details Response: XML

<?xml version="1.0" encoding="UTF-8"?>

<version  xmlns=""
          wadl="" />



Example 3.8. API Version Details Response: JSON

  "version" {
      "id" : "v1.1",
      "status" : "BETA",
      "docURL" : ""
      "wadl"   : ""


The detailed version response contains a pointer to both a human-readable and a machine-processable description of the API service. The machine-processable description is written in the Web Application Description Language (WADL).


If a discrepancy exists between the two specifications, the WADL is authoritative as it contains the most accurate and current description of the API service.