Consultá los estados civiles disponibles y sus códigos de referencia.

Antes de empezar

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

Cómo consultar estados civiles

GET /api/master-tables/civil-statuses

Filtrar un estado civil puntual

GET /api/master-tables/civil-statuses?civil_status_id=SOL

Query parameters

Qué devuelve este endpoint

La respuesta devuelve un arreglo items. Cada elemento representa un estado civil disponible.

Respuesta esperada

{
  "items": [
    {
      "civil_status_id": "OTRO",
      "civil_status": "Otro"
    },
    {
      "civil_status_id": "SEP",
      "civil_status": "Separado"
    },
    {
      "civil_status_id": "VIU",
      "civil_status": "Viudo"
    },
    {
      "civil_status_id": "DIV",
      "civil_status": "Divorciado"
    },
    {
      "civil_status_id": "CAS",
      "civil_status": "Casado"
    },
    {
      "civil_status_id": "SOL",
      "civil_status": "Soltero"
    }
  ]
}

Ejemplo de respuesta filtrada

{
  "items": [
    {
      "civil_status_id": "SOL",
      "civil_status": "Soltero"
    }
  ]
}

Cuándo usar este endpoint

Este endpoint es útil cuando necesitás:

• listar estados civiles 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 países habilitados, usá GET /api/master-tables/countries.