---
title: "Changes to [USES 10 UNITS PER NAME] Infer a US resident's likely race/ethnicity according to US Census taxonomy, using (optional) ZIP5 code info. Output is W_NL (white, non latino), HL (hispano latino),  A (asian, non latino), B_NL (black, non latino). Optionally add header X-OPTION-USRACEETHNICITY-TAXONOMY: USRACEETHNICITY-6CLASSES for two additional classes, AI_AN (American Indian or Alaskan Native) and PI (Pacific Islander)."
method: GET
path: "/api2/json/usRaceEthnicityZIP5/{firstName}/{lastName}/{zip5Code}"
---

# Changes to [USES 10 UNITS PER NAME] Infer a US resident's likely race/ethnicity according to US Census taxonomy, using (optional) ZIP5 code info. Output is W_NL (white, non latino), HL (hispano latino),  A (asian, non latino), B_NL (black, non latino). Optionally add header X-OPTION-USRACEETHNICITY-TAXONOMY: USRACEETHNICITY-6CLASSES for two additional classes, AI_AN (American Indian or Alaskan Native) and PI (Pacific Islander).

`GET /api2/json/usRaceEthnicityZIP5/{firstName}/{lastName}/{zip5Code}`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 1 of 6 revisions.

- **2025-05-16** `6297d39b756d`: 2 info

## Changes

- **2025-05-16** `6297d39b756d`: 2 info
  - added the non-success response with the status `429`
  - added the optional property `explanation` to the response with the `200` status

---

[Operation](https://skmtc.dev/namsor/apis/namsor-api-v2/docs/api2/json/usRaceEthnicityZIP5/:firstName/:lastName/:zip5Code/get.md) - [API](https://skmtc.dev/namsor/apis/namsor-api-v2.md) - [Page](https://skmtc.dev/namsor/apis/namsor-api-v2/changes/api2/json/usRaceEthnicityZIP5/:firstName/:lastName/:zip5Code/get)