Help Center
Login Sign up
  1. Home
  2. API reference
  3. API documentation (JSON/XML)
  4. Tasks
  5. Tmch tasks

Tmch mark list

API reference (XML/JSON) · Updated 2023-09-18

Function

The TmchMarkList task  generates a list of registered TMCH trademarks. 

You can find more information about list queries here.

Description

Route: POST /tmchMark/_search

Search parameter

The following keywords are returned by default:

  • type
  • name
  • reference
  • holder
  • status
  • payable
  • sent
  • smdInclusion
  • claimsNotify
  • orderComplete
  • claimsNotifyExtended
  • created
  • updated
  • holder.name
  • holder.entitlement
  • holder.email

The data of the following keywords can be inquired with the keyword <key>:

  • description
  • period
  • renew
  • smdFile
  • holder.organization
  • holder.street
  • holder.city
  • holder.postalCode
  • holder.state
  • holder.country
{
    "filters": [
        {
            "key": "name",
            "operator": "LIKE",
            "value": "Example*"
        }
    ],
    "view": {
        "children": 1,
        "limit": 2
    },
    "orders": [
        {
            "key": "created",
            "type": "ASC"
        }
    ]
}
{
    "stid": "20220915-app2-dev-8347",
    "status": {
        "code": "S011445",
        "text": "TMCH mark data was inquired successfully.",
        "type": "SUCCESS"
    },
    "object": {
        "type": "TmchMark",
        "summary": 14
    },
    "data": [
        {
            "created": "2011-08-16T11:00:00.000+0200",
            "updated": "2020-03-18T12:25:27.000+0100",
            "type": "TRADEMARK",
            "name": "Example Mark",
            "reference": "105414-1",
            "holder": {
                "entitlement": "OWNER",
                "name": "Example Inc.",
                "email": ""
            },
            "status": "EXTERNAL",
            "payable": "2015-08-16T11:00:00.000+0200",
            "smdInclusion": true
        },
        {
            "created": "2011-08-16T11:00:00.000+0200",
            "updated": "2020-11-11T13:57:56.000+0100",
            "type": "TRADEMARK",
            "name": "Example Mark",
            "reference": "105507-1",
            "holder": {
                "entitlement": "OWNER",
                "name": "Example Inc.",
                "email": "md@internetx.com"
            },
            "status": "EXTERNAL",
            "payable": "2025-08-16T11:00:00.000+0200",
            "smdInclusion": true,
            "claimsNotify": false,
            "orderComplete": false
        }
    ]
}