Consultá los géneros disponibles y sus códigos de referencia.

Antes de empezar

1. Usá este endpoint cuando necesites poblar listas de género en formularios o validaciones.
2. Si querés obtener un género puntual, enviá gender_id como query parameter.
3. Guardá el código de cada género para usarlo luego en requests que requieran ese identificador.

Cómo consultar géneros

GET /api/master-tables/genders

Filtrar un género puntual

GET /api/master-tables/genders?gender_id=M

Query parameters

Qué devuelve este endpoint

La respuesta devuelve un arreglo items. Cada elemento representa un género disponible.

Respuesta esperada

{
  "items": [
    {
      "gender_id": "F",
      "gender": "Femenino"
    },
    {
      "gender_id": "M",
      "gender": "Masculino"
    },
    {
      "gender_id": "X",
      "gender": "No Binario"
    }
  ]
}

Ejemplo de respuesta filtrada

{
  "items": [
    {
      "gender_id": "M",
      "gender": "Masculino"
    }
  ]
}

Cuándo usar este endpoint

Este endpoint es útil cuando necesitás:

• listar géneros en un formulario
• validar un código antes de enviarlo a otro servicio
• traducir un identificador técnico a una descripción legible

Errores frecuentes

• 404 Value not found: el código enviado no tiene coincidencias en el maestro.
• 422 Validation Error: el query parameter tiene un formato inválido.

Siguiente paso

Si necesitás consultar tipos de documento disponibles, usá GET /api/master-tables/document-types.