GET {apiVersion}/Ping

Get the current version number of the API and verify which specific Advisors Assistant database is being connected to on behalf of the authorized user. Also get information about the authorized user including IDs that can be used to access the user's calendar, etc.

Request Information

URI Parameters

Name	Description	Type	Additional information
apiVersion	Required routing parameter defining which version of the API to call. Currently use "v1" for all API requests.	string	None.

Body Parameters

None.

Response Information

Resource Description

Ping

Name	Description	Type	Additional information
APIVersion	Current version number of the API.	string	None.
SQLServerName	Instance of SQL Server that is hosting the database.	string	None.
SQLDatabaseName	Name of the SQL Server database.	string	None.
Scopes	List of Scopes for the authorized user.	Collection of string	None.
_links	Links to other API resources that are related to the information in this model. This is part of the HAL specification. This property is not required on PUT or POST requests to this endpoint.		None.
_embedded	Resources/models representing data that is related to the data in this model. This is part of the HAL specification. These models have their own HAL links and embedded resources. This property is not required on PUT or POST requests to this endpoint.		None.

Embedded Resources

The HAL standard calls for complex properties (properties who have their own HAL markup) be represented in a base model's "_embedded" tag rather than as properties or collections on the underlying model. The model described above can also include the following types of related models in it's _embedded property.

Model	Description
UserDetailed	The UserDetailed model represents detailed information about a user of an Advisors Assistant database application (desktop app or web app).

Response Formats

application/hal+json

Sample:

{
  "APIVersion": "sample string 1",
  "SQLServerName": "sample string 2",
  "SQLDatabaseName": "sample string 3",
  "Scopes": [
    "sample string 1",
    "sample string 2"
  ],
  "_links": {
    "sample string 1": {
      "href": "sample string 2",
      "title": "sample string 3",
      "type": "sample string 4",
      "deprecation": "sample string 5",
      "name": "sample string 6",
      "profile": "sample string 7",
      "hreflang": "sample string 8"
    },
    "self": {
      "href": "/v1/Ping",
      "title": "Ping"
    },
    "user": {
      "href": "/v1/Users/Detailed/e11a0877-23c0-4304-993b-c70356c12307",
      "title": "sample string 4"
    }
  },
  "_embedded": {
    "user": {
      "WhenChangedDateTime": "2025-01-17T21:14:26-08:00",
      "WhoChanged": "sample string 1",
      "WhenAddedDateTime": "2025-01-17T21:14:26-08:00",
      "WhoAdded": "sample string 2",
      "DefaultProducerID": "07fcf096-bcfd-456d-a31c-b0c465a1cf95",
      "NameID": "1b3e81c0-1537-429a-ae1a-6692509bacf5",
      "DefaultCalendarID": "2c0d85c5-3b43-4564-ba9a-56a448d1d5b0",
      "CalendarsExplicitlyAccessible": [
        {
          "ID": "e9db9a70-4791-4efe-890e-5f4be77422bc",
          "Description": "sample string 1"
        },
        {
          "ID": "e9db9a70-4791-4efe-890e-5f4be77422bc",
          "Description": "sample string 1"
        }
      ],
      "HasViewAllCalendarsPermission": true,
      "HasSystemAdministratorRole": true,
      "ID": "e11a0877-23c0-4304-993b-c70356c12307",
      "Initials": "sample string 3",
      "DisplayName": "sample string 4",
      "EmailAddress": "sample string 5",
      "_links": {
        "sample string 1": {
          "href": "sample string 2",
          "title": "sample string 3",
          "type": "sample string 4",
          "deprecation": "sample string 5",
          "name": "sample string 6",
          "profile": "sample string 7",
          "hreflang": "sample string 8"
        },
        "self": {
          "href": "/v1/Users/Detailed/e11a0877-23c0-4304-993b-c70356c12307",
          "title": "sample string 4"
        }
      },
      "_embedded": null
    }
  }
}