Skip to content

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.

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.