---
title: "Check reputation for phone numbers"
method: POST
path: "/number-reputation/1/reputation"
tags: ["channels", "voice", "number-reputation-hiya", "reputation-scoring"]
---

# Check reputation for phone numbers

`POST /number-reputation/1/reputation`

## Request

- Base URL: `https://api.infobip.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.infobip.com/number-reputation/1/reputation`
- Auth: one of:
  - API key in header `Authorization`
  - API key in header `Authorization`
  - HTTP basic
  - OAuth 2
    - Client credentials
    - Token URL: `https://api.infobip.com/auth/1/oauth2/token`

Query real-time reputation scores for registered phone numbers. This is a billable operation — each phone number in the request counts as one billable unit.

## Request body

- Eb9826dda36bfa834ba8eec2d30e3749cbed4dee9bcabc5eb783ccaddacf60a3PublicCheckReputationRequest
  - `phoneNumbers` string[], required: Phone numbers to query reputation for. Must be registered under the account.

## Response `200`

Success

- Eb9826dda36bfa834ba8eec2d30e3749cbed4dee9bcabc5eb783ccaddacf60a3HiyaReputationListResponse
  - `results` Eb9826dda36bfa834ba8eec2d30e3749cbed4dee9bcabc5eb783ccaddacf60a3PublicReputation[]: List of reputation results.
    - `phoneNumber` string, required: Phone number.
    - `businessId` string, uuid: Business ID the number is registered under.
    - `reputationAvailable` 'AVAILABLE' | 'UNAVAILABLE' | 'NOT_FOUND' | 'UNKNOWN', required: Whether reputation data is available for this number.
    - `currentReputation` Eb9826dda36bfa834ba8eec2d30e3749cbed4dee9bcabc5eb783ccaddacf60a3PublicReputationDetail: Last known reputation metrics.
      - `flagStatus` 'FLAGGED' | 'MIXED_HIGH' | 'MIXED_LOW' | 'UNFLAGGED' | 'UNKNOWN', required: Overall spam flag status.
      - `flagCategory` string: Category of spam flag (e.g. Telemarketer, Survey).
      - `maturityMetric` 'GOOD' | 'NORMAL' | 'POOR' | 'VERY_POOR' | 'UNKNOWN': Is the number well-established or fresh/new?
      - `desirabilityMetric` 'GOOD' | 'NORMAL' | 'POOR' | 'VERY_POOR' | 'UNKNOWN': Do recipients answer calls from this number?
      - `engagementMetric` 'GOOD' | 'NORMAL' | 'POOR' | 'VERY_POOR' | 'UNKNOWN': Do recipients stay on the line?
      - `reactionMetric` 'GOOD' | 'NORMAL' | 'POOR' | 'VERY_POOR' | 'UNKNOWN': Do recipients block or report the caller?

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden
- `429`: Too Many Requests
- `500`: Internal Server Error
- `502`: Bad gateway

---

[API](https://skmtc.dev/infobip/apis/infobip-openapi-specification.md) - [All operations](https://skmtc.dev/infobip/apis/infobip-openapi-specification/llms.txt) - [OpenAPI document](https://skmtc.dev/infobip/apis/infobip-openapi-specification/revisions/9dcbbaf902de?raw)