---
title: "SIM Swap Retrieve Date API"
url: "https://developer.pxg.konera.com/apis/sim-swap-retrieve-date-apiindia-2/versions/ad847c45-c0ff-4999-b150-3b79b30958a1"
---

# SIM Swap Retrieve Date API

OpenAPI specification document.

```json
{"openapi":"3.0.3","info":{"title":"SIM Swap Retrieve Date API","description":"CAMARA SIM Swap Retrieve Date API. Retrieves the most recent SIM swap date for a phone number.","version":"2.0.0"},"servers":[{"url":"https://api.pxg.konera.com/camara","description":"Production CAMARA API Gateway"}],"tags":[{"name":"SIM Swap Retrieve Date","description":"SIM swap date retrieval APIs"}],"security":[{"OAuth2ClientCredentials":["sim-swap.read"]}],"paths":{"/sim-swap/v2/retrieve-date":{"post":{"tags":["SIM Swap Retrieve Date"],"summary":"Retrieve most recent SIM swap date","description":"Retrieves the most recent SIM swap date for the given phone number.","operationId":"retrieveSimSwapDate","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/SimSwapRetrieveDateRequest"},"example":{"phoneNumber":"+14155550123"}}}},"responses":{"200":{"description":"SIM swap date returned","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SimSwapRetrieveDateResponse"},"example":{"lastSimSwapDate":"2026-01-15T10:00:00Z"}}}},"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":{"sim-swap.read":"Read SIM swap signal"}}}}},"schemas":{"SimSwapRetrieveDateRequest":{"type":"object","required":["phoneNumber"],"properties":{"phoneNumber":{"type":"string","description":"MSISDN in E.164 format","example":"+14155550123"}}},"SimSwapRetrieveDateResponse":{"type":"object","required":["lastSimSwapDate"],"properties":{"lastSimSwapDate":{"type":"string","format":"date-time","description":"Timestamp of the most recent SIM swap event","example":"2026-01-15T10:00:00Z"}}},"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"}}}}}}
```