{"type":"api","title":"Claim Organization Subscription","meta":{"id":"/apps/pubhub/media/Meraki-Dashboard-API-v1-Documentation/d215661e9c649929fa473c7bf2fd0bcd71de89e6/906c5292-7ca5-3d85-bb6d-da1ee73c8be6","info":{"title":"Meraki Dashboard API","description":"A RESTful API to programmatically manage and monitor Cisco Meraki networks at scale.\n\n\u003e Date: 04 November, 2026\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.76.0-beta.0"},"security":[{"meraki_api_key":[]},{"bearerAuth":[]},{"oauth2":[]}],"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":"campusGateway"},{"name":"users"},{"name":"wirelessController"},{"name":"spaces"},{"name":"support"},{"name":"assistant"},{"name":"accelerometer"},{"name":"accept"},{"name":"accessControlLists"},{"name":"accessGroups"},{"name":"accessPolicies"},{"name":"account"},{"name":"accounts"},{"name":"aclHitCount"},{"name":"acls"},{"name":"actionBatches"},{"name":"activities"},{"name":"adaptivePolicy"},{"name":"adaptivePolicyGroups"},{"name":"addressFamilies"},{"name":"addresses"},{"name":"administrators"},{"name":"admins"},{"name":"afc"},{"name":"aggregated"},{"name":"airMarshal"},{"name":"alertTypes"},{"name":"alerts"},{"name":"allowlist"},{"name":"alternateManagementInterface"},{"name":"alternateManagementInterfaces"},{"name":"analytics"},{"name":"antennas"},{"name":"api"},{"name":"apiRequests"},{"name":"apnsCert"},{"name":"apple"},{"name":"appliances"},{"name":"application"},{"name":"applicationCategories"},{"name":"applicationUsage"},{"name":"applications"},{"name":"areas"},{"name":"arpInspection"},{"name":"arpTable"},{"name":"artifacts"},{"name":"assetTracking"},{"name":"assets"},{"name":"assignments"},{"name":"association"},{"name":"attributes"},{"name":"auth"},{"name":"authZones"},{"name":"authentication"},{"name":"authenticationToken"},{"name":"authorities"},{"name":"authorization"},{"name":"authorizations"},{"name":"autoLocate"},{"name":"autoRf"},{"name":"automate"},{"name":"automations"},{"name":"autonomousSystems"},{"name":"autovpn"},{"name":"availabilities"},{"name":"azure"},{"name":"bands"},{"name":"bandwidthUsageHistory"},{"name":"batch"},{"name":"batchCreate"},{"name":"batches"},{"name":"bgp"},{"name":"bgpSessionStatus"},{"name":"billing"},{"name":"blink"},{"name":"bluetooth"},{"name":"bluetoothClients"},{"name":"bonjourForwarding"},{"name":"boots"},{"name":"boundaries"},{"name":"brandingPolicies"},{"name":"buildings"},{"name":"bulk"},{"name":"bulkAdd"},{"name":"bulkClaims"},{"name":"bulkCreate"},{"name":"bulkDelete"},{"name":"bulkEdit"},{"name":"bulkEnrollment"},{"name":"bulkRemove"},{"name":"bulkUpdate"},{"name":"bulkUpload"},{"name":"byAdmin"},{"name":"byApplication"},{"name":"byAutonomousSystem"},{"name":"byBand"},{"name":"byBoundary"},{"name":"byClient"},{"name":"byClientOs"},{"name":"byClientType"},{"name":"byCluster"},{"name":"byDevice"},{"name":"byEnergyUsage"},{"name":"byFilterList"},{"name":"byGroup"},{"name":"byInterval"},{"name":"byMetric"},{"name":"byModel"},{"name":"byNetwork"},{"name":"byNewDevice"},{"name":"byOperation"},{"name":"byPeerGroup"},{"name":"byPipeline"},{"name":"byPort"},{"name":"byPrefixList"},{"name":"byProfile"},{"name":"byRouter"},{"name":"byServer"},{"name":"byServerType"},{"name":"bySite"},{"name":"bySourceIp"},{"name":"bySsid"},{"name":"byStack"},{"name":"byStatus"},{"name":"bySwitch"},{"name":"bySwitchProfile"},{"name":"byTunnel"},{"name":"byType"},{"name":"byUsage"},{"name":"byUtilization"},{"name":"byVlan"},{"name":"byVrf"},{"name":"bypassActivationLockAttempts"},{"name":"cableTest"},{"name":"callbacks"},{"name":"candidates"},{"name":"capabilities"},{"name":"captures"},{"name":"categories"},{"name":"cellular"},{"name":"cellularFirewallRules"},{"name":"cellularUsageHistory"},{"name":"certificateAuthority"},{"name":"certificates"},{"name":"certs"},{"name":"changeHistory"},{"name":"changelogs"},{"name":"channelAvailability"},{"name":"channelUtilization"},{"name":"channelUtilizationHistory"},{"name":"channels"},{"name":"chat"},{"name":"checkup"},{"name":"claim"},{"name":"claimKey"},{"name":"clientCountHistory"},{"name":"clientExclusion"},{"name":"clients"},{"name":"cloud"},{"name":"cloudEnrollment"},{"name":"clusters"},{"name":"commands"},{"name":"communicationPlans"},{"name":"completions"},{"name":"compliance"},{"name":"compute"},{"name":"config"},{"name":"configTemplates"},{"name":"configurationChanges"},{"name":"configurations"},{"name":"configure"},{"name":"configuredDevices"},{"name":"connectedCountHistory"},{"name":"connectionStats"},{"name":"connections"},{"name":"connectivity"},{"name":"connectivityEvents"},{"name":"connectivityMonitoringDestinations"},{"name":"connectors"},{"name":"contentFiltering"},{"name":"contents"},{"name":"controller"},{"name":"correlated"},{"name":"coterm"},{"name":"coverage"},{"name":"cpu"},{"name":"credentials"},{"name":"crls"},{"name":"current"},{"name":"custom"},{"name":"customAnalytics"},{"name":"customPerformanceClasses"},{"name":"cycle"},{"name":"dailyConsumerMetrics"},{"name":"data"},{"name":"dataRate"},{"name":"dataRateHistory"},{"name":"defaultContent"},{"name":"delegated"},{"name":"deltas"},{"name":"deploy"},{"name":"deployable"},{"name":"deployed"},{"name":"deployments"},{"name":"descriptors"},{"name":"desktopLogs"},{"name":"details"},{"name":"detections"},{"name":"deviceCategories"},{"name":"deviceCommandLogs"},{"name":"deviceProfiles"},{"name":"deviceTypeGroupPolicies"},{"name":"dhcp"},{"name":"dhcpLeases"},{"name":"dhcpServerPolicy"},{"name":"dictionaries"},{"name":"disconnect"},{"name":"discover"},{"name":"discovered"},{"name":"discovery"},{"name":"disenrollments"},{"name":"dns"},{"name":"domains"},{"name":"doorLocks"},{"name":"download"},{"name":"downloadUrl"},{"name":"dscpTaggingOptions"},{"name":"dscpToCosMappings"},{"name":"eapOverride"},{"name":"earlyAccess"},{"name":"electronicShelfLabel"},{"name":"eligible"},{"name":"enrollable"},{"name":"enrollments"},{"name":"entitlements"},{"name":"entries"},{"name":"eox"},{"name":"errors"},{"name":"esims"},{"name":"ethernet"},{"name":"eventLogs"},{"name":"eventTypes"},{"name":"events"},{"name":"exclusions"},{"name":"experience"},{"name":"extensions"},{"name":"external"},{"name":"facets"},{"name":"failedConnections"},{"name":"failover"},{"name":"failures"},{"name":"featureTiers"},{"name":"features"},{"name":"feedback"},{"name":"fetchTableQuery"},{"name":"fields"},{"name":"file"},{"name":"filterLists"},{"name":"filters"},{"name":"firewall"},{"name":"firewalledServices"},{"name":"firmware"},{"name":"firmwareUpgrades"},{"name":"floorPlans"},{"name":"gateways"},{"name":"gcp"},{"name":"geolocations"},{"name":"global"},{"name":"group"},{"name":"groupPolicies"},{"name":"groups"},{"name":"health"},{"name":"healthByTime"},{"name":"healthScores"},{"name":"histogram"},{"name":"historical"},{"name":"history"},{"name":"hosts"},{"name":"hotspot20"},{"name":"httpServers"},{"name":"httpsInspection"},{"name":"httpsi"},{"name":"hubBudget"},{"name":"hubs"},{"name":"iam"},{"name":"identities"},{"name":"identity"},{"name":"identityPsks"},{"name":"idps"},{"name":"impacted"},{"name":"impactedDevice"},{"name":"import"},{"name":"inboundCellularFirewallRules"},{"name":"inboundFirewallRules"},{"name":"insights"},{"name":"integrate"},{"name":"integration"},{"name":"integrations"},{"name":"intents"},{"name":"interconnects"},{"name":"interfaces"},{"name":"internetPolicies"},{"name":"intrusion"},{"name":"inventory"},{"name":"iot"},{"name":"ipAssignment"},{"name":"ipsec"},{"name":"ipv6"},{"name":"isolation"},{"name":"jobs"},{"name":"json"},{"name":"keys"},{"name":"l2"},{"name":"l3"},{"name":"l3FirewallRules"},{"name":"l7FirewallRules"},{"name":"lan"},{"name":"lanLink"},{"name":"lanStp"},{"name":"latency"},{"name":"latencyHistory"},{"name":"latencyStats"},{"name":"latest"},{"name":"leds"},{"name":"license"},{"name":"licenses"},{"name":"licensing"},{"name":"lines"},{"name":"linkAggregations"},{"name":"linkLayer"},{"name":"links"},{"name":"listenRanges"},{"name":"live"},{"name":"liveTools"},{"name":"lldpCdp"},{"name":"load"},{"name":"local"},{"name":"localOverrides"},{"name":"location"},{"name":"locationScanning"},{"name":"loginSecurity"},{"name":"logins"},{"name":"logs"},{"name":"lookups"},{"name":"lossAndLatencyHistory"},{"name":"lowPower"},{"name":"macTable"},{"name":"malware"},{"name":"managementInterface"},{"name":"manufacturers"},{"name":"masks"},{"name":"mcf"},{"name":"mdns"},{"name":"me"},{"name":"measurements"},{"name":"memory"},{"name":"merakiAuth"},{"name":"merakiAuthUsers"},{"name":"mesh"},{"name":"meshStatuses"},{"name":"messages"},{"name":"metrics"},{"name":"migrations"},{"name":"mirror"},{"name":"mirrors"},{"name":"mode"},{"name":"models"},{"name":"monitor"},{"name":"monitoredMediaServers"},{"name":"mostImpactedClientNetworks"},{"name":"mostImpactedNetworks"},{"name":"mostImpactedXMs"},{"name":"moves"},{"name":"mqtt"},{"name":"mqttBrokers"},{"name":"mtu"},{"name":"multicast"},{"name":"multicastForwarding"},{"name":"multicastRouting"},{"name":"nac"},{"name":"nat"},{"name":"neighbors"},{"name":"netflow"},{"name":"networkAdapters"},{"name":"networkHealth"},{"name":"networkServices"},{"name":"new"},{"name":"nodes"},{"name":"objectDetectionModels"},{"name":"offboard"},{"name":"onboard"},{"name":"onboarding"},{"name":"onboardingHistory"},{"name":"oneToManyNatRules"},{"name":"oneToOneNatRules"},{"name":"openRoaming"},{"name":"openapiSpec"},{"name":"opportunistic"},{"name":"opportunisticPcap"},{"name":"optIns"},{"name":"optimization"},{"name":"order"},{"name":"orders"},{"name":"ospf"},{"name":"ospfNeighbors"},{"name":"override"},{"name":"overrides"},{"name":"overview"},{"name":"overviews"},{"name":"owe"},{"name":"package"},{"name":"packetCapture"},{"name":"packetCaptures"},{"name":"packetLoss"},{"name":"packets"},{"name":"payloadTemplates"},{"name":"peers"},{"name":"performance"},{"name":"performanceHistory"},{"name":"permissions"},{"name":"pii"},{"name":"piiKeys"},{"name":"ping"},{"name":"pingDevice"},{"name":"pipelines"},{"name":"placement"},{"name":"planning"},{"name":"poe"},{"name":"policies"},{"name":"policy"},{"name":"policyObjects"},{"name":"portForwardingRules"},{"name":"portSchedules"},{"name":"ports"},{"name":"position"},{"name":"positions"},{"name":"power"},{"name":"powerLimits"},{"name":"powerModules"},{"name":"preferred"},{"name":"prefixLists"},{"name":"prefixes"},{"name":"priorities"},{"name":"privateApplicationGroups"},{"name":"privateApplications"},{"name":"privateResourceGroups"},{"name":"privateResources"},{"name":"productAnnouncements"},{"name":"productIntegrations"},{"name":"profiles"},{"name":"provisioning"},{"name":"publicApplications"},{"name":"push"},{"name":"qosRules"},{"name":"qualityAndRetention"},{"name":"qualityRetentionProfiles"},{"name":"queues"},{"name":"raGuardPolicy"},{"name":"radio"},{"name":"radius"},{"name":"radsec"},{"name":"ranging"},{"name":"ratePlans"},{"name":"rca"},{"name":"readings"},{"name":"reboot"},{"name":"receivers"},{"name":"recent"},{"name":"recommendations"},{"name":"records"},{"name":"redundancy"},{"name":"regions"},{"name":"regulatoryDomain"},{"name":"relationships"},{"name":"remoteAccess"},{"name":"remoteAccessLog"},{"name":"remoteAccessLogsExports"},{"name":"removedResources"},{"name":"rendezvousPoints"},{"name":"requests"},{"name":"requirements"},{"name":"responseCodes"},{"name":"rest"},{"name":"restrictions"},{"name":"retries"},{"name":"revocationLists"},{"name":"rfHealth"},{"name":"rfProfiles"},{"name":"roaming"},{"name":"roles"},{"name":"rollbacks"},{"name":"route"},{"name":"routers"},{"name":"routing"},{"name":"routingTable"},{"name":"rrm"},{"name":"rssi"},{"name":"ruleGroups"},{"name":"rules"},{"name":"rulesets"},{"name":"salesRepresentatives"},{"name":"saml"},{"name":"samlRoles"},{"name":"sase"},{"name":"scanning"},{"name":"schedules"},{"name":"scores"},{"name":"sdwan"},{"name":"sdwanmanager"},{"name":"search"},{"name":"secureClient"},{"name":"secureConnect"},{"name":"security"},{"name":"securityCenters"},{"name":"seen"},{"name":"sense"},{"name":"sentry"},{"name":"serverHealth"},{"name":"servers"},{"name":"serviceProviders"},{"name":"services"},{"name":"sessions"},{"name":"settings"},{"name":"signalQuality"},{"name":"signalQualityHistory"},{"name":"sims"},{"name":"singleLan"},{"name":"siteToSite"},{"name":"siteToSiteVpn"},{"name":"sites"},{"name":"slas"},{"name":"smDevicesForKey"},{"name":"smOwnersForKey"},{"name":"snmp"},{"name":"software"},{"name":"softwares"},{"name":"spanningTree"},{"name":"speedTest"},{"name":"speedTestResults"},{"name":"splash"},{"name":"splashAuthorizationStatus"},{"name":"splashLoginAttempts"},{"name":"split"},{"name":"spokes"},{"name":"ssids"},{"name":"stacks"},{"name":"staged"},{"name":"stages"},{"name":"states"},{"name":"static"},{"name":"staticRoutes"},{"name":"statics"},{"name":"stats"},{"name":"status"},{"name":"statuses"},{"name":"stickyEvents"},{"name":"stormControl"},{"name":"stp"},{"name":"subnetPool"},{"name":"subnets"},{"name":"subscription"},{"name":"subscriptions"},{"name":"successfulConnections"},{"name":"summaries"},{"name":"summary"},{"name":"summaryConsumerMetrics"},{"name":"summaryPanel"},{"name":"supported"},{"name":"sustainability"},{"name":"swap"},{"name":"swaps"},{"name":"switchPortStatus"},{"name":"switches"},{"name":"sync"},{"name":"syncJobs"},{"name":"syslog"},{"name":"syslogServers"},{"name":"system"},{"name":"tags"},{"name":"targetGroups"},{"name":"targets"},{"name":"tasks"},{"name":"taxonomy"},{"name":"telemetry"},{"name":"termsAndConditions"},{"name":"testConnectivity"},{"name":"tests"},{"name":"themes"},{"name":"thirdPartyVPNPeers"},{"name":"thousandEyes"},{"name":"threads"},{"name":"throughputTest"},{"name":"timeToConnect"},{"name":"token"},{"name":"tokens"},{"name":"top"},{"name":"topics"},{"name":"topology"},{"name":"towers"},{"name":"traceRoute"},{"name":"traffic"},{"name":"trafficAnalysis"},{"name":"trafficHistory"},{"name":"trafficShaping"},{"name":"transceivers"},{"name":"traps"},{"name":"trial"},{"name":"trustedAccessConfigs"},{"name":"trustedServers"},{"name":"tunnelCreation"},{"name":"tunnelStatus"},{"name":"tunnelable"},{"name":"tunneling"},{"name":"types"},{"name":"umbrella"},{"name":"unassigned"},{"name":"update"},{"name":"updates"},{"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":"values"},{"name":"versions"},{"name":"video"},{"name":"videoLink"},{"name":"videoWalls"},{"name":"vlanAssignments"},{"name":"vlanProfiles"},{"name":"vlans"},{"name":"vmx"},{"name":"vpcOnboardingBatches"},{"name":"vpcs"},{"name":"vpn"},{"name":"vpnExclusions"},{"name":"vpnFirewallRules"},{"name":"vpnPeers"},{"name":"vppAccounts"},{"name":"vrfs"},{"name":"vrrp"},{"name":"vrrpTable"},{"name":"wakeOnLan"},{"name":"warmSpare"},{"name":"warnings"},{"name":"webApps"},{"name":"webhookTests"},{"name":"webhooks"},{"name":"wired"},{"name":"wirelessControllers"},{"name":"wirelessProfiles"},{"name":"wlanLists"},{"name":"workflows"},{"name":"xdr"},{"name":"zigbee"},{"name":"zones"},{"name":"ztrIntents"}],"x-parser-conf":{"exampleAsDefault":true,"expand":0,"filterBy":{"$remoteModule":"config/filter_only_beta.js"},"groupBy":{"$remoteModule":"config/group_platform.js"},"httpBearer":{"bearerToken":"75dd5334bef4d2bc96f26138c163c0a3fa0b5ca6"},"labelConfig":{"endpoint":{"field":"operationId","format":"startCase"}},"overview":{"markdownPath":"docs/overview-early-access.md"},"serverConfig":true,"sortBy":{"$remoteModule":"config/sort_by.js"},"theme":"meraki","variables":{"networkId":"N_784752235069315754","organizationId":"1215707","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"},"oauth2":{"type":"oauth2","description":"This API uses OAuth 2 with the authorization code grant flow. [More info](https://developer.cisco.com/meraki/api-v1/authorization/)","flows":{"authorizationCode":{"authorizationUrl":"https://as.meraki.com/oauth/authorize","tokenUrl":"https://as.meraki.com/oauth/token","scopes":{"camera:config:read":"Cameras (MV)","camera:config:write":"Cameras (MV)","camera:telemetry:read":"Cameras (MV)","camera:telemetry:write":"Cameras (MV)","dashboard:general:config:read":"Entire dashboard, excluding identity and access management","dashboard:general:config:write":"Entire dashboard, excluding identity and access management","dashboard:general:telemetry:read":"Entire dashboard, excluding identity and access management","dashboard:general:telemetry:write":"Entire dashboard, excluding identity and access management","dashboard:iam:config:read":"Dashboard related to identity and access management, including early access features","dashboard:iam:config:write":"Dashboard related to identity and access management, including early access features","dashboard:iam:telemetry:read":"Dashboard related to identity and access management, including early access features","dashboard:iam:telemetry:write":"Dashboard related to identity and access management, including early access features","dashboard:licensing:config:read":"Licensing","dashboard:licensing:config:write":"Licensing","dashboard:licensing:telemetry:read":"Licensing","dashboard:licensing:telemetry:write":"Licensing","iot:gateway:general:config:read":"Sensor Connect (IoT Control)","iot:gateway:general:config:write":"Sensor Connect (IoT Control)","iot:gateway:general:telemetry:read":"Sensor Connect (IoT Control)","iot:gateway:general:telemetry:write":"Sensor Connect (IoT Control)","iot:gateway:onboarding:config:read":"Sensor Connect (IoT Onboarding)","iot:gateway:onboarding:config:write":"Sensor Connect (IoT Onboarding)","policy:config:read":"Provides granular authorization over all global policy resources including policy objects, adaptive policy, and Organization Group Policy","policy:config:write":"Provides granular authorization over all global policy resources including policy objects, adaptive policy, and Organization Group Policy","policy:telemetry:read":"Provides granular authorization over all global policy resources including policy objects, adaptive policy, and Organization Group Policy","policy:telemetry:write":"Provides granular authorization over all global policy resources including policy objects, adaptive policy, and Organization Group Policy","sdwan:config:read":"Secure SD-WAN (MX including MXIGZ)","sdwan:config:write":"Secure SD-WAN (MX including MXIGZ)","sdwan:telemetry:read":"Secure SD-WAN (MX including MXIGZ)","sdwan:telemetry:write":"Secure SD-WAN (MX including MXIGZ)","sensor:config:read":"Sensors (MT)","sensor:config:write":"Sensors (MT)","sensor:telemetry:read":"Sensors (MT)","sensor:telemetry:write":"Sensors (MT)","sm:config:read":"Endpoint Management (SM)","sm:config:write":"Endpoint Management (SM)","sm:telemetry:read":"Endpoint Management (SM)","sm:telemetry:write":"Endpoint Management (SM)","switch:config:read":"Switches (MS)","switch:config:write":"Switches (MS)","switch:telemetry:read":"Switches (MS)","switch:telemetry:write":"Switches (MS)","wireless:config:read":"Wireless (MR)","wireless:config:write":"Wireless (MR)","wireless:telemetry:read":"Wireless (MR)","wireless:telemetry:write":"Wireless (MR)"}}}}}},"spec":{"description":"Claims a CCW subscription using its original Web Order ID and subscription reference ID. Creates the Multicloud Fabric organization if needed and records acceptance of the current commercial terms. An already claimed purchase returns a conflict, including when requested by its owner. When the organization has no `ACTIVE` CCW subscriptions, the purchase's coverage must have started by the current UTC day. Otherwise, it must start on the UTC day immediately after the latest term of the organization's `ACTIVE` CCW subscriptions ends; that start may be in the future. Only `ACTIVE` CCW subscriptions establish this coverage boundary; `PENDING`, `CANCELLED`, and `EXPIRED` purchases do not. Gaps and overlaps with active coverage are rejected. An organization can claim only one future paid subscription at a time: another claim is rejected when it already has two or more `ACTIVE` CCW subscriptions. Each subscription counts once regardless of its number of terms. When one `ACTIVE` CCW subscription exists, turn off its auto-renewal in Cisco Commerce Workspace (CCW) before claiming another purchase. Trial, cancelled, and expired subscriptions do not count toward this limit. Claiming a CCW purchase cancels an existing active trial and closes its open term at the claim time, preserving trial history and usage. When the claim creates an organization, the optional `MCF-Shell` header records its creation source: `meraki` (Meraki Dashboard) or `ccc` (Cisco Cloud Control). Only one exact, case-sensitive value is recognized. Missing or invalid values, including repeated headers, leave the source unknown without causing a request error. The source is not returned in the response. Existing organizations retain their original source, including an unknown source.","operationId":"claimOrganizationSubscription","parameters":[{"name":"organizationId","in":"path","description":"Organization ID","schema":{"type":"string"},"required":true}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string","enum":["ccw_web_order_subscription_ref_id_pair"],"description":"`ccw_web_order_subscription_ref_id_pair` selects a claim using the CCW Web Order ID and subscription reference ID."},"ccwWebOrderSubscriptionRefIdPair":{"type":"object","properties":{"webOrderId":{"type":"string","description":"Original CCW Web Order ID. A nonblank value is required."},"subscriptionReferenceId":{"type":"string","description":"Original CCW subscription reference ID. A nonblank value is required."}},"required":["webOrderId","subscriptionReferenceId"],"description":"Original identifiers for the same CCW purchase. Values must match exactly, including capitalization and spaces."},"termsAcceptance":{"type":"object","properties":{"version":{"type":"integer","description":"Published agreement version accepted by the user. Version `0` is valid."},"accepted":{"type":"boolean","description":"`true` confirms acceptance of this version. `false` is rejected."}},"required":["version","accepted"],"description":"Acceptance of a displayed agreement version."}},"example":{"type":"ccw_web_order_subscription_ref_id_pair","ccwWebOrderSubscriptionRefIdPair":{"webOrderId":"WO-EXAMPLE-001","subscriptionReferenceId":"SUB-EXAMPLE-001"},"termsAcceptance":{"version":0,"accepted":true}},"required":["type","ccwWebOrderSubscriptionRefIdPair","termsAcceptance"]}}},"required":true},"responses":{"200":{"description":"Successful operation","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","description":"Multicloud Fabric-assigned subscription UUID used to request subscription details. It remains the same across terms."},"status":{"type":"string","enum":["ACTIVE","CANCELLED","EXPIRED"],"description":"Recorded lifecycle state of the subscription.\n\n- `ACTIVE`: The subscription is recorded as active.\n- `EXPIRED`: The subscription is recorded as expired.\n- `CANCELLED`: The subscription is recorded as cancelled.\n\nThis state is returned unchanged. Term dates and trial usage do not recalculate it. Current\ncoverage still depends on the subscription state, term dates, and available trial credit."},"autoRenewal":{"type":"boolean","description":"Whether automatic renewal is enabled for this subscription. True means enabled; false means disabled."},"claimedAt":{"type":"string","format":"date-time","description":"Time when the subscription was first claimed or the trial was created, in RFC 3339 UTC with Z. Repeated requests preserve this time. Null for older records whose original claim time is unknown."},"updatedAt":{"type":"string","format":"date-time","description":"Time of the last saved change to the subscription itself, in RFC 3339 UTC with Z. Reading does not change this time."},"type":{"type":"string","enum":["CCW","TRIAL"],"description":"Source of the subscription or term.\n\n- `CCW`: A Cisco commerce purchase, with original purchase details on the subscription and commercial details on its terms.\n- `TRIAL`: A free trial, with an empty trial object on the subscription and the granted credit amount and currency on each term.\n\nEvery term has the same type as its subscription. The matching ccw or trial object is included;\nthe other object is omitted."},"ccw":{"type":"object","properties":{"webOrderId":{"type":"string","description":"Original CCW Web Order ID. Use it with subscriptionReferenceId to claim this subscription. Renewal order identifiers do not replace this value."},"subscriptionReferenceId":{"type":"string","description":"Original CCW subscription reference ID. Use it with webOrderId to claim the subscription. This purchase identifier is separate from the Multicloud Fabric-assigned subscription UUID."},"commitmentType":{"type":"string","enum":["COMMITTED","UNCOMMITTED"],"description":"Commitment on the original purchase.\n\n- `COMMITTED`: The original purchase has a fixed commitment.\n- `UNCOMMITTED`: The original purchase has no fixed commitment.\n\nNull when the original commitment is unknown. Later term commitments may differ."},"partners":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string","description":"Partner or contact name as supplied on the purchase. Null when unavailable."},"email":{"type":"string","description":"Contact email address. Null when unavailable."},"phoneNumber":{"type":"string","description":"Contact phone number, including any supplied country code or extension. Null when unavailable."}}},"description":"All partner contacts for this subscription, in a consistent order. The array is empty when no partner contacts are available."}},"description":"Original purchase identifiers, original commitment, and confirmed partner contacts for a Cisco commerce subscription. Renewals retain these original identifiers and may have different commitments on their commercial terms."},"trial":{"type":"object","description":"Free-trial subscription marker, returned as an empty object on a TRIAL subscription."},"terms":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Multicloud Fabric-assigned UUID of this term, separate from the subscription UUID."},"type":{"type":"string","enum":["CCW","TRIAL"],"description":"Source of the subscription or term.\n\n- `CCW`: A Cisco commerce purchase, with original purchase details on the subscription and commercial details on its terms.\n- `TRIAL`: A free trial, with an empty trial object on the subscription and the granted credit amount and currency on each term.\n\nEvery term has the same type as its subscription. The matching ccw or trial object is included;\nthe other object is omitted."},"startDate":{"type":"string","format":"date-time","description":"Start of the term, inclusive, in RFC 3339 UTC with Z. A future start does not provide current cloud coverage."},"endDate":{"type":"string","format":"date-time","description":"End of the term in RFC 3339 UTC with Z. Omitted when no end date is set, including a CCW renewal awaiting activation. A null value also indicates an unknown end date. For CCW, a date identifies the inclusive last active UTC day. For TRIAL, a date is the exclusive expiry instant. Terms are omitted after their applicable expiry."},"termLengthMonths":{"type":"integer","description":"Supplied term length in calendar months, greater than zero. Null when unavailable; startDate and endDate remain the dates for this term."},"usage":{"type":"string","description":"Recorded usage for this term in decimal dollars, returned as a nonnegative string with up to 18 integer digits and 12 fractional digits. Insignificant trailing zeros are omitted. Null when recorded term usage is unavailable; a recorded zero is returned as \"0\"."},"usageCurrency":{"type":"string","enum":["USD"],"description":"Currency of usage. `USD` means United States dollars and is the only supported currency. Null when recorded term usage is unavailable."},"ccw":{"type":"object","properties":{"commitmentType":{"type":"string","enum":["COMMITTED","UNCOMMITTED"],"description":"Commitment for this term.\n\n- `COMMITTED`: The purchase has a fixed commitment.\n- `UNCOMMITTED`: Usage has no fixed commitment.\n\nNull when the commitment type is unknown. Uncommitted amounts are null."},"committedAmount":{"type":"string","description":"Supplied commitment for the full term in decimal dollars, returned as a nonnegative string with up to 18 integer digits and 12 fractional digits. Insignificant trailing zeros are omitted. Null when unknown or uncommitted."},"committedAmountCurrency":{"type":"string","enum":["USD"],"description":"Currency of committedAmount. `USD` means United States dollars and is the only supported currency. Null when the commitment currency is unavailable."}},"description":"Commercial commitment and currency for one Cisco commerce term. Optional details are null when unknown. Original purchase identifiers are returned in the subscription's ccw details."},"trial":{"type":"object","properties":{"creditAmount":{"type":"string","description":"Full credit granted for this term in decimal dollars, returned as a nonnegative string with up to 18 integer digits and 12 fractional digits. Insignificant trailing zeros are omitted. A recorded zero is returned as \"0\"."},"creditAmountCurrency":{"type":"string","enum":["USD"],"description":"Currency of creditAmount. `USD` means United States dollars and is the only supported currency."}},"description":"Full credit granted for one free-trial term. Recorded usage is returned separately on the term and does not reduce the granted amount returned here."}}},"description":"Every current or future term, ordered by startDate then term id ascending. Term selection is evaluated at the same time for the whole response. Terms ending at or before that time are omitted regardless of subscription status. Overlapping terms are included. The array is empty when all terms have ended. Every match is returned without pagination or a history filter."}}},"example":{"id":"11111111-1111-4111-8111-111111111111","status":"ACTIVE","autoRenewal":true,"claimedAt":"2026-10-14T18:00:00Z","updatedAt":"2026-10-14T18:00:00Z","type":"CCW","ccw":{"webOrderId":"WO-EXAMPLE-001","subscriptionReferenceId":"SUB-EXAMPLE-001","commitmentType":"COMMITTED","partners":[{"name":"Alex Example Morgan","email":"alex@example.test","phoneNumber":"+1-555-0100"}]},"terms":[{"id":"11111111-1111-4111-8211-111111111111","type":"CCW","startDate":"2026-10-01T00:00:00Z","endDate":"2027-10-01T00:00:00Z","termLengthMonths":12,"usage":"0","usageCurrency":"USD","ccw":{"commitmentType":"COMMITTED","committedAmount":"12000","committedAmountCurrency":"USD"},"trial":{"creditAmount":"200","creditAmountCurrency":"USD"}}]}}}}},"summary":"Claims a CCW subscription using its original Web Order ID and subscription reference ID","tags":["organizations","configure","mcf","subscriptions","claim"],"x-release-stage":"beta","__originalOperationId":"claimOrganizationSubscription","security":[{"meraki_api_key":[]},{"bearerAuth":[]},{"oauth2":[]}],"method":"post","path":"/organizations/{organizationId}/mcf/subscriptions/claim"}}