---
title: "Parse phone numbers"
method: POST
path: "/v4/tools/parsephonenumbers"
tags: ["Tools"]
---

# Parse phone numbers

`POST /v4/tools/parsephonenumbers`

## Request

- Base URL: `https://api.inmobile.com`
- URL: `https://api.inmobile.com/v4/tools/parsephonenumbers`
- Auth: one of:
  - HTTP basic
  - API key in query parameter `apikey`

## Request body

- ParsePhoneNumberPostRequest
  - `numbersToParse` RawMsisdnAndCountryHint[], required: A list of the numbersToParse and country hints to be parsed
    - `countryHint` string: The country part of the msisdn, e.g. 45 or DK.
    - `rawMsisdn` string: The input msisdn in its unaltered format. This is the value provided when sending the text message.

## Response `200`

- ParsePhoneNumberPostReply
  - `results` NumberDetails[]
    - `countryCode` string: The country code part of the msisdn, e.g. 45.
    - `phoneNumber` string: The phone number part of the msisdn, e.g. 12345678.
    - `rawMsisdn` string: The input msisdn in its unaltered format. This is the value provided when sending the text message.
    - `msisdn` string: The final cleaned msisdn.
    - `isValidMsisdn` boolean: True if the input msisdn was valid.
    - `countryHint` string: The country code hint if provided in the request.

## Other responses

- `400`: Bad request
- `401`: Unauthorized
- `404`: Not found
- `500`: Internal server error

---

[API](https://skmtc.dev/inmobile/apis/inmobile-rest-api.md) · [All operations](https://skmtc.dev/inmobile/apis/inmobile-rest-api/llms.txt) · [OpenAPI document](https://skmtc.dev/inmobile/apis/inmobile-rest-api/revisions/197a90ad5f8f?raw)