---
title: "get chat ID from phone number"
method: POST
path: "/instances/{id}/client/action/get-number-id"
tags: ["number"]
---

# get chat ID from phone number

`POST /instances/{id}/client/action/get-number-id`

Converts a phone number into the proper chat ID format. This is especially useful for countries that don't follow the standard chat ID format (like Brazil, Mexico and Argentina). The endpoint ensures you get the correct chat ID for any phone number.

## Path parameters

- `id` integer, required

## Request body

- object
  - `number` string, required — Phone number in international format without leading + or 00

## Response `200`

Successfully retrieved chat ID

- object
  - `data` object
    - `status` 'success' | 'error'
    - `instanceId` string
    - `data` object
      - `numberId` object
        - `server` string — server suffix
        - `user` string — Phone number in international format
        - `_serialized` string — Complete chat ID
  - `links` object
    - `self` string
  - `status` 'success' | 'error'

## Other responses

- `401` — Unauthorized — invalid or missing bearer token
- `403` — Forbidden — insufficient permissions or account blocked
- `404` — Not found — instance does not exist or does not belong to you
- `409` — Conflict — instance is not ready
- `422` — Validation error — invalid or missing request parameters
- `429` — Too many requests — rate limit exceeded

---

[API](https://skmtc.net/waapi/apis/waapi-api.md) · [All operations](https://skmtc.net/waapi/apis/waapi-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/waapi/waapi-api/revisions/1e2cc7c12090/schema)