{"type":"api","title":"Get Administered Licensing Subscription Subscriptions","meta":{"id":"/apps/pubhub/media/Meraki-Dashboard-API-v1-Documentation/4a73587b50c21afbda73cffb32f23c0279bf8383/5c63a5d4-9452-397a-85eb-8b6fec45147e","info":{"title":"Meraki Dashboard API","description":"A RESTful API to programmatically manage and monitor Cisco Meraki networks at scale.\n\n\u003e Date: 04 December, 2024\n\u003e\n\u003e [Recent Updates](https://meraki.io/whats-new/)\n\n---\n\n[API Documentation](https://meraki.io/api)\n\n[Community Support](https://meraki.io/community)\n\n[Meraki Homepage](https://www.meraki.com)\n","contact":{"name":"Meraki Developer Community","url":"https://meraki.io/community"},"version":"1.53.0"},"security":[{"meraki_api_key":[]},{"bearerAuth":[]}],"tags":[{"name":"organizations"},{"name":"networks"},{"name":"devices"},{"name":"insight"},{"name":"wireless"},{"name":"camera"},{"name":"appliance"},{"name":"switch"},{"name":"cellularGateway"},{"name":"sm"},{"name":"sensor"},{"name":"administered"},{"name":"wirelessController"},{"name":"accessControlLists"},{"name":"accessPolicies"},{"name":"accounts"},{"name":"acls"},{"name":"actionBatches"},{"name":"adaptivePolicy"},{"name":"addresses"},{"name":"admins"},{"name":"airMarshal"},{"name":"alertTypes"},{"name":"alerts"},{"name":"alternateManagementInterface"},{"name":"analytics"},{"name":"api"},{"name":"apiRequests"},{"name":"apnsCert"},{"name":"appliances"},{"name":"applicationCategories"},{"name":"applicationUsage"},{"name":"applications"},{"name":"areas"},{"name":"arpInspection"},{"name":"arpTable"},{"name":"artifacts"},{"name":"assets"},{"name":"assignments"},{"name":"authenticationToken"},{"name":"autoLocate"},{"name":"autoRf"},{"name":"availabilities"},{"name":"bandwidthUsageHistory"},{"name":"bgp"},{"name":"billing"},{"name":"blink"},{"name":"bluetooth"},{"name":"bluetoothClients"},{"name":"bonjourForwarding"},{"name":"boundaries"},{"name":"brandingPolicies"},{"name":"bulk"},{"name":"bulkUpdate"},{"name":"byBoundary"},{"name":"byClient"},{"name":"byDevice"},{"name":"byEnergyUsage"},{"name":"byInterval"},{"name":"byMetric"},{"name":"byModel"},{"name":"byNetwork"},{"name":"byStatus"},{"name":"bySwitch"},{"name":"byType"},{"name":"byUsage"},{"name":"byUtilization"},{"name":"bypassActivationLockAttempts"},{"name":"cableTest"},{"name":"callbacks"},{"name":"categories"},{"name":"cellular"},{"name":"cellularFirewallRules"},{"name":"cellularUsageHistory"},{"name":"certs"},{"name":"changeHistory"},{"name":"channelUtilization"},{"name":"channelUtilizationHistory"},{"name":"channels"},{"name":"claim"},{"name":"claimKey"},{"name":"clientCountHistory"},{"name":"clients"},{"name":"cloudMonitoring"},{"name":"commands"},{"name":"communicationPlans"},{"name":"compliance"},{"name":"configTemplates"},{"name":"configurationChanges"},{"name":"configure"},{"name":"configuredDevices"},{"name":"connectionStats"},{"name":"connections"},{"name":"connectivity"},{"name":"connectivityEvents"},{"name":"connectivityMonitoringDestinations"},{"name":"contentFiltering"},{"name":"coterm"},{"name":"current"},{"name":"customAnalytics"},{"name":"customPerformanceClasses"},{"name":"dataRateHistory"},{"name":"delegated"},{"name":"desktopLogs"},{"name":"details"},{"name":"detections"},{"name":"deviceCommandLogs"},{"name":"deviceProfiles"},{"name":"deviceTypeGroupPolicies"},{"name":"dhcp"},{"name":"dhcpServerPolicy"},{"name":"discovery"},{"name":"dscpTaggingOptions"},{"name":"dscpToCosMappings"},{"name":"eapOverride"},{"name":"earlyAccess"},{"name":"electronicShelfLabel"},{"name":"entitlements"},{"name":"esims"},{"name":"ethernet"},{"name":"eventTypes"},{"name":"events"},{"name":"exportEvents"},{"name":"failedConnections"},{"name":"failover"},{"name":"features"},{"name":"fields"},{"name":"firewall"},{"name":"firewalledServices"},{"name":"firmware"},{"name":"firmwareUpgrades"},{"name":"floorPlans"},{"name":"groupPolicies"},{"name":"groups"},{"name":"health"},{"name":"healthByTime"},{"name":"historical"},{"name":"history"},{"name":"hotspot20"},{"name":"httpServers"},{"name":"identities"},{"name":"identityPsks"},{"name":"idps"},{"name":"imports"},{"name":"inboundCellularFirewallRules"},{"name":"inboundFirewallRules"},{"name":"interfaces"},{"name":"internetPolicies"},{"name":"intrusion"},{"name":"inventory"},{"name":"ipv6"},{"name":"jobs"},{"name":"keys"},{"name":"l2"},{"name":"l3"},{"name":"l3FirewallRules"},{"name":"l7FirewallRules"},{"name":"lan"},{"name":"latencyHistory"},{"name":"latencyStats"},{"name":"latest"},{"name":"leds"},{"name":"licenses"},{"name":"licensing"},{"name":"lines"},{"name":"linkAggregations"},{"name":"linkLayer"},{"name":"live"},{"name":"liveTools"},{"name":"lldpCdp"},{"name":"loginSecurity"},{"name":"logs"},{"name":"lossAndLatencyHistory"},{"name":"malware"},{"name":"managementInterface"},{"name":"manufacturers"},{"name":"me"},{"name":"merakiAuthUsers"},{"name":"meshStatuses"},{"name":"models"},{"name":"monitor"},{"name":"monitoredMediaServers"},{"name":"mqttBrokers"},{"name":"mtu"},{"name":"multicast"},{"name":"netflow"},{"name":"networkAdapters"},{"name":"networkHealth"},{"name":"objectDetectionModels"},{"name":"onboarding"},{"name":"oneToManyNatRules"},{"name":"oneToOneNatRules"},{"name":"openapiSpec"},{"name":"optIns"},{"name":"order"},{"name":"ospf"},{"name":"overview"},{"name":"packetLoss"},{"name":"packets"},{"name":"payloadTemplates"},{"name":"performance"},{"name":"performanceHistory"},{"name":"permissions"},{"name":"pii"},{"name":"piiKeys"},{"name":"ping"},{"name":"pingDevice"},{"name":"policies"},{"name":"policy"},{"name":"policyObjects"},{"name":"portForwardingRules"},{"name":"portSchedules"},{"name":"ports"},{"name":"power"},{"name":"powerModules"},{"name":"prefixes"},{"name":"prepare"},{"name":"priorities"},{"name":"profiles"},{"name":"provisioning"},{"name":"qosRules"},{"name":"qualityAndRetention"},{"name":"qualityRetentionProfiles"},{"name":"radio"},{"name":"ratePlans"},{"name":"readings"},{"name":"recent"},{"name":"redundancy"},{"name":"relationships"},{"name":"rendezvousPoints"},{"name":"requests"},{"name":"responseCodes"},{"name":"restrictions"},{"name":"rfProfiles"},{"name":"roles"},{"name":"rollbacks"},{"name":"routing"},{"name":"rules"},{"name":"saml"},{"name":"samlRoles"},{"name":"schedules"},{"name":"sdwan"},{"name":"search"},{"name":"security"},{"name":"securityCenters"},{"name":"seen"},{"name":"sense"},{"name":"sentry"},{"name":"servers"},{"name":"serviceProviders"},{"name":"settings"},{"name":"signalQualityHistory"},{"name":"sims"},{"name":"singleLan"},{"name":"siteToSiteVpn"},{"name":"smDevicesForKey"},{"name":"smOwnersForKey"},{"name":"snmp"},{"name":"softwares"},{"name":"splash"},{"name":"splashAuthorizationStatus"},{"name":"splashLoginAttempts"},{"name":"ssids"},{"name":"stacks"},{"name":"staged"},{"name":"stages"},{"name":"staticRoutes"},{"name":"statics"},{"name":"stats"},{"name":"status"},{"name":"statuses"},{"name":"stormControl"},{"name":"stp"},{"name":"subnetPool"},{"name":"subnets"},{"name":"subscription"},{"name":"subscriptions"},{"name":"summary"},{"name":"swap"},{"name":"swaps"},{"name":"switches"},{"name":"syslogServers"},{"name":"system"},{"name":"targetGroups"},{"name":"themes"},{"name":"thirdPartyVPNPeers"},{"name":"throughputTest"},{"name":"top"},{"name":"topology"},{"name":"traffic"},{"name":"trafficAnalysis"},{"name":"trafficHistory"},{"name":"trafficShaping"},{"name":"trustedAccessConfigs"},{"name":"trustedServers"},{"name":"upgrades"},{"name":"uplink"},{"name":"uplinkBandwidth"},{"name":"uplinkSelection"},{"name":"uplinks"},{"name":"uplinksLossAndLatency"},{"name":"usage"},{"name":"usageHistories"},{"name":"usageHistory"},{"name":"userAccessDevices"},{"name":"utilization"},{"name":"v4"},{"name":"video"},{"name":"videoLink"},{"name":"vlanAssignments"},{"name":"vlanProfiles"},{"name":"vlans"},{"name":"vmx"},{"name":"vpn"},{"name":"vpnExclusions"},{"name":"vpnFirewallRules"},{"name":"vppAccounts"},{"name":"wakeOnLan"},{"name":"warmSpare"},{"name":"warnings"},{"name":"webhookTests"},{"name":"webhooks"},{"name":"wirelessControllers"},{"name":"wirelessProfiles"},{"name":"wlanLists"},{"name":"zones"}],"x-parser-conf":{"overview":{"markdownPath":"docs/overview.md"},"theme":"meraki","serverConfig":true,"meta":{"useProxy":true},"httpBearer":{"bearerToken":"75dd5334bef4d2bc96f26138c163c0a3fa0b5ca6"},"labelConfig":{"endpoint":{"field":"operationId","format":"startCase"}},"groupBy":{"$remoteModule":"config/group_platform.js"},"sortBy":{"$remoteModule":"config/sort_by.js"},"exampleAsDefault":true,"expand":3,"sampleCode":{"python":{"folder":"meraki/sdk/python","name":"Meraki Python Library","highlight":"python"}},"variables":{"organizationId":"1215707","networkId":"N_784752235069315754","serial":"QBSB-VQ3J-XZ54"}},"openapi":"3.0.1","servers":[{"url":"https://api.meraki.com/{basePath}","variables":{"basePath":{"default":"api/v1"}}}],"securitySchemes":{"meraki_api_key":{"type":"apiKey","name":"X-Cisco-Meraki-API-Key","in":"header"},"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"API Key"}}},"spec":{"description":"List available subscriptions","operationId":"getAdministeredLicensingSubscriptionSubscriptions","parameters":[{"name":"perPage","in":"query","description":"The number of entries per page returned. Acceptable range is 3 - 1000. Default is 1000.","schema":{"type":"integer"}},{"name":"startingAfter","in":"query","description":"A token used by the server to indicate the start of the page. Often this is a timestamp or an ID but it is not limited to those. This parameter should not be defined by client applications. The link for the first, last, prev, or next page in the HTTP Link header should define it.","schema":{"type":"string"}},{"name":"endingBefore","in":"query","description":"A token used by the server to indicate the end of the page. Often this is a timestamp or an ID but it is not limited to those. This parameter should not be defined by client applications. The link for the first, last, prev, or next page in the HTTP Link header should define it.","schema":{"type":"string"}},{"name":"subscriptionIds","in":"query","description":"List of subscription ids to fetch","schema":{"type":"array","items":{"type":"string"}}},{"name":"organizationIds","in":"query","description":"Organizations to get associated subscriptions for","schema":{"type":"array","items":{"type":"string"}}},{"name":"statuses","in":"query","description":"List of statuses that returned subscriptions can have","schema":{"type":"array","items":{"type":"string","enum":["active","canceled","expired","inactive","out_of_compliance"]}}},{"name":"productTypes","in":"query","description":"List of product types that returned subscriptions need to have entitlements for.","schema":{"type":"array","items":{"type":"string","enum":["appliance","camera","cellularGateway","secureConnect","sensor","switch","systemsManager","wireless","wirelessController"]}}},{"name":"name","in":"query","description":"Search for subscription name","schema":{"type":"string"}},{"name":"startDate","in":"query","description":"Filter subscriptions by start date, ISO 8601 format. To filter with a range of dates, use 'startDate[\u003coption\u003e]=?' in the request. Accepted options include lt, gt, lte, gte.","schema":{"oneOf":[{"type":"object","properties":{"lt":{"type":"string","format":"date-time","description":"comparative operator used to filter for all values less than the given value"},"gt":{"type":"string","format":"date-time","description":"comparative operator used to filter for all values greater than the given value"},"lte":{"type":"string","format":"date-time","description":"comparative operator used to filter for all values less than or equal to the given value"},"gte":{"type":"string","format":"date-time","description":"comparative operator used to filter for all values greater than or equal to the given value"},"neq":{"type":"string","format":"date-time","description":"comparative operator used to filter for all values not equal to the given value"}}},{"type":"string","format":"date-time"}]}},{"name":"endDate","in":"query","description":"Filter subscriptions by end date, ISO 8601 format. To filter with a range of dates, use 'endDate[\u003coption\u003e]=?' in the request. Accepted options include lt, gt, lte, gte.","schema":{"oneOf":[{"type":"object","properties":{"lt":{"type":"string","format":"date-time","description":"comparative operator used to filter for all values less than the given value"},"gt":{"type":"string","format":"date-time","description":"comparative operator used to filter for all values greater than the given value"},"lte":{"type":"string","format":"date-time","description":"comparative operator used to filter for all values less than or equal to the given value"},"gte":{"type":"string","format":"date-time","description":"comparative operator used to filter for all values greater than or equal to the given value"},"neq":{"type":"string","format":"date-time","description":"comparative operator used to filter for all values not equal to the given value"}}},{"type":"string","format":"date-time"}]}}],"responses":{"200":{"description":"Successful operation","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"subscriptionId":{"type":"string","description":"Subscription's ID"},"name":{"type":"string","description":"Subscription name"},"description":{"type":"string","description":"Subscription description"},"status":{"type":"string","enum":["active","canceled","expired","inactive","out_of_compliance"],"description":"Subscription status"},"startDate":{"type":"string","format":"date-time","description":"Subscription start date"},"endDate":{"type":"string","format":"date-time","description":"Subscription expiration date"},"lastUpdatedAt":{"type":"string","format":"date-time","description":"When the subscription was last changed"},"webOrderId":{"type":"string","description":"Web order id"},"type":{"type":"string","enum":["enterpriseAgreement","termed"],"description":"Subscription type"},"smartAccount":{"type":"object","properties":{"status":{"type":"string","description":"Subscription Smart Account status"},"account":{"type":"object","properties":{"id":{"type":"string","description":"Smart Account ID"},"name":{"type":"string","description":"The name of the smart account"},"domain":{"type":"string","description":"The domain of the Smart Account"}},"description":"Smart Account data"}},"description":"Smart Account linkage information"},"renewalRequested":{"type":"boolean","description":"Whether a renewal has been requested for the subscription"},"productTypes":{"type":"array","items":{"type":"string","enum":["appliance","camera","cellularGateway","sensor","switch","systemsManager","wireless"]},"description":"Products the subscription has entitlements for"},"entitlements":{"type":"array","items":{"type":"object","properties":{"sku":{"type":"string","description":"SKU of the required product"},"webOrderLineId":{"type":"string","description":"Web order line ID"},"seats":{"type":"object","properties":{"assigned":{"type":"integer","description":"Number of seats in use"},"available":{"type":"integer","description":"Number of seats available for use"},"limit":{"type":"integer","description":"Total number of seats provided by this subscription for this sku"}},"description":"Seat distribution"}}},"description":"Entitlement info"},"counts":{"type":"object","properties":{"seats":{"type":"object","properties":{"assigned":{"type":"integer","description":"Number of seats in use"},"available":{"type":"integer","description":"Number of seats available for use"},"limit":{"type":"integer","description":"Total number of seats provided by this subscription"}},"description":"Seat distribution"},"networks":{"type":"integer","description":"Number of networks bound to this subscription"},"organizations":{"type":"integer","description":"Number of organizations bound to this subscription"}},"description":"Numeric breakdown of network, organizations, entitlement counts"},"enterpriseAgreement":{"type":"object","properties":{"suites":{"type":"array","items":{"type":"string","enum":["cameraSystems","ciscoNetworkingWireless","networking","systemsManager"]},"description":"List of suites included. Empty for non-EA subscriptions."}},"description":"enterprise agreement details"}}}},"example":[{"subscriptionId":"2345","name":"Corporate subscription","description":"A description","status":"active","startDate":"2027-06-30T00:00:00Z","endDate":"2028-06-30T00:00:00Z","lastUpdatedAt":"2027-09-21T00:00:00Z","webOrderId":"55598764","type":"termed","smartAccount":{"status":"active","account":{"id":"99995678","name":"Corporate Smart Account","domain":"smart_account_domain"}},"renewalRequested":false,"productTypes":["wireless"],"entitlements":[{"sku":"LIC-MS-400-L-A","webOrderLineId":"55551234","seats":{"assigned":10,"available":15,"limit":25}}],"counts":{"seats":{"assigned":10,"available":15,"limit":25},"networks":1,"organizations":1},"enterpriseAgreement":{"suites":["networking"]}}]}},"headers":{"Link":{"schema":{"type":"string"},"description":"A comma-separated list of first, last, prev, and next relative links used for subsequent paginated requests."}}}},"summary":"List available subscriptions","tags":["licensing","configure","subscription","subscriptions"],"__originalOperationId":"getAdministeredLicensingSubscriptionSubscriptions","security":[{"meraki_api_key":[]},{"bearerAuth":[]}],"method":"get","path":"/administered/licensing/subscription/subscriptions","sampleCode":{"Meraki Python Library":{"code":"import meraki\n\n# Defining your API key as a variable in source code is discouraged.\n# This API key is for a read-only docs-specific environment.\n# In your own code, use an environment variable as shown under the Usage section\n# @ https://github.com/meraki/dashboard-api-python/\n\nAPI_KEY = '75dd5334bef4d2bc96f26138c163c0a3fa0b5ca6'\n\ndashboard = meraki.DashboardAPI(API_KEY)\n\n\nresponse = dashboard.licensing.getAdministeredLicensingSubscriptionSubscriptions()\n\nprint(response)","highlight":"python"}}}}