Consultá los tipos de cuenta por tipo de persona disponibles y sus códigos de referencia.

Antes de empezar

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

Cómo consultar tipos de cuenta por tipo de persona

GET /api/master-tables/person-accounts

Filtrar un tipo puntual

GET /api/master-tables/person-accounts?person_account_type_id=PFL

Query parameters

Qué devuelve este endpoint

La respuesta devuelve un arreglo items. Cada elemento representa un tipo de cuenta por tipo de persona disponible.

Respuesta esperada

{
  "items": [
    {
      "person_account_type_id": "OIL",
      "person_account_type": "Otras Instituciones Locales"
    },
    {
      "person_account_type_id": "PFL",
      "person_account_type": "Persona Fisica Local"
    },
    {
      "person_account_type_id": "PJL",
      "person_account_type": "Persona Juridica Local"
    }
  ]
}

Ejemplo de respuesta filtrada

{
  "items": [
    {
      "person_account_type_id": "PFL",
      "person_account_type": "Persona Fisica Local"
    }
  ]
}

Cuándo usar este endpoint

Este endpoint es útil cuando necesitás:

• listar tipos de cuenta por tipo de persona 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 roles de persona para cuentas comitentes, usá GET /api/master-tables/person-roles.