Demo

Use this demonstration to build a Service List Registry service discovery query with various optional parameters. Send the request to view the resulting response with a list of matching service providers and offerings. Select a provider to view details of the service provider. Select a service list offering to get a list of available services from that provider.

Request

Parameters

Only nationally regulated services

Response

Detail

Services

 
Select a service list offering in the List tab and click Get Services to view service list.

Notes

Demo
The parameter values and responses returned and any visual representations are for demonstration purposes only and do not imply the participation, registration or availability of specific services.
URL
The URL or Uniform Resource Locator is used to request a response to the Service List Registry query.
Protocol
The HTTPS secure protocol must be used for all queries to provide privacy and security by automatically encrypting every request and response over a secure connection.
Method
The GET HTTP method requests a representation of the specified resource. Requests using GET should only be used to request data and should not contain a body.
Parameters
Multiple parameters may be provided in a query, presented in the specified order. Where a parameter is not included in the query, the response will include results matching any or no value for that parameter.
Values
Multiple values may be provided for a parameter, presented in alphabetic order. The parameter key is repeated followed by square brackets encoded as %5B%5D. The response will combine matches to any of the values provided and will also include results with no specified value for that parameter.
Case
All query parameters and values are case sensitive and will be compared accordingly by the server. The capitalisation used here is defined by specification and alternative forms are invalid.
Response
The response is returned in xml format. This is transformed using xsl for more convenient viewing in a List or as a formatted Body. The relevant Headers can be viewed in a separate tab. The raw response body can also be viewed in a new browser window.
Status
The status of the response will be indicated by an HTTP response status code returned in the header.
200 OK
Returned for a successful request. The response body contains a list of zero or more services that match the supplied query parameters. These are returned in alphabetical order. If no services match the query parameters, an empty list is returned.
400 Bad Request
Returned if the request parameters are invalid or inconsistent. This may be because an invalid value was provided for a query parameter, or because a query parameter is not supported.
Timing
The time taken to process the request is indicated in milliseconds. This depends on many factors including client location and network conditions but it is typically less than a second. Previous responses cached by the browser may be displayed almost immediately.
Size
The size of the response body is shown as a character count. This reflects how much data the client receives and processes, even if the response is compressed or cached.
Detail
Selecting an item in the List tab will display further information about the service provider or service list offering in the Detail pane. This includes contact details for the Registry. For a service provider it presents contact details and a list of available service list offerings. For a service list offering it presents further information about the offering a link to retrieve the full service list from the provider.