Data model of the contract
This page describes what the API returns: the entities of the contract, their main fields and how they
relate. The field names are exactly those of the responses, in REST and in MCP (both transports return the
same shape). It is not the full list: the exhaustive, field-by-field and always-current schema lives in the
interactive OpenAPI reference at https://api.tarno.cl/docs. When a field
is not listed here, the reference is the authority.
Each section says what the entity is, its fields with type and meaning, and the operation of the reference
where you read it. A field whose value is not known comes as null or is omitted: it means "we do not know", never a
filled-in value.
How they relate
erDiagram
trademark ||--o{ annotation : "its history"
trademark }o--|{ niceClass : "protects in"
trademark }o--o{ party : "holders and representatives"
annotation }o--o{ party : "parties of the act"
annotation }o--o{ legalNorm : "cites"
party }o--o{ party : "relations"
guidanceDocument }o--o{ legalNorm : "interprets"
report }o--o{ trademark : "gathers"
watchedApplication }o--|| trademark : "watches"
watchedApplication ||--o{ similarityHit : "produces"
similarityHit }o--|| trademark : "the similar mark"
Trademark
A trademark application or registration before INAPI: the sign, who applies for it, for which classes and
where it stands in its procedure. You read it with GET /trademarks/{applicationNumber} (operation
getTrademark); the lists and the search (listTrademarks, searchTrademarks) return the same trademark in
summary form.
| field | type | meaning |
|---|---|---|
applicationNumber |
string | Application number: the key of the trademark across the whole contract. |
registrationNumber |
string | Registration number, when the trademark is registered. |
denomination |
string | The denomination of the sign, as INAPI publishes it. |
signType |
string | Sign type (code: "mixta", "denominativa"…). |
category |
enum | What is protected: marca, frase_propaganda, colectiva, denominacion_origen… |
scope |
enum | Goods, services or establishment. |
status |
string | Published status (code from the status catalog). |
statusInapi |
string | INAPI's literal status, only when it differs from status. |
filedOn |
date | Filing date. |
publishedOn |
date | Publication date of the application. |
registeredOn |
date | Registration date. |
expiresOn |
date | Expiry date of the registration. |
classes |
object[] | The Nice classes of the trademark: number, goodsAndServices and status of each. |
holders |
object[] | The current holders (each one a party). |
representatives |
object[] | The current representatives (also parties). |
annotations |
object[] | The annotations of the trademark. |
procedureHistory |
object[] | INAPI's e-file index: the steps of the procedure table and the numbered annotations, by date (and, within a day, by the flow of the procedure), with date, code, inapiText, reference (resolution or writ number) and annotationNumber (null on a step). |
renewals |
object[] | The renewal chain: each step with its date, code and kind (request, grant or outcome). |
lastRenewalOn |
date | The most recent granted renewal. |
renewalStatus |
enum | Where the renewal term stands today: not_due, window_open, grace, lapsed, renewed_expiry_pending. |
milestones |
object[] | The dated milestones (expiry, opposition close, renewal window opening…), each with its basis. |
oppositionWindow |
object | The opposition term: deadline, businessDaysLeft and its legalBasis. |
dataAsOf |
date-time | The data date of this response. |
coverageThrough |
date | How far the coverage of the corpus reaches. |
A computed or estimated milestone (basis: "derived" or "estimated") and the opposition term carry their
norm and article in legalBasis: a term without an article is not a term you can check. A milestone that is a
date INAPI published (basis: "source") carries no legalBasis: it says in field which field it comes from
(e.g. expiresOn). To search trademarks by field, see
Field-scoped search.
Annotation
An act INAPI publishes about an application in the Estado Diario: a resolution, an opposition, a transfer, a
renewal… The annotations of a trademark come in its annotations; a single one, with
GET /annotations/{id} (getAnnotation); all of a trademark's, with listTrademarkAnnotations; and the
full-text search, with searchAnnotations.
| field | type | meaning |
|---|---|---|
id |
string | Identifier of the annotation. |
applicationNumber |
string | The trademark it belongs to. |
date |
date | The date of the act, according to INAPI. |
section |
string | INAPI's section code (e.g. M11). |
sectionName |
string | The name of the section, as INAPI writes it. |
sectionLabel |
object | That name in es-CL, en and pt-BR. |
act |
string | The code of the specific act the annotation names, when it is identified. |
actStatus |
enum | What act means: identified, unidentified ("we do not know") or not_applicable. |
observation |
string | The text of the annotation, verbatim. |
parties |
object[] | The parties the act names: role, name and, if identified, partyId. |
citations |
object[] | With expand=citations: the norms it cites, with legalNormId, article, letter and the text that applied that day. |
detectedAt |
date-time | When the service learned of the act (not when INAPI published it: that is date). |
To interpret a section code, GET /sections/{code} (getSection) gives you its meaning.
Party
A natural or legal person that appears as holder, representative or opponent on a trademark. You read it
with GET /parties/{id} (getParty); its trademarks, with listPartyTrademarks; its relations with other
parties, with listPartyRelations. See People search.
| field | type | meaning |
|---|---|---|
id |
string | Identifier of the party (used by the party filter of the search). |
name |
string | The name, as it appears in the applications. |
kind |
enum | natural, legal or unknown. |
taxId |
string | The RUT (body-DV) when known. A natural person's may come masked. |
country |
string | Country of the party. |
territory |
object | Commune and region declared in the application (communeName, regionName). |
trademarkCount |
integer | How many trademarks it has. |
mergedInto |
string | If the party was merged into another, the id of the one that holds its trademarks today. |
sii |
object | What the SII says about a legal entity with a Chilean RUT (legalName, activityStartedOn…), with its own asOf date. |
In the relations (listPartyRelations), each entry gives the type (co_holder, represents,
represented_by, assigned_to, assigned_from, opposed, opposed_by), the other party, the
trademarkCount that proves it and the dates firstOn and lastOn.
Nice class
One of the 45 classes of the Nice Classification in which a trademark protects goods or services. The
catalog, with GET /nice-classes (listNiceClasses); the statistics of a class, with getClassStats.
| field | type | meaning |
|---|---|---|
number |
integer | The class number, from 1 to 45. |
title |
object | The class heading in the three languages. |
goodsAndServices |
string | On a trademark, the text of the goods and services it protects in that class. |
Norm and Guideline
The documentary base: the laws and regulations INAPI's acts cite, and the documents with which INAPI interprets them (Guidelines, circulars, manuals). See Documentary base.
A norm is read with GET /legal-norms/{id} (getLegalNorm) and an article, with its text in force on a
date, with getLegalNormArticle; the search in the text of the laws is searchStatutes.
| field | type | meaning |
|---|---|---|
id |
string | Identifier of the norm in the catalog. |
kind |
string | ley or reglamento. |
name |
string | The official title. |
articles |
object[] | Its articles (article, letter). |
body |
string | On an article: its literal text. |
asOf |
date | On an article: the date the text was chosen for. |
A document (Guideline, circular…) is read with GET /guidance/documents/{code}
(getGuidanceDocument); a section, with getGuidanceSection.
| field | type | meaning |
|---|---|---|
code |
string | The stable code of the document (guideline-35). |
title |
string | The title INAPI gives it. |
version |
object | The version served, with its seq and since when it is seen published (firstSeenAt). |
outline |
object[] | Its sections in order (path, heading), without the text. |
sourceUrl |
string | Where INAPI publishes it. |
Report
A composite response that gathers trademarks, parties and norms for a specific question. It gives signals, not verdicts: it says what it found and how similar, never whether a trademark is registrable or infringes. See Reports & oppositions.
| report | operation | what it answers |
|---|---|---|
| Clearance | getClearanceReport |
Which trademarks are similar to a text in some classes (similar), with the holders with most trademarks in those classes and the norms cited in the acts of the similar ones. |
| Conflict landscape | getConflictLandscape |
Which holders and representatives are behind the live similar trademarks. |
| Portfolio | getPortfolioReport |
A party's trademarks, by status, class and renewal term, with their upcoming milestones. |
| Opposition brief | getOppositionBrief |
The facts to oppose an application: the trademark, its similarity to yours, its holders and the norms cited in the oppositions they received. |
Main fields, with the report that carries them:
| field | type | meaning |
|---|---|---|
similar |
object[] | Clearance: the similar trademarks, grouped by similarity channel. |
dominantHolders |
object[] | Clearance: the holders with most trademarks in the requested classes. |
holders |
object[] or object | Conflict landscape: the list of holders of the live similar trademarks. Opposition brief: an object with the holders of the trademark you oppose (parties). |
representatives |
object[] | Conflict landscape: the representatives of the live similar trademarks. |
method |
object | Conflict landscape: how it was built, with the threshold and what was left out. |
party |
object | Portfolio: the party the portfolio belongs to. |
byStatus |
object[] | Portfolio: how many trademarks the party has in each status. |
trademark |
object | Opposition brief: the trademark you oppose. |
citedNorms |
object[] | Clearance and opposition brief: the norms cited in the related acts, with article and letter. |
coverageFrom |
date | Opposition brief: since when the corpus holds oppositions. |
dataAsOf |
date-time | All: the data date of the report. |
Watch
An application your organisation watches, and the similar trademarks the service finds for it. You watch
with POST /watch/applications (watchApplication), list the watched ones with listWatchedApplications
and the similar ones with GET /watch/hits (listSimilarityHits). See Similarity watch.
Watched application:
| field | type | meaning |
|---|---|---|
applicationNumber |
string | The application you watch. |
watchedSince |
date-time | Since when you watch it. |
baselineStatus |
enum | The initial search for similar marks: pending or done. |
terminalSince |
date-time | Since when the application is in a terminal status; null while it is live. |
watchEndsOn |
date | The last day of watch of a terminal application, with its reason in watchEndBasis. |
Similarity hit:
| field | type | meaning |
|---|---|---|
id |
number | Identifier of the hit while it stays open (it is not the order of the list). |
watchedApplicationNumber |
string | Your watched application. |
matchedApplicationNumber |
string | The similar application. |
score |
number | The similarity, from 0 to 1. It can be null only in a series notice (relation: "series", an additional series of the same Madrid registration) that the similarity engine did not score. |
signals |
object | What the similarity saw: the channels that match (matchedBy) and the strength of each (lexical, semantic, phonetic). |
origin |
enum | Who detected it first: baseline (the initial search), sync (the daily review) or series_load (a load of Madrid series). |
detectedAt |
date-time | When it was detected (it may predate your subscription: the watch is global). |
visibleSince |
date-time | Since when your organisation can read it; it is the order of the list. |
matched |
object | The similar trademark, in summary form and with its status of today; null if the application no longer exists. |
The data date
Every response carries its date: dataAsOf (how current the data is) and coverageThrough (how far the
coverage reaches); in collections, inside meta, and in single objects that do not carry it in the body, in
the response headers. Sources with their own pace (the SII for a party, the text of a law, an INAPI
document) also bring their own date (asOf, dataAsOf).
Always show it to whoever reads the data. Yesterday's corpus presented as today's is false data that looks like data. See Historical coverage and Status.