---
title: "Phone Risk"
method: POST
path: "/phone/risk"
---

# Phone Risk

`POST /phone/risk`

Use this API to assess a user's behavioral risk through their phone number

## Request body

- object
  - `recipient` string, required — User's phone number. Enter the phone number as a numerical string with no delimiters, such as ".", "(", ")", or "-".
  - `callbackUrl` string, required — Callback URL to receive the risk assessment score.
  - `metadata` string, json — Metadata to be sent to a webhook (`callbackUrl`)

## Response `200`

200

- object
  - `error` unknown
  - `data` object
    - `phoneNumber` string
    - `countryCode` string
    - `phoneType` string
    - `phoneTypeStatus` string
    - `riskLevel` string
    - `riskInsights` object[]
      - `name` string
      - `description` string
      - `impact` string
      - `type` string
    - `riskScore` integer
    - `maxPossibleRiskScore` integer
    - `recommendation` string
    - `timezone` string
    - `lineType` string
    - `carrier` string
    - `location` object
      - `city` string
      - `state` unknown
      - `zip` unknown
      - `metroCode` unknown
      - `county` unknown
      - `country` string
  - `metadata` object
    - `user_defined` string

## Other responses

- `400` — 400

---

[API](https://skmtc.net/metamap/apis/get-authorization-token.md) · [All operations](https://skmtc.net/metamap/apis/get-authorization-token/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/metamap/get-authorization-token/versions/ffdfcfeffe2a/schema)