Gov APIonapi.gov.do ↗
Search and retrieve trademarks, patents, expedient status, and institutional news from ONAPI, the Dominican Republic's industrial property office. 7 endpoints.
What is the Gov API?
The ONAPI API provides access to 7 endpoints covering trademark registrations, patent applications, and expedient event histories from the Dominican Republic's National Industrial Property Office. Use search_trademarks to query by name, Nice Classification class, or sign type, and get_trademark_detail to retrieve holder information, agent details, associated images, and classified product lists for any individual registration.
curl -X GET 'https://api.parse.bot/scraper/a990b741-b940-407a-a66c-585eecf43366/search_trademarks?query=COCA+COLA' \ -H 'X-API-Key: $PARSE_API_KEY'
Typed, relational, agent-ready
A generated client with real types, enums, and the links between objects — the structure a flat JSON response can't carry. Autocompletes in your editor and reads cleanly to coding agents.
- Fully typed · autocompletes
- Objects link to objects
- Typed errors & pagination
Typed Python client. Set up the SDK in your uv project, then pull this API’s typed client:
uv add parse-sdk uv run parse init uv run parse add --marketplace onapi-gov-do-api
uv run parse add --marketplace pulls a pinned snapshot of this canonical API — it won’t change underneath you. To customize it, subscribe and swap to your own copy.
"""ONAPI Dominican Republic IP Registry — search trademarks, patents, and news."""
from parse_apis.onapi_dominican_republic_ip_registry_api import (
Onapi, SignType_, PatentType, ExpedientNotFound
)
client = Onapi()
# Search trademarks by name, filtering to Marca type
for tm in client.trademarks.search(query="COCA COLA", type=SignType_.MARCA, limit=3):
print(tm.texto, tm.status, tm.certificado)
# Search patents by title keyword
patent = client.patents.search(title="solar", limit=1).first()
if patent:
print(patent.titulo, patent.titulares, patent.status)
# Look up expedient status and event history
try:
events = client.expedientstatuses.lookup(serie="2003", numero="5808", limit=3)
for ev in events:
print(ev.codigo_evento, ev.fecha_hora, ev.descripcion)
except ExpedientNotFound as exc:
print(f"Expedient not found: {exc}")
# List latest ONAPI news articles
for article in client.newsarticles.list(limit=3):
print(article.title, article.link)
# List available sign types and their subtypes
for st in client.signtypes.list(limit=5):
print(st.id, st.nombre)
print("exercised: trademarks.search / patents.search / expedientstatuses.lookup / newsarticles.list / signtypes.list")
Search for trademarks (signos distintivos) by text query, type, and Nice Classification classes. Returns a list of matching trademark records with registration details including expedient series/number, certificate number, status, and expiration date. All parameters are optional; omitting all returns an unfiltered result set.
| Param | Type | Description |
|---|---|---|
| type | string | Sign type filter. |
| query | string | Search text (name of the trademark, e.g. 'COCA COLA'). |
| classes | string | Nice Classification class filters, comma-separated (e.g. '32' or '1,2,3'). |
| subtype | string | Subtype filter (e.g. 'PS' for Marca de Fabrica, 'CO' for Colectiva, 'CE' for Certificación). Values depend on selected type; retrieve via get_sign_types. |
{
"type": "object",
"fields": {
"total": "integer total number of results",
"results": "array of trademark objects with fields: serieExpediente, numeroExpediente, certificado, tipo, subTipo, texto, clases, status, vencimiento, domicilio"
},
"sample": {
"data": {
"total": 12,
"results": [
{
"id": 0,
"tipo": "MA",
"texto": "COCA COLA",
"clases": " 32 ",
"gestor": " ",
"status": "Registrada",
"subTipo": "PS",
"titular": null,
"imagenes": [],
"domicilio": "ONE COCA COLA PLAZA, P.O.BOX 1734",
"enTramite": false,
"tipoSigno": "M",
"expedicion": "2003-04-30T00:00:00",
"certificado": "134941",
"listaClases": [],
"vencimiento": "2033-04-30T00:00:00",
"serieExpediente": 2003,
"numeroExpediente": 5808,
"aplicadoAProteger": "32-TODOS LOS PRODUCTOS DE ESTA CLASE..."
}
]
},
"status": "success"
}
}About the Gov API
Trademark Search and Detail
The search_trademarks endpoint accepts a free-text query, one or more classes (Nice Classification codes, comma-separated), a type filter (e.g. DO for Denominación de Origen, IG for Indicación Geográfica, LE for Lema Comercial), and a subtype such as PS (Marca de Fábrica) or CO (Colectiva). Results include serieExpediente, numeroExpediente, certificado, tipo, subTipo, texto, clases, status, and vencimiento fields. The serie and numero values from those results feed directly into get_trademark_detail, which returns the holder name (titular), agent (gestor), domicile address, image URLs, and the full listaClases array with product descriptions.
Patent Search
The search_patents endpoint supports eight independent filter parameters: title, summary, inventor, applicant, solicitud, reg_num, cip (International Patent Classification code, e.g. H02S), and type (P for Patente, U for Modelo de Utilidad, S for Diseño Industrial). Results carry titulo, titulares, inventores, cip, status, fechaPresentacion, fechaPublicacion, and expedient identifiers. Filters can be combined freely — searching by both inventor and cip is valid.
Expedient Status and Event History
get_expedient_status takes the same serie and numero identifiers used in the trademark and patent endpoints and returns two objects: the full expediente detail block and an eventos array. Each event carries codigoEvento, fechaHora, and descripcion, giving a chronological audit trail of every procedural step logged against that application.
Reference Data and News
get_sign_types returns all valid sign types and their nested subTipos (each with tipoId, id, and nombre), which is useful for building filter UIs or validating input before calling search_trademarks. get_countries returns country codes and names available in the ONAPI system. get_news_articles retrieves the latest institutional announcements with title, link, and date fields — no query parameters required.
The Gov API is a managed, monitored endpoint for onapi.gov.do — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when onapi.gov.do changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official onapi.gov.do API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- Monitor the registration status and event history of a trademark application by polling get_expedient_status with its serie and numero.
- Screen a proposed brand name against existing Dominican Republic trademarks using search_trademarks with a text query and specific Nice Classification classes.
- Identify all patents filed by a particular inventor or applicant in the Dominican Republic via search_patents with the inventor or applicant parameter.
- Build a trademark classification reference tool using the type codes and subTipos returned by get_sign_types.
- Retrieve full holder, agent, and product-class details for a known trademark registration using get_trademark_detail.
- Track ONAPI institutional announcements and policy updates via get_news_articles for compliance monitoring.
- Search industrial design registrations by filtering search_patents with type set to 'S' and a relevant CIP code.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does ONAPI provide an official public developer API?+
How do I filter trademarks by both product category and sign type at the same time?+
classes parameter (comma-separated Nice Classification codes, e.g. '32,33') and the type parameter (e.g. 'MA' for Marca) to search_trademarks in the same request. Both filters apply together, and the response total field reflects the combined result count. Use get_sign_types first if you need to enumerate valid type and subtype codes.Does the API return the full patent specification text or claims?+
Is coverage limited to Dominican Republic registrations?+
What does the eventos array in get_expedient_status actually contain?+
eventos array has three fields: codigoEvento (a code identifying the procedural action), fechaHora (the timestamp of that action), and descripcion (a plain-text description of the event). Events are ordered chronologically, covering the full procedural history of the trademark or patent expedient from initial filing through current status.