Skip to main content
GET
Obtener socios materializados

Visión general

Devuelve los socios y las demás relaciones ya guardados de una persona o empresa. Es una lectura de entities y entity_relationships. No llama integraciones, no materializa filas nuevas y no consume créditos de enrichment. Úselo después de la creación automática cuando necesite los mismos socios más tarde. data.shareholders de ese POST es solo la respuesta del alta (id, name, taxId, type de las fichas hijas materializadas en esa corrida). El porcentaje y los roles quedan en la relación y se leen acá en shareholderInfo. Las filas de QSA que nunca se convirtieron en entidades (por ejemplo un documento enmascarado) no entran. Siguen en Obtener enrichment normalizado. Exige el permiso granular entities:read en la API key (fallback legacy entities:read).

Endpoints

Los dos devuelven el mismo body. La organización sale de la API key.

Autenticación

Parámetros de ruta

string
UUID de la entidad. Úselo en GET /entities/{id}/shareholders.
string
Identificador fiscal guardado en la entidad (CNPJ, CUIT, etc.). Los dígitos se comparan igual que en obtener por tax id. Úselo en GET /entities/by-tax-id/{taxId}/shareholders. Si hay varias filas, se usa la creada más recientemente.

Parámetros de query

integer
default:"1"
Cuántos niveles de propiedad recorrer en shareholders. 1 son solo los dueños directos. Máximo 5. La lista es plana y se deduplica por id de entidad. Las empresas anidadas se expanden solo si depth es mayor que 1. relationships sigue siendo un salto desde la entidad consultada.
integer
default:"100"
Tamaño de página aplicado por separado a shareholders y a relationships. Máximo 500.
integer
default:"0"
Cuántos ítems omitir en cada array. Se aplica después de los filtros de socios.
string
Deja solo socios cuyo tipo sea person o company. Los vínculos de relationships no se filtran.
string
Identificador fiscal exacto del socio. Se comparan los dígitos, así 123.456.789-00 coincide con 12345678900.
number
riskScore mínimo, inclusive. Los socios con riskScore: null quedan fuera si se envía este parámetro o maxRiskScore.
number
riskScore máximo, inclusive.
number
Porcentaje de participación mínimo, inclusive. Los socios sin porcentaje guardado quedan fuera si se envía este parámetro o maxOwnershipPercentage.
number
Porcentaje de participación máximo, inclusive.
Los filtros se combinan con AND. Aplican solo a shareholders, después de recorrer depth y antes de limit / offset. Una empresa que no cumple el filtro igual se recorre cuando depth es mayor que 1, así un dueño que sí cumple debajo de ella puede aparecer. minRiskScore no puede ser mayor que maxRiskScore; lo mismo vale para los límites de porcentaje (400).

Respuesta

200 con { "success": true, "data": { ... } }. Los vínculos de propiedad usan dirección socio = source, entidad poseída = target, y un tipo shareholder, owns o controls. Esos van en shareholders. El resto de vínculos no borrados en los que esta entidad es source o target van en relationships.
string
UUID de la entidad consultada.
array
Dueños materializados.
  • id, name, taxId, type, riskScore — la entidad relacionada. riskScore es null si el socio no tiene score. taxId es null si la API key no tiene entities:read_sensitive.
  • shareholderInfo.percentage — metadata.shareholdingPercentage, o null
  • shareholderInfo.roles — metadata.roles (array vacío si no hay)
  • shareholderInfo.isActive — metadata.isActive, o null
number
Socios que cumplen los filtros, antes de limit / offset.
array
Otras contrapartes materializadas.
  • id, name, taxId, type — la entidad relacionada. taxId es null si la API key no tiene entities:read_sensitive.
  • relationshipType — tipo de vínculo (por ejemplo related_to)
number
Los demás vínculos, antes de limit / offset. Los filtros no cambian este total.
Una entidad sin vínculos responde 200 y ambos arrays vacíos.

Errores

Ejemplo