{"type":"api","title":"Terminate V 2","meta":{"id":"/apps/pubhub/media/wg2-provider-mobility-api/2399805c96165da845b7295c0f3523bddeb07dc4/38d14f13-d0e0-3d33-9aa3-fe0e0339af91","info":{"title":"Core Network APIs","description":"## Introduction to the Core Network REST APIs\n\nWelcome to the documentation for the Mobility Services REST APIs. This collection of APIs allows for the provisioning and management of subscriber services, handling various operations related to subscription profiles, SIM import, and more. The APIs are designed to be straightforward and intuitive, encapsulating complex telecommunications operations into simple API calls.\n\n### Overview\n\nThe APIs are grouped into two main categories:\n\n1. **Subscription Profile And Provisioning**: This set of APIs covers a broad range of functionalities related to subscriber profiles. Through these APIs, you can retrieve information about a subscription, activate a new subscription, update existing subscriptions, change SIMs, block or unblock SIMs, change MSISDN, terminate subscriptions, and more. It supports a variety of parameters and configurations allowing for a flexible management of subscriber services.\n\n2. **SIM Import (BETA)**: This API facilitates the import of SIMs to the Mobility Services platform. It provides the ability to specify essential SIM attributes like BSSID, ICCID, IMSIs, and cryptographic keys for provisioning SIMs. Please note that this SIM import API is not stable and is subject to change.\n\n### Authentication and Authorization\n\nThe APIs support OAuth2 Client Credentials flow for authentication, where clients can obtain a token from the specified token URL. Different scopes are defined for reading and writing subscription information, as well as importing SIM data.\n\n### Error Handling\n\nStandard HTTP status codes are used to indicate the success or failure of an API request. Specific error schemas are defined to provide more information about the error, including a description of the error and additional details if applicable.\n\n### Rate Limiting\n\nThe APIs have built-in rate limiting to ensure fair usage and to protect the system from abuse. Responses include standard headers to indicate the current rate limit status.\n","contact":{"email":"mobility-services-developer@cisco.com"},"license":{"name":"Apache 2.0","url":"http://www.apache.org/licenses/LICENSE-2.0.html"},"version":"1.0.0"},"externalDocs":{"description":"See docs.wgtwo.com","url":"https://docs.wgtwo.com"},"security":[{"operatorKey":[]},{"OAuth2":["subscription.read","subscription.write","sim.import.write"]}]},"spec":{"tags":["Subscription Profile v2"],"summary":"Terminate","operationId":"terminate_v2","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"bssid":{"type":"string"},"msisdn":{"type":"string","description":"One of msisdn, iccid, imsi is required"},"iccid":{"type":"string","description":"One of msisdn, iccid, imsi is required"},"imsi":{"type":"string","description":"One of msisdn, iccid, imsi is required"}}},"example":{"bssid":"operator_name","msisdn":"46737678218"}}}},"responses":{"201":{"description":"successful operation","content":{"application/json":{"schema":{"type":"object","properties":{"requestid":{"type":"string"}},"$$ref":"#/components/schemas/UpdateSubscriptionResponse"}}}},"400":{"description":"Invalid input","content":{}},"401":{"description":"The client does not have valid credentials","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","example":"invalid or missing credentials"}},"$$ref":"#/components/schemas/AccessDenied"}}},"$$ref":"#/components/responses/Unauthorized"},"403":{"description":"The client is not authorized to access this resource","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","example":"invalid or missing credentials"}},"$$ref":"#/components/schemas/AccessDenied"}}},"$$ref":"#/components/responses/Forbidden"},"404":{"description":"Subscription not found","content":{}},"429":{"description":"The client has exceeded the rate limit","content":{"application/json":{"schema":{"type":"string","example":"Too Many Requests","$$ref":"#/components/schemas/RateLimitExceeded"}}},"$$ref":"#/components/responses/RateLimitExceeded"}},"__originalOperationId":"terminate.v2","security":[{"operatorKey":[]},{"OAuth2":["subscription.read","subscription.write","sim.import.write"]}],"method":"post","path":"/provision/v2/terminate"}}