---
title: "Romanize the Chinese name to Pinyin, ex. 王晓明 -> Wang (surname) Xiaoming (given name)"
method: GET
path: "/api2/json/pinyinChineseName/{chineseName}"
tags: ["chinese"]
---

# Romanize the Chinese name to Pinyin, ex. 王晓明 -> Wang (surname) Xiaoming (given name)

`GET /api2/json/pinyinChineseName/{chineseName}`

## Path parameters

- `chineseName` string, required

## Response `200`

A pinyin name.

- PersonalNameParsedOut
  - `script` string
  - `id` string
  - `explanation` string
  - `name` string — The input name.
  - `nameParserType` 'FN1LN1' | 'LN1FN1' | 'FN1LN2' | 'LN2FN1' | 'FN1LNx' | 'LNxFN1' | 'FN2LN1' | 'LN1FN2' | 'FN2LN2' | 'LN2FN2' | 'FN2LNx' | 'LNxFN2' | 'FNxLN1' | 'LN1FNx' | 'FNxLN2' | 'LN2FNx' | 'FNxLNx' | 'LNxFNx' — Name parsing is addressed as a classification problem, for example FN1LN1 means a first then last name order.
  - `nameParserTypeAlt` 'FN1LN1' | 'LN1FN1' | 'FN1LN2' | 'LN2FN1' | 'FN1LNx' | 'LNxFN1' | 'FN2LN1' | 'LN1FN2' | 'FN2LN2' | 'LN2FN2' | 'FN2LNx' | 'LNxFN2' | 'FNxLN1' | 'LN1FNx' | 'FNxLN2' | 'LN2FNx' | 'FNxLNx' | 'LNxFNx' — Second best alternative parsing. Name parsing is addressed as a classification problem, for example FN1LN1 means a first then last name order.
  - `firstLastName` FirstLastNameOut — First / last name structure corresponding to the most likely parsing.
    - `script` string
    - `id` string
    - `explanation` string
    - `firstName` string — The first name (also known as given name)
    - `lastName` string — The last name (also known as family name, or surname)
  - `score` number, double — Higher score is better, but score is not normalized. Use calibratedProbability if available.

## Other responses

- `401` — Missing or incorrect API Key
- `403` — Email not Verified, or API Limit Reached, or API Key Disabled
- `429` — Too Many Requests

---

[API](https://skmtc.net/namsor/apis/namsor-api-v2.md) · [All operations](https://skmtc.net/namsor/apis/namsor-api-v2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/namsor/namsor-api-v2/versions/305e4f6eeaf5/schema)