SIM Swap Retrieve Date API
Overview
The SIM Swap Retrieve Date API retrieves the most recent SIM swap date for a phone number.
- Version: 2.0.0
- Base URL:
https://api.pxg.konera.com/camara - Path:
/sim-swap/v2/retrieve-date - OpenAPI:
sim-swap-retrieve-date.openapi.json
Typical use cases
- High‑value transaction checks – Review the last SIM swap date as part of risk scoring.
- Account lifecycle monitoring – Track when a subscriber’s SIM changes for compliance or analytic purposes.
- Dispute investigations – Use SIM swap timelines when investigating fraud or chargebacks.
Security
- OAuth2 Client Credentials
- Token URL:
https://auth.konera.com/oauth2/token - Scope:
sim-swap.read– Read SIM swap signal
- Token URL:
Headers
x-correlation-id(optional, string) – Correlation ID for request tracing.
Request
POST https://api.pxg.konera.com/camara/sim-swap/v2/retrieve-date
Body schema: SimSwapRetrieveDateRequest
{
"phoneNumber": "+14155550123"
}
phoneNumber(string, required) – MSISDN in E.164 format.
Responses
200 – SIM swap date returned
Body schema: SimSwapRetrieveDateResponse
{
"lastSimSwapDate": "2026-01-15T10:00:00Z"
}
lastSimSwapDate(string, date-time) – Timestamp of the most recent SIM swap event.
HTTP status codes
Standard Error schema with:
- 200 OK – Last SIM swap date successfully retrieved.
- 400 Bad Request – Invalid phone number or payload.
- 401 Unauthorized – Invalid/missing token.
- 403 Forbidden – Caller not permitted to query SIM swap data.
- 429 Too Many Requests – Rate limit exceeded.
- 500 Internal Server Error – Unexpected server error.