---
title: "Tmch claims list"
url: "https://help.internetx.com/en/api/core-tmch-claims-list/"
lang: "en"
section: "API reference — API reference (XML/JSON)"
breadcrumb: "API documentation (JSON/XML) > Tasks > Tmch tasks"
updated: "2023-09-18"
---

# Tmch claims list

## Function

The _TmchClaimsList_ task inquires TMCH Claims Notices.  

Further information about list inquiries you can find [here](/en/api/core-list-inquire/).

## Description

Route: POST /tmchMark/claim/\_search  

**Query parameter**

The following keywords are returned by default:

-   created
-   email
-   expire
-   id
-   idn
-   message\_sent
-   name
-   owner
-   ownerc
-   status
-   updated

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

-   data
-   comment

```
{
  "filters": [
    {
      "key": "name",
      "value": "example*",
      "operator": "LIKE"
    }
  ],
  "view": {
    "children": 1,
    "limit": 10
  },
  "orders":[
    {
      "key": "name",
      "type": "ASC"
    }
  ]
}
```

```
{
    "stid": "20220823-app2-dev-8121",
    "status": {
        "code": "S011545",
        "text": "Trademark Claims Notices have been inquired successfully.",
        "type": "SUCCESS"
    },
    "object": {
        "type": "TmchClaimsNotice",
        "summary": 4
    },
    "data": [
        {
            "created": "2021-06-21T15:17:40.000+0200",
            "updated": "2021-06-28T14:07:24.000+0200",
            "owner": {
                "context": 4,
                "user": "customer"
            },
            "name": "example.hamburg",
            "ownerc": {
                "id": 17705037
            },
            "messageSent": "2021-06-27T15:18:07.000+0200",
            "email": "example@example.com",
            "status": "PENDING",
            "tmchClaimsNoticeMails": [],
            "expire": "2051-07-06T15:17:40.000+0200"
        },
        {
            "created": "2021-06-21T15:17:40.000+0200",
            "updated": "2021-06-28T14:07:24.000+0200",
            "owner": {
                "context": 4,
                "user": "customer"
            },
            "name": "example.hamburg",
            "ownerc": {
                "id": 17705037
            },
            "messageSent": "2021-06-27T15:18:07.000+0200",
            "email": "example@example.com",
            "status": "PENDING",
            "tmchClaimsNoticeMails": [],
            "expire": "2051-07-06T15:17:40.000+0200"
        }
    ]
}
```

Task code: 011545  
Uses  tmch\_claim object  

**Keywords**

The following keywords are returned by default:

-   created
-   email
-   expire
-   id
-   idn
-   message\_sent
-   name
-   owner
-   ownerc
-   status
-   updatedll

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

-   data
-   comment

```
<request>
	<auth>
		<user>customer</user>
		<context>4</context>
		<password>password</password>
	</auth>
	<task>
		<code>011545</code>
		<where>
			<key>name</key>
			<operator>LIKE</operator>
			<value>e*</value>
		</where>
		<key>comment</key>

	</task>
</request>
```

```
<response>
	<result>
		<data>
			<summary>3</summary>
			<tmch_claim>
				<name>example.hamburg</name>
				<ownerc>17705037</ownerc>
				<message_sent>2021-06-27 15:18:07</message_sent>
				<email>example@example.com</email>
				<status>PENDING</status>
				<expire>2051-07-06 15:17:40</expire>
				<owner>
					<user>customer</user>
					<context>4</context>
				</owner>
				<id>741</id>
				<created>2021-06-21 15:17:40</created>
				<updated>2021-06-28 14:07:24</updated>
			</tmch_claim>
			<tmch_claim>
				<name>example.hamburg</name>
				<ownerc>17705037</ownerc>
				<message_sent>2021-06-27 15:18:07</message_sent>
				<email>example@example.com</email>
				<status>PENDING</status>
				<expire>2051-07-06 15:17:40</expire>
				<owner>
					<user>customer</user>
					<context>4</context>
				</owner>
				<id>743</id>
				<created>2021-06-21 15:17:40</created>
				<updated>2021-06-28 14:07:24</updated>
			</tmch_claim>
			<tmch_claim>
				<name>example.hamburg</name>
				<ownerc>17705037</ownerc>
				<message_sent>2021-06-27 15:18:07</message_sent>
				<email>example@example.com</email>
				<status>PENDING</status>
				<expire>2051-07-06 15:17:40</expire>
				<owner>
					<user>customer</user>
					<context>4</context>
				</owner>
				<id>744</id>
				<created>2021-06-21 15:17:40</created>
				<updated>2021-06-28 14:07:24</updated>
			</tmch_claim>
		</data>
		<status>
			<code>S011545</code>
			<text>Trademark Claims Notices have been inquired successfully.</text>
			<type>success</type>
		</status>
	</result>
	<stid>20211125-app2-dev-85099</stid>
</response>
```