---
title: "Number Recycling API"
url: "https://developer.pxg.konera.com/apis/number-recycling-apiindia-0/versions/6f19a3f4-e837-4d13-a8a7-e89b19814ad3"
---

# Number Recycling API

OpenAPI specification document.

```json
{"openapi":"3.0.3","info":{"title":"Number Recycling API","description":"CAMARA Number Recycling API. Checks whether a phone number has been recycled since a specified date.","version":"0.2.0"},"servers":[{"url":"https://api.pxg.konera.com/camara","description":"Production CAMARA API Gateway"}],"tags":[{"name":"Number Recycling","description":"Number recycling check APIs"}],"security":[{"OAuth2ClientCredentials":["number-recycling.read"]}],"paths":{"/number-recycling/v0.2/check":{"post":{"tags":["Number Recycling"],"summary":"Check if a number has been recycled since a specified date","description":"Checks whether the given phone number has been recycled since the specified date.","operationId":"numberRecycleCheck","parameters":[{"name":"x-correlation-id","in":"header","required":false,"description":"Correlation ID for request tracing","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NumberRecyclingRequest"},"example":{"phoneNumber":"+14155550123","specifiedDate":"2026-01-19"}}}},"responses":{"200":{"description":"Number recycling status returned","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NumberRecyclingResponse"},"example":{"recycledSinceSpecifiedDate":false}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Too Many Requests","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}}},"components":{"securitySchemes":{"OAuth2ClientCredentials":{"type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://auth.konera.com/oauth2/token","scopes":{"number-recycling.read":"Read number recycling signal"}}}}},"schemas":{"NumberRecyclingRequest":{"type":"object","required":["phoneNumber","specifiedDate"],"properties":{"phoneNumber":{"type":"string","description":"MSISDN in E.164 format","example":"+14155550123"},"specifiedDate":{"type":"string","format":"date","description":"Date (in the past) against which recycling is checked (YYYY-MM-DD)","example":"2026-01-19"}}},"NumberRecyclingResponse":{"type":"object","required":["recycledSinceSpecifiedDate"],"properties":{"recycledSinceSpecifiedDate":{"type":"boolean","description":"Indicates whether the phone number has been recycled since the specified date","example":false}}},"Error":{"type":"object","required":["status","code","message"],"properties":{"status":{"type":"integer","example":400},"code":{"type":"string","example":"INVALID_ARGUMENT"},"message":{"type":"string","example":"Invalid request"}}}}}}
```