---
title: "Scam Signal"
url: "https://developer.pxg.konera.com/apis/scam-signal-0/versions/d93b10e2-3a7d-4f74-b34c-00804b99dc59"
---

# Scam Signal

OpenAPI specification document.

```json
{"openapi":"3.0.3","info":{"title":"Scam Signal","version":"0.3.0","description":"Scam Signal API (GSMA Open Gateway / CAMARA-aligned). Provides network signals that help identify potential scam scenarios. Signal availability and semantics may vary by operator."},"servers":[{"url":"https://api.pxg.konera.com/camara","description":"Production CAMARA API Gateway"}],"tags":[{"name":"Scam Signal","description":"Scam and fraud detection signals"}],"security":[{"OAuth2ClientCredentials":["scam-signal.read"]}],"paths":{"/scam-signal/v0.3/signal":{"post":{"tags":["Scam Signal"],"summary":"Retrieve scam signal for a device","description":"Retrieves scam-related network signals for the specified phone number.","operationId":"getScamSignal","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/ScamSignalRequest"},"example":{"phoneNumber":"+919036499174","context":{"transactionId":"tx-12345"}}}}},"responses":{"200":{"description":"Scam signal retrieved successfully","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ScamSignalResponse"},"example":{"isInVoiceCall":false,"assessedAt":"2026-02-05T09:30:00Z","signals":{"riskScore":0.1}}}}},"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"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}}},"components":{"securitySchemes":{"OAuth2ClientCredentials":{"type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://auth.example.com/oauth2/token","scopes":{"scam-signal.read":"Read scam-related network signals"}}}}},"schemas":{"ScamSignalRequest":{"type":"object","required":["phoneNumber"],"properties":{"phoneNumber":{"type":"string","description":"MSISDN in E.164 format","example":"+919036499174"},"context":{"type":"object","nullable":true,"description":"Optional transaction or business context","additionalProperties":true}}},"ScamSignalResponse":{"type":"object","required":["assessedAt"],"properties":{"isInVoiceCall":{"type":"boolean","nullable":true,"description":"Indicates whether the device is currently engaged in a voice call (if supported by the operator)","example":false},"assessedAt":{"type":"string","format":"date-time","description":"Time at which the signal was assessed","example":"2026-02-05T09:30:00Z"},"signals":{"type":"object","nullable":true,"description":"Additional operator-specific signals","additionalProperties":true}}},"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"}}}}}}
```