Búsqueda de personas
Esta guía cubre la lectura centrada en la persona: encontrar a un titular o representante y saber cuánto del registro es suyo. Complementa la búsqueda por campos, donde las personas son un filtro sobre marcas; aquí son el sujeto de la consulta.
El esquema completo y siempre actualizado por campo vive en la referencia OpenAPI interactiva en
https://api.tarno.cl/docs(Scalar). Esta guía explica el contrato y enlaza a esa referencia — no reformula el esquema. La referencia es autoritativa cuando un campo no está documentado aquí.
A lo largo de la guía la URL base es https://api.tarno.cl y cada llamada lleva el encabezado
X-API-Key.
GET /parties · scope brands:read · equivalente MCP: list_parties
El recurso parties invierte la pregunta: parte de la persona y te dice cuánto del registro es suyo.
Titular, solicitante, representante y oponente son una entidad con un role allí donde interviene.
curl -sS "https://api.tarno.cl/parties?q=carey" -H "X-API-Key: $TARNO_API_KEY"
{
"results": [
{
"id": "1261017",
"name": "ESTUDIO CAREY LIMITADA",
"taxId": "76111111-6",
"country": "CL",
"kind": "legal",
"kindSource": "tax_id",
"trademarkCount": 3492,
"publishedName": "Estudio Carey Limitada",
"review": null,
"mergedInto": null
}
],
"limit": 20,
"next": null,
"hasMore": false,
"meta": { "dataAsOf": "2026-09-20T19:05:06Z", "coverageThrough": "2026-09-17" }
}
Cómo buscar
| Parámetro | Qué hace |
|---|---|
q |
Coincidencia parcial e insensible a tildes sobre el nombre. Entre 2 y 256 caracteres. argandona encuentra Argandoña. |
taxId |
Coincidencia exacta. Acepta cualquier formato (12.345.678-5, 12345678-5) y lo normaliza. |
kind |
natural | legal | unknown. |
role |
holder | applicant | representative | opponent. |
sort |
trademarkCount (por defecto, de mayor a menor) | name, con asc o desc opcional (name desc). |
limit / cursor |
Paginación con cursor opaco. limit por defecto 20, máximo 100. |
Ningún parámetro es obligatorio: sin filtros se listan todas las partes, también las que no tienen marcas.
Sin sort, los resultados vienen ordenados por volumen de marcas, de mayor a menor.
Los dos órdenes son rápidos, con cualquier filtro. El recuento de marcas de cada parte se guarda al final
de cada sincronización diaria, así que el orden por volumen sale por índice; con sort=name la página se
elige primero y el recuento se calcula sólo para sus filas. ⚠ Mientras una sincronización está en curso (unos
25 minutos al día) el recuento guardado deja de afirmarse y el orden por volumen se calcula al vuelo: la
respuesta es la misma, pero tarda entre uno y tres segundos (hasta ocho con kind o role).
Cada respuesta lleva en meta la frescura del corpus: dataAsOf (cuándo terminó la última sincronización)
y coverageThrough (hasta qué fecha de presentación llega la cobertura).
Los conteos son de AHORA — trademarkCount no filtra
trademarkCount cuenta sólo lo que la persona tiene hoy. ⭐ No filtra: las personas sin
ninguna marca siguen saliendo, con su trademarkCount a cero delante — una persona sin marcas hoy puede
tenerlas mañana, y por qué está ahí es un dato.
Partes fundidas — mergedInto
Cuando dos fichas resultan ser la misma parte (el mismo titular escrito de dos formas, un RUT corregido…),
una se funde en la otra: sus marcas y sus anotaciones pasan a la que sobrevive. La ficha fundida no
sale en GET /parties (list_parties), en ningún orden ni filtro. Si guardaste su id, GET /parties/{id}
(get_party) la sigue devolviendo, con mergedInto = el id de la parte que tiene hoy sus marcas (si esa
también se fundió después, el final de la cadena). En cualquier otra parte, mergedInto es null.
Las demás lecturas por id (/trademarks, /relations, /outcomes, la cartera) responden por la ficha
pedida, que tras la fusión ya no tiene marcas: para los datos de la parte, usa el id de mergedInto.
Lo que dice el SII — sii
Cada parte con RUT chileno que figura en la nómina de personas jurídicas del SII lleva el bloque sii
(en GET /parties/{id} ≡ get_party y en cada parte de GET /parties ≡ list_parties): la razón social
(legalName; el nombre de INAPI sigue en name), el subtipo (companyType: código del SII, nuestra etiqueta
en tres idiomas y el literal del SII), el inicio de actividades, el término de giro, la comuna y la región del
domicilio vigente según el SII y las sucursales vigentes por comuna. La calle y el número no se publican.
- Procedencia y fecha en cada bloque:
source: "sii"yasOf= la fecha del fichero del SII del que se leyó. La nómina y los domicilios son dos ficheros y cada uno lleva su fecha. Un cambio posterior a esa fecha no se ve. addresses el domicilio ACTUAL según el SII (basis: "current_sii_domicile"), no el de la solicitud: ese esterritory, de INAPI. Muchas veces no coinciden (mudanzas).businessEndedOnes el término de giro: el cese de la actividad tributaria, no una disolución. Una sociedad con giro terminado puede seguir siendo titular de sus marcas.sii: null= no hay dato: la parte no tiene RUT chileno, el fichero vigente del SII no la lista (o la lista con otro dígito verificador), o la parte está fundida en otra (mergedInto; lee esa). Nunca un valor deducido. Dentro del bloque,branches: null= aún no hay domicilios leídos para ese RUT;address: null= aún no leídos o el SII no lista un domicilio vigente para él (sibranchestrae valor, es lo segundo);branches.count: 0= el SII no lista sucursales vigentes.address.regionNamees el texto literal del SII: para comparar regiones usaregionCode.
"sii": {
"source": "sii",
"asOf": "2026-08-05",
"legalName": "EJEMPLO SOCIEDAD POR ACCIONES",
"companyType": {
"code": "223",
"label": { "es-CL": "Sociedad por acciones (SpA)", "en": "Stock company (SpA)", "pt-BR": "Sociedade por ações (SpA)" },
"source": { "label": "SOCIEDAD POR ACCIONES", "kind": "PERSONA JURIDICA COMERCIAL" }
},
"activityStartedOn": "2011-04-12",
"businessEndedOn": null,
"address": {
"source": "sii",
"asOf": "2026-08-05",
"basis": "current_sii_domicile",
"since": "2019-03-01",
"communeCode": "13114", "communeName": "LAS CONDES",
"regionCode": "13", "regionName": "XIII REGION METROPOLITANA"
},
"branches": {
"count": 3,
"communes": [
{ "communeCode": "13101", "communeName": "SANTIAGO", "regionCode": "13" },
{ "communeCode": "13123", "communeName": "PROVIDENCIA", "regionCode": "13" }
]
}
}
Para obtener las marcas de una persona (no solo el conteo), usa
GET /parties/{id}/trademarks o los filtros de persona de GET /trademarks:
# las marcas de una persona, por su id
curl -sS "https://api.tarno.cl/parties/1261017/trademarks" -H "X-API-Key: $TARNO_API_KEY"
# por RUT (cualquier rol), en la búsqueda de marcas
curl -sS "https://api.tarno.cl/trademarks?taxId=76111111-6" -H "X-API-Key: $TARNO_API_KEY"
Qué clase de parte es cada persona
Cada persona publica kind (natural | legal | unknown) y kindSource (qué señal lo produjo:
tax_id | suffix | manual | name_pattern; el MISMO vocabulario en la parte embebida en la marca,
desde el 2026-09-23). name_pattern (desde el cambio del 2026-10-28) es una deducción calibrada por la forma del nombre (palabras de
nombres de persona o palabras societarias como SOCIEDAD o FUNDACION), aplicada sólo donde su acierto medido
contra las fichas con RUT tiene un límite inferior de Wilson ≥ 98 %; un RUT que llegue después la corrige. unknown es un valor, no un hueco: un tercio del corpus no lleva ni
RUT ni sufijo societario, y el contrato lo dice en vez de deducirlo. taxId es null para extranjeros (por
definición, un RUT no existe) y en solicitudes antiguas donde INAPI no lo publicaba. Para el resto de campos
de la persona (territory, publishedName, jurisdictionClause, review…), consulta la referencia
https://api.tarno.cl/docs.
Relaciones entre partes
GET /parties/{id}/relations (herramienta MCP list_party_relations) responde en una llamada «¿con quién
comparte marcas esta parte, quién la representa, a quién cedió, quién se le opuso?». Devuelve aristas
tipadas, cada una sostenida por marcas del corpus:
type |
qué significa | fecha (firstOn/lastOn) |
coverageFrom |
|---|---|---|---|
co_holder |
las dos son titulares de la misma marca (un titular retirado por un cambio de nombre, por una transferencia o por la cesión de la solicitud en trámite no cuenta como cotitular anterior) | presentación de las marcas | null (todo el corpus) |
represents / represented_by |
esta parte representa marcas de la otra, o al revés | presentación de las marcas | null |
assigned_to / assigned_from |
cesión: un titular retirado por una transferencia de INAPI (A07T) frente al titular de la marca |
la del acto | 2011-08-01 |
opposed / opposed_by |
un oponente identificado en un acto sobre la marca frente a sus titulares | la del acto | 2024-04-19 |
Cada arista trae la otra parte (party: id, name, taxId, kind), trademarkCount, firstOn/lastOn,
hasta cinco marcas de evidence (las más recientes) con evidenceTruncated — la lista completa se pagina con
GET /parties/{id}/trademarks o la búsqueda de marcas —, y label en los tres idiomas. Se filtra por type
(lista) y por relation (current por defecto, former, all — el mismo vocabulario que
/parties/{id}/trademarks); se ordena por trademarkCount y se pagina con cursor.
curl -sS "https://api.tarno.cl/parties/1261017/relations?type=represented_by,opposed_by" \
-H "X-API-Key: $TARNO_API_KEY"
⚠ Cómo se leen:
- «No se opuso nunca» se lee «no desde el 2024-04-19»: las oposiciones sólo existen en el corpus desde el
primer Estado Diario propio (el del 2024-04-19). Y sólo cuentan los oponentes identificados: cuando el nombre impreso casa con
ninguna o con varias partes, no se inventa la contraparte; con
opposed_by,meta.unresolvedOpponentMentionsdice cuántas menciones quedaron sin identificar. - La contraparte de una oposición o de una cesión es el titular de la marca según
relation(por defecto, el de hoy), no el de la fecha del acto: el corpus no guarda desde cuándo figura cada titular. Con cesiones encadenadas, el titular de hoy no es necesariamente el cesionario de ese acto. - ⛔ Son señales con evidencia, nunca veredictos: no hay aristas de «mismo grupo empresarial» ni por parecido de nombre o de dirección. Una misma persona duplicada en el corpus puede aparecer partida en dos contrapartes.
Desenlaces y cambios de una parte
GET /parties/{id}/outcomes≡get_party_outcomes: cómo terminaron las marcas de la parte (representante por defecto, o titular), por grupo de estado publicado, conn,grantSharesobre las decididas (las pendientes fuera) y la definición entera. No es una «tasa de éxito»: ver desenlaces.POST /annotations/searchconpartyIdotaxId(ypartyRole,relation,dateFrom…): los actos de las marcas de la parte — «¿qué le pasó esta semana a las marcas de este RUT?». Ver anotaciones por parte.- En la búsqueda de marcas,
partyRolejunto ataxIdlimita el RUT a un papel (RUT).
Desde un agente de IA
list_parties(q: "carey", limit: 5)
list_parties(taxId: "12.345.678-5")
get_party(id: "1261017")
list_party_trademarks(id: "1261017")
list_party_relations(id: "1261017", type: ["represented_by", "opposed_by"])
La herramienta MCP devuelve el mismo sobre { results[], … } y es byte-idéntica a GET /parties.
Ver también
- Búsqueda por campos — las personas como filtro sobre marcas.
- Primeros pasos — sobre y paginación keyset.
- La referencia OpenAPI en vivo en
https://api.tarno.cl/docs.