---
id: "employment_status"
kind: "datatype"
status: "draft"
is_pii: false
name: "Employment status"
categories: ["persons", "common"]
langs: ["en", "es"]
quality: 65
url: "https://registry.apicrafter.io/datatype/employment_status"
---

# Employment status (`employment_status`)

> **Draft.** Draft records have not been reviewed yet and may be incomplete or wrong; do not treat them as authoritative for legal or compliance decisions.

Situation of a person on the labour market as surveys, censuses and registers record it in one question: employed, full-time or part-time, as an employee or self-employed; unemployed and looking for work; or outside the labour force as a student, a retired person, a person doing unpaid household work or a person unable to work. Labour statistics call the three main groups the labour force status (employed, unemployed, outside the labour force). Data files hold the words of the questionnaire (Employed full-time, Unemployed, Retired; trabajo tiempo completo, desempleado buscando trabajo, jubilado, dueña de casa) or codes with a codebook. The occupation, the job title and the kind of contract are other things.

- Parent datatype: [`category`](https://registry.apicrafter.io/datatype/category.md)
- Personal data (PII): no
- Categories: Person related (persons), Common (common)
- Countries: global
- Languages: English (en), Spanish (es)
- Classification: categorical

## Examples

- `Employed`
- `Unemployed`
- `Retired`
- `Self-employed`
- `Employed full-time`
- `Desempleado` — Spanish for unemployed

## Metacrafter rules

1 rules: 1 match the field name, 0 match values.

- `employmentstatusbyname` (field, `common/survey.yaml`)

## Supported by tools

- [`metacrafter`](https://registry.apicrafter.io/tool/metacrafter.md)

## Translations

- es: Situación laboral
- ru: Статус занятости

## Sources

- wikipedia: <https://en.wikipedia.org/wiki/Employment>
- wikipedia: <https://en.wikipedia.org/wiki/Workforce>

## Quality

Score 65/100. Missing: regexp, negative example, mapping (Wikidata, Schema.org, ...).

JSON: <https://registry.apicrafter.io/api/v1/datatypes/employment_status.json> · Edit: <https://github.com/apicrafter/metacrafter-registry/edit/main/data/datatypes/any/persons/employment_status.yaml>
