queryType: getDatabaseInfo

The getDatabaseInfo queryType is passed to the API to get a list of counties to which the logged in database has access, as well as their licensing information.

Parameters

These parameters should be passed to the functionParameters object regardless of which method you choose to make an API request.

ParameterDescriptionTypeDefined Value SetValue Req'd
queryTypeMust equal getDatabaseInfo.STRINGgetDatabaseInfoY

Responses

CodeTypeDescription
200JSONThe requested data.
401JSONOccurs for various unauthorized tasks, such as not providing credentials in your parameters.
500JSONOccurs if an internal server error occurs. Contact Altitude Support if this occurs.

Response Schema

AttributeDescriptionData TypeDefined Value Set
ApplicationsArray of strings holding the names of all purchased applications.ARRAY"Traffic - Roads", "Origin/ Destination", "Route Analytics", "User Management", "Altitude Portal", "Custom Zones", "Stop Analytics", "Regional Travel Metrics"
CommentsComments about the database.STRING-
Counties

Array of objects representing counties purchased. Each object contains:

  • ISO_3166_2 (string) - unique ISO 3166:2 identifier representing the state/provincial code of the purchased region.

  • CountyId (string): a unique identifier for a county; typically, the FIPS code or Canadian census subdivision CSDUID from StatCan.

  • County (string): name of the county.

ARRAY-
CreatedTimestampTimestamp for when the database was created.TIMESTAMP-
DatabaseName of the database.STRING-
DataDateRanges

Array of objects representing purchased data date ranges. Each object contains:

  • StartDate (date): the start of the date range.

  • EndDate (date): the end of the date range.

ARRAY-
DomainsAllowedArray of strings representing the email domains allowed for users of this database.ARRAY-
ExpiryDateDate when the license expires and the user loses access to the database.DATE-
IsTrialIndicates whether the database is a trial (true) or not (false).BOOLEAN-
LicenseIdType of license.INTEGER1 - Project, 2 - Subscription, 3 - Reseller
MaxSavedAnalysesPerModuleThe maximum number of saved past analyses per module/applicationINTEGER
MaxUserCountThe maximum number of users that can be loaded on this database.INTEGER-
ModifiedTimestampTimestamp for when the database was last modified.TIMESTAMP-

Sample parameters

{"queryType": "getDatabaseInfo"}