Buscar marcas
POST /co/sic-ip/trademarks-search/v1 Dataset
Cada caso de marca del registro, buscable por signo y titular.
as_of (qué tan al día está la copia), los filtros aplicados, total y total_is_exact, page, per_page, total_pages, count y results[], de la radicación más reciente a la más antigua. Cada marca incluye file_number (el expediente), certificate_number (una vez registrada), sign (la denominación; null en una marca solo figurativa), status como lo redacta el registro (Publicada, Registrada, Negada, Caducado…), filing_date, expires_on (la vigencia), owners[] (los titulares, o los solicitantes mientras está en trámite), nice_classes[], gazette_number y la etiqueta: label_url (la copia de Croma, byte a byte) y source_label_url (el enlace del propio registro).
Buscar patentes
POST /co/sic-ip/patents-search/v1 Dataset
Cada caso de patente del registro, buscable por título y titular.
as_of (qué tan al día está la copia), los filtros aplicados, total y total_is_exact, page, per_page, total_pages, count y results[], de la radicación más reciente a la más antigua. Cada caso incluye file_number, certificate_number (la concesión, una vez concedida), title, status como lo redacta el registro, filing_date, expires_on, owners[] y la figura característica: figure_url (la copia de Croma) y source_figure_url.
Buscar diseños industriales
POST /co/sic-ip/designs-search/v1 Dataset
Cada caso de diseño industrial del registro, buscable por título y titular.
as_of (qué tan al día está la copia), los filtros aplicados, total y total_is_exact, page, per_page, total_pages, count y results[], de la radicación más reciente a la más antigua. Cada caso incluye file_number, certificate_number (la concesión, una vez concedida), title, status como lo redacta el registro, filing_date, expires_on, owners[] y la figura característica: figure_url (la copia de Croma) y source_figure_url.
Buscar resoluciones y oficios
POST /co/sic-ip/resolutions-search/v1 Dataset
Cada decisión y requerimiento que envía la delegatura, día a día, con el documento mismo.
as_of, los filtros aplicados, los campos de paginación y results[], del envío más reciente al más antiguo. Cada documento incluye document_id, kind, resolution_number, title (el tipo, p. ej. TM179 - Acepta Cancelación), template_code (TM179), act_date, sent_date, file_number, main_file_number, parties[] (name, notified_on, enforced_on), notified_on, enforced_on, document_url (la copia de Croma del PDF), source_document_url y bytes.
Una marca
POST /co/sic-ip/trademark/v1 Lookup
Un caso de marca tal como lo tiene hoy el registro, con cada documento del expediente.
Responde desde la copia de Croma cuando tiene una respuesta reciente para la llave; si no, lee la fuente y guarda la respuesta. Cada respuesta dice cuándo se consultó la fuente por última vez (
checked_at) y de dónde salió la respuesta (served_from).found, file_number, checked_at (cuándo se consultó el registro por última vez), served_from (copy dentro del día siguiente a la última lectura, upstream cuando se leyó el registro para esta solicitud, stale cuando no se pudo leer y respondió la última respuesta guardada) y trademark. El caso incluye file_number, kind, procedure_type, status, title (el signo o el título), sign_type y sign_nature (marcas), las fechas filing_date, submitted_on, publication_ordered_on, published_on, registered_on y expires_on, gazette_number, certificate_number, classes[] (cada clase de Niza con sus productos y servicios) y nice_classes[], locarno[] (diseños), patent_type, technology_sector, technology_subsector y abstract (patentes), design_type (diseños), parties[] (role: owner, applicant, agent, contact, inventor o designer, con document_number, name y address como los registra el registro), images[] (la etiqueta o las figuras), specification[] (la descripción, reivindicaciones y dibujos públicos de una patente), history[] (cada actuación, de la más reciente a la más antigua, con la entrada de la gaceta), linked_procedures[] (oposiciones, transferencias, licencias, cambios de nombre, correcciones), documents[] (cada documento del expediente: resoluciones, oficios, escritos, certificados, con resolution_number, las fechas y las partes notificadas), documents_total, documents_kept y fields[] (cada campo rotulado del caso tal como lo imprime el registro). Cada archivo trae document_url (la copia de Croma, byte a byte) y source_document_url (el enlace del propio registro).
Leer un caso guarda una copia de cada documento del expediente, lo que puede tardar uno o dos minutos en un expediente con muchos documentos. Es un trabajo asíncrono: por defecto la solicitud espera en línea y devuelve
{ data }, o puedes consultar GET /jobs/{id} o enviar un callback_url. Un caso leído en el último día responde de inmediato desde la copia de Croma. Un número sin caso de este tipo devuelve found: false con HTTP 200, no un error.Una patente
POST /co/sic-ip/patent/v1 Lookup
Un caso de patente tal como lo tiene hoy el registro, con cada documento del expediente.
Responde desde la copia de Croma cuando tiene una respuesta reciente para la llave; si no, lee la fuente y guarda la respuesta. Cada respuesta dice cuándo se consultó la fuente por última vez (
checked_at) y de dónde salió la respuesta (served_from).found, file_number, checked_at (cuándo se consultó el registro por última vez), served_from (copy dentro del día siguiente a la última lectura, upstream cuando se leyó el registro para esta solicitud, stale cuando no se pudo leer y respondió la última respuesta guardada) y patent. El caso incluye file_number, kind, procedure_type, status, title (el signo o el título), sign_type y sign_nature (marcas), las fechas filing_date, submitted_on, publication_ordered_on, published_on, registered_on y expires_on, gazette_number, certificate_number, classes[] (cada clase de Niza con sus productos y servicios) y nice_classes[], locarno[] (diseños), patent_type, technology_sector, technology_subsector y abstract (patentes), design_type (diseños), parties[] (role: owner, applicant, agent, contact, inventor o designer, con document_number, name y address como los registra el registro), images[] (la etiqueta o las figuras), specification[] (la descripción, reivindicaciones y dibujos públicos de una patente), history[] (cada actuación, de la más reciente a la más antigua, con la entrada de la gaceta), linked_procedures[] (oposiciones, transferencias, licencias, cambios de nombre, correcciones), documents[] (cada documento del expediente: resoluciones, oficios, escritos, certificados, con resolution_number, las fechas y las partes notificadas), documents_total, documents_kept y fields[] (cada campo rotulado del caso tal como lo imprime el registro). Cada archivo trae document_url (la copia de Croma, byte a byte) y source_document_url (el enlace del propio registro).
Leer un caso guarda una copia de cada documento del expediente, lo que puede tardar uno o dos minutos en un expediente con muchos documentos. Es un trabajo asíncrono: por defecto la solicitud espera en línea y devuelve
{ data }, o puedes consultar GET /jobs/{id} o enviar un callback_url. Un caso leído en el último día responde de inmediato desde la copia de Croma. Un número sin caso de este tipo devuelve found: false con HTTP 200, no un error.Un diseño industrial
POST /co/sic-ip/design/v1 Lookup
Un caso de diseño industrial tal como lo tiene hoy el registro, con cada documento del expediente.
Responde desde la copia de Croma cuando tiene una respuesta reciente para la llave; si no, lee la fuente y guarda la respuesta. Cada respuesta dice cuándo se consultó la fuente por última vez (
checked_at) y de dónde salió la respuesta (served_from).found, file_number, checked_at (cuándo se consultó el registro por última vez), served_from (copy dentro del día siguiente a la última lectura, upstream cuando se leyó el registro para esta solicitud, stale cuando no se pudo leer y respondió la última respuesta guardada) y design. El caso incluye file_number, kind, procedure_type, status, title (el signo o el título), sign_type y sign_nature (marcas), las fechas filing_date, submitted_on, publication_ordered_on, published_on, registered_on y expires_on, gazette_number, certificate_number, classes[] (cada clase de Niza con sus productos y servicios) y nice_classes[], locarno[] (diseños), patent_type, technology_sector, technology_subsector y abstract (patentes), design_type (diseños), parties[] (role: owner, applicant, agent, contact, inventor o designer, con document_number, name y address como los registra el registro), images[] (la etiqueta o las figuras), specification[] (la descripción, reivindicaciones y dibujos públicos de una patente), history[] (cada actuación, de la más reciente a la más antigua, con la entrada de la gaceta), linked_procedures[] (oposiciones, transferencias, licencias, cambios de nombre, correcciones), documents[] (cada documento del expediente: resoluciones, oficios, escritos, certificados, con resolution_number, las fechas y las partes notificadas), documents_total, documents_kept y fields[] (cada campo rotulado del caso tal como lo imprime el registro). Cada archivo trae document_url (la copia de Croma, byte a byte) y source_document_url (el enlace del propio registro).
Leer un caso guarda una copia de cada documento del expediente, lo que puede tardar uno o dos minutos en un expediente con muchos documentos. Es un trabajo asíncrono: por defecto la solicitud espera en línea y devuelve
{ data }, o puedes consultar GET /jobs/{id} o enviar un callback_url. Un caso leído en el último día responde de inmediato desde la copia de Croma. Un número sin caso de este tipo devuelve found: false con HTTP 200, no un error.Marcas por titular
POST /co/sic-ip/trademarks-by-owner/v1 Cada caso de marca del que una empresa o persona es titular o solicitante, desde el registro.
document_number, found, parties[] (los registros de parte del registro que coincidieron con el número, cada uno con document_number y name), total, checked_at y trademarks[], de la radicación más reciente a la más antigua, cada uno con la forma de un resultado de la búsqueda de marcas (label_url es la copia de Croma cuando el dataset de marcas ya tiene el caso).
Un portafolio grande se lee en varias pasadas y puede tardar hasta un minuto. Es un trabajo asíncrono: por defecto la solicitud espera en línea y devuelve
{ data }, o puedes consultar GET /jobs/{id} o enviar un callback_url.Referencia completa
Esquemas, todos los campos de respuesta y un playground interactivo.