The Number Recycling v0.2 API from Nokia — 1 operation(s) for number recycling v0.2.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.curl "https://apis.io/api/v1/apis/nokia-corp:nokia-corp-number-recycling-v0-2-api"curl "https://apis.io/api/v1/apis?limit=25"Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
openapi: 3.2.0
info:
title: Nokia Corp Number Recycling v0.2 API
version: 1.0.0
termsOfService: https://developer.networkascode.nokia.io/legal/terms-of-service
x-refined-note:
- x-badges differs across the merged source definitions and was not carried
- x-camara-commonalities differs across the merged source definitions and was not carried
- x-category differs across the merged source definitions and was not carried
- x-collections differs across the merged source definitions and was not carried
- x-long-description differs across the merged source definitions and was not carried
- x-public differs across the merged source definitions and was not carried
- x-thumbnail differs across the merged source definitions and was not carried
- x-version-lifecycle differs across the merged source definitions and was not carried
- x-website differs across the merged source definitions and was not carried
description: 'Operations tagged Number Recycling v0.2 across 3 of this provider''s published API definitions: Single-NaC-API-OAS.yaml, rapid-spec-oas.json, nokia-corp-network-as-code-openapi.yml. Each path carries the servers of the definition it was published in.'
servers:
- url: '{apiRoot}/geofencing-subscriptions/v0.3'
variables:
apiRoot:
default: http://localhost:9091
description: API root
- url: '{apiRoot}/geofencing-subscriptions/v0.4'
variables:
apiRoot:
default: http://localhost:9091
description: API root
- url: https://network-as-code.p-eu.rapidapi.com
tags:
- name: Number Recycling v0.2
paths:
/passthrough/camara/v1/number-recycling/number-recycling/v0.2/check:
post:
security:
- openId:
- number-recycling:check
tags:
- Number Recycling v0.2
summary: Check whether the subscriber of the phone number has changed
description: Check whether the subscriber of the phone number has changed.
operationId: checkNumberRecycling
parameters:
- $ref: '#/components/parameters/x-correlator-NUMR-RECYCL-V0'
- in: header
name: authorization
required: false
description: authorization header for token
schema:
type: string
requestBody:
description: Check whether the subscriber of the phone number has changed.
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/CreateCheckNumRecycling-NUMR-RECYCL-V0'
examples:
CHECK_NUMBER_RECYCLING:
value:
phoneNumber: '+99999991000'
specifiedDate: '2024-10-31'
CHECK_NUMBER_RECYCLING_REQUEST_3_LEGGED:
summary: Example request without phone number when using three-legged access token
value:
specifiedDate: '2024-10-31'
responses:
'200':
$ref: '#/components/responses/Generic200-NUMR-RECYCL-V0'
'400':
$ref: '#/components/responses/Generic400-NUMR-RECYCL-V0'
'401':
$ref: '#/components/responses/Generic401-NUMR-RECYCL-V0'
'403':
$ref: '#/components/responses/Generic403-NUMR-RECYCL-V0'
'404':
$ref: '#/components/responses/Generic404-NUMR-RECYCL-V0'
'422':
$ref: '#/components/responses/Generic422-NUMR-RECYCL-V0'
servers:
- url: '{apiRoot}/geofencing-subscriptions/v0.3'
variables:
apiRoot:
default: http://localhost:9091
description: API root
- url: '{apiRoot}/geofencing-subscriptions/v0.4'
variables:
apiRoot:
default: http://localhost:9091
description: API root
components:
schemas:
XCorrelator-NUMR-RECYCL-V0:
type: string
pattern: ^[a-zA-Z0-9-_:;.\/<>{}]{0,256}$
example: b4333c46-49c0-4f62-80d7-f0ef930f1c46
PhoneNumber-NUMR-RECYCL-V0:
description: A public identifier addressing a telephone subscription. In mobile networks it corresponds to the MSISDN (Mobile Station International Subscriber Directory Number). In order to be globally unique it has to be formatted in international format, according to E.164 standard, prefixed with '+'.
type: string
pattern: ^\+[1-9][0-9]{4,14}$
example: '+123456789'
ErrorInfo-NUMR-RECYCL-V0:
type: object
required:
- status
- code
- message
properties:
status:
type: integer
description: HTTP response status code
code:
type: string
description: A human-readable code to describe the error
message:
type: string
description: A human-readable description of what the event represents
CreateCheckNumRecycling-NUMR-RECYCL-V0:
type: object
required:
- specifiedDate
properties:
phoneNumber:
$ref: '#/components/schemas/PhoneNumber-NUMR-RECYCL-V0'
specifiedDate:
type: string
format: date
description: Specified date to check whether there has been a change in the subscriber associated with the specific phone number, in RFC 3339 calendar date format (YYYY-MM-DD).
example: '2024-10-31'
CheckNumRecyclingInfo-NUMR-RECYCL-V0:
type: object
required:
- phoneNumberRecycled
properties:
phoneNumberRecycled:
type: boolean
description: 'Set to true (Boolean, not string) when there has been a change in the subscriber associated with the specific phone number after “specifiedDate”.
'
parameters:
x-correlator-NUMR-RECYCL-V0:
name: x-correlator
in: header
description: Correlation id for the different services
schema:
$ref: '#/components/schemas/XCorrelator-NUMR-RECYCL-V0'
x-rapidapi-host:
name: x-rapidapi-host
in: header
required: true
description: The API's Host value as defined in the RapidAPI Hub.
schema:
type: string
example: network-as-code.p-eu.rapidapi.com
responses:
Generic200-NUMR-RECYCL-V0:
description: OK
headers:
x-correlator:
$ref: '#/components/headers/x-correlator-NUMR-RECYCL-V0'
content:
application/json:
schema:
$ref: '#/components/schemas/CheckNumRecyclingInfo-NUMR-RECYCL-V0'
Generic401-NUMR-RECYCL-V0:
description: Authentication problem with the client request
headers:
x-correlator:
$ref: '#/components/headers/x-correlator-NUMR-RECYCL-V0'
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/ErrorInfo-NUMR-RECYCL-V0'
- type: object
properties:
status:
enum:
- 401
code:
enum:
- UNAUTHENTICATED
examples:
Unauthenticated:
description: Request cannot be authenticated and a new authentication is required
value:
status: 401
code: UNAUTHENTICATED
message: Request not authenticated due to missing, invalid, or expired credentials. A new authentication is required.
Generic400-NUMR-RECYCL-V0:
description: Problem with the client request
headers:
x-correlator:
$ref: '#/components/headers/x-correlator-NUMR-RECYCL-V0'
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/ErrorInfo-NUMR-RECYCL-V0'
- type: object
properties:
status:
enum:
- 400
code:
enum:
- INVALID_ARGUMENT
- OUT_OF_RANGE
examples:
InvalidArgument:
description: Invalid Argument. Generic Syntax Exception
value:
status: 400
code: INVALID_ARGUMENT
message: Client specified an invalid argument, request body or query param.
OutOfRange:
description: Out of Range. Specific Syntax Exception used when a given field has a pre-defined range or a invalid filter criteria combination is requested
value:
status: 400
code: OUT_OF_RANGE
message: Client specified an invalid range.
Generic404-NUMR-RECYCL-V0:
description: Resource Not Found
headers:
x-correlator:
$ref: '#/components/headers/x-correlator-NUMR-RECYCL-V0'
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/ErrorInfo-NUMR-RECYCL-V0'
- type: object
properties:
status:
enum:
- 404
code:
enum:
- IDENTIFIER_NOT_FOUND
examples:
Phone Number Used By Different Network Operator:
description: Provided phone number is used by a different network operator
value:
status: 404
code: IDENTIFIER_NOT_FOUND
message: Phone number not found.
Generic422-NUMR-RECYCL-V0:
description: Unprocessable Content
headers:
x-correlator:
$ref: '#/components/headers/x-correlator-NUMR-RECYCL-V0'
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/ErrorInfo-NUMR-RECYCL-V0'
- type: object
properties:
status:
enum:
- 422
code:
enum:
- SERVICE_NOT_APPLICABLE
- MISSING_IDENTIFIER
- UNNECESSARY_IDENTIFIER
examples:
Device Not Applicable:
description: Service not applicable for the provided phone number
value:
status: 422
code: SERVICE_NOT_APPLICABLE
message: The service is not available for the provided phone number
Unnecessary Identifier:
description: An explicit identifier is provided when a phone number has already been identified from the access token
value:
status: 422
code: UNNECESSARY_IDENTIFIER
message: The phone number is already identified by the access token
Missing Identifier:
description: An identifier is not included in the request and the phone number identification cannot be derived from the 3-legged access token
value:
status: 422
code: MISSING_IDENTIFIER
message: The phone number cannot be identified
Generic403-NUMR-RECYCL-V0:
description: Client does not have sufficient permission
headers:
x-correlator:
$ref: '#/components/headers/x-correlator-NUMR-RECYCL-V0'
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/ErrorInfo-NUMR-RECYCL-V0'
- type: object
properties:
status:
enum:
- 403
code:
enum:
- PERMISSION_DENIED
examples:
Permission Denied:
description: Permission denied. OAuth2 token access not have the required scope or when the user fails operational security
value:
status: 403
code: PERMISSION_DENIED
message: Client does not have sufficient permissions to perform this action
headers:
x-correlator-NUMR-RECYCL-V0:
description: Correlation id for the different services
schema:
$ref: '#/components/schemas/XCorrelator-NUMR-RECYCL-V0'
securitySchemes:
openId:
description: OpenID Connect authentication
type: openIdConnect
openIdConnectUrl: https://example.com/.well-known/openid-configuration
ApiKeyAuth:
type: apiKey
in: header
name: x-rapidapi-key
description: Your RapidAPI key
externalDocs:
description: Project documentation at Camara
url: https://github.com/camaraproject/DeviceLocation
x-refined-from:
- Single-NaC-API-OAS.yaml
- rapid-spec-oas.json
- nokia-corp-network-as-code-openapi.yml
x-provenance:
method: harvested
publisher: Nokia
source: https://raw.githubusercontent.com/nokia-steward/network-as-code-sdks/main/openapi/Single-NaC-API-OAS.yaml
note: split by refine-openapis from the provider's own published document, verified by fetch (openapi/_original/*.fetch.json);
stamped by stamp-openapi-provenance.py (roadmap#793)