---
title: "[USES 10 UNITS PER NAME] Infer the likely country of residence of up to 100 personal full names, or surnames. Assumes names as they are in the country of residence OR the country of origin."
method: POST
path: "/api2/json/countryBatch"
tags: ["personal"]
---

# [USES 10 UNITS PER NAME] Infer the likely country of residence of up to 100 personal full names, or surnames. Assumes names as they are in the country of residence OR the country of origin.

`POST /api2/json/countryBatch`

## Request body

- BatchPersonalNameIn
  - `personalNames` PersonalNameIn[]
    - `id` string
    - `name` string

## Response `200`

A list of origined names.

- BatchPersonalNameGeoOut
  - `personalNames` PersonalNameGeoOut[] — Classified geo names
    - `script` string
    - `id` string
    - `explanation` string
    - `name` string — The input name.
    - `score` number, double — Higher score is better, but score is not normalized. Use calibratedProbability if available.
    - `country` string — Most likely country
    - `countryAlt` string — Second best alternative : country
    - `region` string — Most likely region (based on country ISO2 code)
    - `topRegion` string — Most likely top region (based on country ISO2 code)
    - `subRegion` string — Most likely sub region (based on country ISO2 code)
    - `countriesTop` string[] — List countries (top 10)
    - `probabilityCalibrated` number, double — The calibrated probability for country to have been guessed correctly. -1 = still calibrating.
    - `probabilityAltCalibrated` number, double — The calibrated probability for country OR countryAlt to have been guessed correctly. -1 = still calibrating.
    - `religionStats` ReligionStatOut[] — Geographic religious statistics, assuming country is correctly predicted.
      - `religion` string
      - `pct` number, double
    - `religionStatsAlt` ReligionStatOut[] — Geographic religious statistics, for country best alternative.
      - `religion` string
      - `pct` number, double

## Other responses

- `400` — Bad request (ex. too many names)
- `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)