---
title: V2
---

[Skip to content](#_top)

[API Reference](https://developers.cloudflare.com/api/python)

[Brand Protection](https://developers.cloudflare.com/api/python/resources/brand_protection)

Copy Markdown

Open in **Claude**Open in **ChatGPT**Open in **Cursor**

---

**Copy Markdown****View as Markdown**

# V2

#### V2Queries

##### [Get queries](https://developers.cloudflare.com/api/python/resources/brand_protection/subresources/v2/subresources/queries/methods/get)

brand\_protection.v2.queries.get(QueryGetParams\*\*kwargs) -> [QueryGetResponse](<https://developers.cloudflare.com/api/python/resources/brand_protection#(resource)%20brand_protection.v2.queries%20%3E%20(model)%20query_get_response%20%3E%20(schema)>)

GET/accounts/{account\_id}/cloudforce-one/v2/brand-protection/domain/queries

##### ModelsExpand Collapse

<details>

<summary>

<a href="https://developers.cloudflare.com/api/python/resources/brand_protection#(resource)%20brand_protection.v2.queries%20%3E%20(model)%20query_get_response%20%3E%20(schema)">QueryGetResponse</a>

</summary>

One of the following:

<details>

<summary>

List\[UnionMember0]

</summary>

created: str

<a href="#(resource)%20brand_protection.v2.queries%20%3E%20(model)%20query_get_response%20%3E%20(schema)%20%3E%20(variant)%200%20%3E%20(items)%20%3E%20(property)%20created">Link to this property</a>

<details>

<summary>

parameters: Optional\[UnionMember0Parameters]

</summary>

<details>

<summary>

string\_matches: List\[UnionMember0ParametersStringMatch]

</summary>

pattern: str

maxLength200

minLength1

<a href="#(resource)%20brand_protection.v2.queries%20%3E%20(model)%20query_get_response%20%3E%20(schema)%20%3E%20(variant)%200%20%3E%20(items)%20%3E%20(property)%20parameters%20%3E%20(property)%20string_matches%20%3E%20(items)%20%3E%20(property)%20pattern">Link to this property</a>

</details>

<a href="#(resource)%20brand_protection.v2.queries%20%3E%20(model)%20query_get_response%20%3E%20(schema)%20%3E%20(variant)%200%20%3E%20(items)%20%3E%20(property)%20parameters%20%3E%20(property)%20string_matches">Link to this property</a>

max\_time: Optional\[str]

<a href="#(resource)%20brand_protection.v2.queries%20%3E%20(model)%20query_get_response%20%3E%20(schema)%20%3E%20(variant)%200%20%3E%20(items)%20%3E%20(property)%20parameters%20%3E%20(property)%20max_time">Link to this property</a>

min\_time: Optional\[str]

<a href="#(resource)%20brand_protection.v2.queries%20%3E%20(model)%20query_get_response%20%3E%20(schema)%20%3E%20(variant)%200%20%3E%20(items)%20%3E%20(property)%20parameters%20%3E%20(property)%20min_time">Link to this property</a>

</details>

<a href="#(resource)%20brand_protection.v2.queries%20%3E%20(model)%20query_get_response%20%3E%20(schema)%20%3E%20(variant)%200%20%3E%20(items)%20%3E%20(property)%20parameters">Link to this property</a>

query\_id: int

<a href="#(resource)%20brand_protection.v2.queries%20%3E%20(model)%20query_get_response%20%3E%20(schema)%20%3E%20(variant)%200%20%3E%20(items)%20%3E%20(property)%20query_id">Link to this property</a>

query\_tag: str

<a href="#(resource)%20brand_protection.v2.queries%20%3E%20(model)%20query_get_response%20%3E%20(schema)%20%3E%20(variant)%200%20%3E%20(items)%20%3E%20(property)%20query_tag">Link to this property</a>

scan: bool

<a href="#(resource)%20brand_protection.v2.queries%20%3E%20(model)%20query_get_response%20%3E%20(schema)%20%3E%20(variant)%200%20%3E%20(items)%20%3E%20(property)%20scan">Link to this property</a>

updated: str

<a href="#(resource)%20brand_protection.v2.queries%20%3E%20(model)%20query_get_response%20%3E%20(schema)%20%3E%20(variant)%200%20%3E%20(items)%20%3E%20(property)%20updated">Link to this property</a>

</details>

<a href="#(resource)%20brand_protection.v2.queries%20%3E%20(model)%20query_get_response%20%3E%20(schema)%20%3E%20(variant)%200">Link to this property</a>

<details>

<summary>

class UnionMember1: …

</summary>

created: str

<a href="#(resource)%20brand_protection.v2.queries%20%3E%20(model)%20query_get_response%20%3E%20(schema)%20%3E%20(variant)%201%20%3E%20(property)%20created">Link to this property</a>

<details>

<summary>

parameters: Optional\[UnionMember1Parameters]

</summary>

<details>

<summary>

string\_matches: List\[UnionMember1ParametersStringMatch]

</summary>

pattern: str

maxLength200

minLength1

<a href="#(resource)%20brand_protection.v2.queries%20%3E%20(model)%20query_get_response%20%3E%20(schema)%20%3E%20(variant)%201%20%3E%20(property)%20parameters%20%3E%20(property)%20string_matches%20%3E%20(items)%20%3E%20(property)%20pattern">Link to this property</a>

</details>

<a href="#(resource)%20brand_protection.v2.queries%20%3E%20(model)%20query_get_response%20%3E%20(schema)%20%3E%20(variant)%201%20%3E%20(property)%20parameters%20%3E%20(property)%20string_matches">Link to this property</a>

max\_time: Optional\[str]

<a href="#(resource)%20brand_protection.v2.queries%20%3E%20(model)%20query_get_response%20%3E%20(schema)%20%3E%20(variant)%201%20%3E%20(property)%20parameters%20%3E%20(property)%20max_time">Link to this property</a>

min\_time: Optional\[str]

<a href="#(resource)%20brand_protection.v2.queries%20%3E%20(model)%20query_get_response%20%3E%20(schema)%20%3E%20(variant)%201%20%3E%20(property)%20parameters%20%3E%20(property)%20min_time">Link to this property</a>

</details>

<a href="#(resource)%20brand_protection.v2.queries%20%3E%20(model)%20query_get_response%20%3E%20(schema)%20%3E%20(variant)%201%20%3E%20(property)%20parameters">Link to this property</a>

query\_id: int

<a href="#(resource)%20brand_protection.v2.queries%20%3E%20(model)%20query_get_response%20%3E%20(schema)%20%3E%20(variant)%201%20%3E%20(property)%20query_id">Link to this property</a>

query\_tag: str

<a href="#(resource)%20brand_protection.v2.queries%20%3E%20(model)%20query_get_response%20%3E%20(schema)%20%3E%20(variant)%201%20%3E%20(property)%20query_tag">Link to this property</a>

scan: bool

<a href="#(resource)%20brand_protection.v2.queries%20%3E%20(model)%20query_get_response%20%3E%20(schema)%20%3E%20(variant)%201%20%3E%20(property)%20scan">Link to this property</a>

updated: str

<a href="#(resource)%20brand_protection.v2.queries%20%3E%20(model)%20query_get_response%20%3E%20(schema)%20%3E%20(variant)%201%20%3E%20(property)%20updated">Link to this property</a>

</details>

<a href="#(resource)%20brand_protection.v2.queries%20%3E%20(model)%20query_get_response%20%3E%20(schema)%20%3E%20(variant)%201">Link to this property</a>

</details>

[Link to this property](<#(resource)%20brand_protection.v2.queries%20%3E%20(model)%20query_get_response%20%3E%20(schema)>)

#### V2Matches

##### [List saved query matches](https://developers.cloudflare.com/api/python/resources/brand_protection/subresources/v2/subresources/matches/methods/get)

brand\_protection.v2.matches.get(MatchGetParams\*\*kwargs) -> [MatchGetResponse](<https://developers.cloudflare.com/api/python/resources/brand_protection#(resource)%20brand_protection.v2.matches%20%3E%20(model)%20match_get_response%20%3E%20(schema)>)

GET/accounts/{account\_id}/cloudforce-one/v2/brand-protection/domain/matches

##### ModelsExpand Collapse

<details>

<summary>

class MatchGetResponse: …

</summary>

<details>

<summary>

matches: List\[Match]

</summary>

domain: str

<a href="#(resource)%20brand_protection.v2.matches%20%3E%20(model)%20match_get_response%20%3E%20(schema)%20%3E%20(property)%20matches%20%3E%20(items)%20%3E%20(property)%20domain">Link to this property</a>

first\_seen: str

<a href="#(resource)%20brand_protection.v2.matches%20%3E%20(model)%20match_get_response%20%3E%20(schema)%20%3E%20(property)%20matches%20%3E%20(items)%20%3E%20(property)%20first_seen">Link to this property</a>

<details>

<summary>

public\_scans: Optional\[MatchPublicScans]

</summary>

submission\_id: str

<a href="#(resource)%20brand_protection.v2.matches%20%3E%20(model)%20match_get_response%20%3E%20(schema)%20%3E%20(property)%20matches%20%3E%20(items)%20%3E%20(property)%20public_scans%20%3E%20(property)%20submission_id">Link to this property</a>

</details>

<a href="#(resource)%20brand_protection.v2.matches%20%3E%20(model)%20match_get_response%20%3E%20(schema)%20%3E%20(property)%20matches%20%3E%20(items)%20%3E%20(property)%20public_scans">Link to this property</a>

registrar: Optional\[str]

<a href="#(resource)%20brand_protection.v2.matches%20%3E%20(model)%20match_get_response%20%3E%20(schema)%20%3E%20(property)%20matches%20%3E%20(items)%20%3E%20(property)%20registrar">Link to this property</a>

scan\_status: str

<a href="#(resource)%20brand_protection.v2.matches%20%3E%20(model)%20match_get_response%20%3E%20(schema)%20%3E%20(property)%20matches%20%3E%20(items)%20%3E%20(property)%20scan_status">Link to this property</a>

scan\_submission\_id: Optional\[int]

<a href="#(resource)%20brand_protection.v2.matches%20%3E%20(model)%20match_get_response%20%3E%20(schema)%20%3E%20(property)%20matches%20%3E%20(items)%20%3E%20(property)%20scan_submission_id">Link to this property</a>

source: Optional\[str]

<a href="#(resource)%20brand_protection.v2.matches%20%3E%20(model)%20match_get_response%20%3E%20(schema)%20%3E%20(property)%20matches%20%3E%20(items)%20%3E%20(property)%20source">Link to this property</a>

dismissed: Optional\[bool]

Whether the match is dismissed. Only present for single-query requests. For multi-query requests, use the dismissed field in each match\_details entry.

<a href="#(resource)%20brand_protection.v2.matches%20%3E%20(model)%20match_get_response%20%3E%20(schema)%20%3E%20(property)%20matches%20%3E%20(items)%20%3E%20(property)%20dismissed">Link to this property</a>

<details>

<summary>

match\_details: Optional\[List\[MatchMatchDetail]]

Per-match detail objects with query metadata and individual dismissed state. Only present when multiple query\_ids are requested.

</summary>

dismissed: bool

Individual dismissed state for this specific match.

<a href="#(resource)%20brand_protection.v2.matches%20%3E%20(model)%20match_get_response%20%3E%20(schema)%20%3E%20(property)%20matches%20%3E%20(items)%20%3E%20(property)%20match_details%20%3E%20(items)%20%3E%20(property)%20dismissed">Link to this property</a>

match\_id: int

<a href="#(resource)%20brand_protection.v2.matches%20%3E%20(model)%20match_get_response%20%3E%20(schema)%20%3E%20(property)%20matches%20%3E%20(items)%20%3E%20(property)%20match_details%20%3E%20(items)%20%3E%20(property)%20match_id">Link to this property</a>

query\_id: int

<a href="#(resource)%20brand_protection.v2.matches%20%3E%20(model)%20match_get_response%20%3E%20(schema)%20%3E%20(property)%20matches%20%3E%20(items)%20%3E%20(property)%20match_details%20%3E%20(items)%20%3E%20(property)%20query_id">Link to this property</a>

query\_tag: Optional\[str]

Tag associated with the query, if one exists.

<a href="#(resource)%20brand_protection.v2.matches%20%3E%20(model)%20match_get_response%20%3E%20(schema)%20%3E%20(property)%20matches%20%3E%20(items)%20%3E%20(property)%20match_details%20%3E%20(items)%20%3E%20(property)%20query_tag">Link to this property</a>

</details>

<a href="#(resource)%20brand_protection.v2.matches%20%3E%20(model)%20match_get_response%20%3E%20(schema)%20%3E%20(property)%20matches%20%3E%20(items)%20%3E%20(property)%20match_details">Link to this property</a>

</details>

<a href="#(resource)%20brand_protection.v2.matches%20%3E%20(model)%20match_get_response%20%3E%20(schema)%20%3E%20(property)%20matches">Link to this property</a>

total: int

minimum0

<a href="#(resource)%20brand_protection.v2.matches%20%3E%20(model)%20match_get_response%20%3E%20(schema)%20%3E%20(property)%20total">Link to this property</a>

</details>

[Link to this property](<#(resource)%20brand_protection.v2.matches%20%3E%20(model)%20match_get_response%20%3E%20(schema)>)

#### V2Logos

##### [Insert logo query](https://developers.cloudflare.com/api/python/resources/brand_protection/subresources/v2/subresources/logos/methods/create)

brand\_protection.v2.logos.create(LogoCreateParams\*\*kwargs) -> [LogoCreateResponse](<https://developers.cloudflare.com/api/python/resources/brand_protection#(resource)%20brand_protection.v2.logos%20%3E%20(model)%20logo_create_response%20%3E%20(schema)>)

POST/accounts/{account\_id}/cloudforce-one/v2/brand-protection/logo/queries

##### [Delete logo query](https://developers.cloudflare.com/api/python/resources/brand_protection/subresources/v2/subresources/logos/methods/delete)

brand\_protection.v2.logos.delete(strquery\_id, LogoDeleteParams\*\*kwargs) -> [LogoDeleteResponse](<https://developers.cloudflare.com/api/python/resources/brand_protection#(resource)%20brand_protection.v2.logos%20%3E%20(model)%20logo_delete_response%20%3E%20(schema)>)

DELETE/accounts/{account\_id}/cloudforce-one/v2/brand-protection/logo/queries/{query\_id}

##### [Get logo queries](https://developers.cloudflare.com/api/python/resources/brand_protection/subresources/v2/subresources/logos/methods/get)

brand\_protection.v2.logos.get(LogoGetParams\*\*kwargs) -> [LogoGetResponse](<https://developers.cloudflare.com/api/python/resources/brand_protection#(resource)%20brand_protection.v2.logos%20%3E%20(model)%20logo_get_response%20%3E%20(schema)>)

GET/accounts/{account\_id}/cloudforce-one/v2/brand-protection/logo/queries

##### ModelsExpand Collapse

<details>

<summary>

class LogoCreateResponse: …

</summary>

message: str

<a href="#(resource)%20brand_protection.v2.logos%20%3E%20(model)%20logo_create_response%20%3E%20(schema)%20%3E%20(property)%20message">Link to this property</a>

success: bool

<a href="#(resource)%20brand_protection.v2.logos%20%3E%20(model)%20logo_create_response%20%3E%20(schema)%20%3E%20(property)%20success">Link to this property</a>

query\_id: Optional\[int]

<a href="#(resource)%20brand_protection.v2.logos%20%3E%20(model)%20logo_create_response%20%3E%20(schema)%20%3E%20(property)%20query_id">Link to this property</a>

</details>

[Link to this property](<#(resource)%20brand_protection.v2.logos%20%3E%20(model)%20logo_create_response%20%3E%20(schema)>)

<details>

<summary>

class LogoDeleteResponse: …

</summary>

message: str

<a href="#(resource)%20brand_protection.v2.logos%20%3E%20(model)%20logo_delete_response%20%3E%20(schema)%20%3E%20(property)%20message">Link to this property</a>

success: bool

<a href="#(resource)%20brand_protection.v2.logos%20%3E%20(model)%20logo_delete_response%20%3E%20(schema)%20%3E%20(property)%20success">Link to this property</a>

</details>

[Link to this property](<#(resource)%20brand_protection.v2.logos%20%3E%20(model)%20logo_delete_response%20%3E%20(schema)>)

<details>

<summary>

List\[LogoGetResponseItem]

</summary>

id: int

<a href="#(resource)%20brand_protection.v2.logos%20%3E%20(model)%20logo_get_response%20%3E%20(schema)%20%3E%20(items)%20%3E%20(property)%20id">Link to this property</a>

r2\_path: str

<a href="#(resource)%20brand_protection.v2.logos%20%3E%20(model)%20logo_get_response%20%3E%20(schema)%20%3E%20(items)%20%3E%20(property)%20r2_path">Link to this property</a>

similarity\_threshold: float

<a href="#(resource)%20brand_protection.v2.logos%20%3E%20(model)%20logo_get_response%20%3E%20(schema)%20%3E%20(items)%20%3E%20(property)%20similarity_threshold">Link to this property</a>

tag: str

<a href="#(resource)%20brand_protection.v2.logos%20%3E%20(model)%20logo_get_response%20%3E%20(schema)%20%3E%20(items)%20%3E%20(property)%20tag">Link to this property</a>

uploaded\_at: Optional\[str]

<a href="#(resource)%20brand_protection.v2.logos%20%3E%20(model)%20logo_get_response%20%3E%20(schema)%20%3E%20(items)%20%3E%20(property)%20uploaded_at">Link to this property</a>

content\_type: Optional\[str]

MIME type of the image (only present when download=true)

<a href="#(resource)%20brand_protection.v2.logos%20%3E%20(model)%20logo_get_response%20%3E%20(schema)%20%3E%20(items)%20%3E%20(property)%20content_type">Link to this property</a>

image\_data: Optional\[str]

Base64-encoded image data (only present when download=true)

<a href="#(resource)%20brand_protection.v2.logos%20%3E%20(model)%20logo_get_response%20%3E%20(schema)%20%3E%20(items)%20%3E%20(property)%20image_data">Link to this property</a>

</details>

[Link to this property](<#(resource)%20brand_protection.v2.logos%20%3E%20(model)%20logo_get_response%20%3E%20(schema)>)

#### V2Logo Matches

##### [List logo matches](https://developers.cloudflare.com/api/python/resources/brand_protection/subresources/v2/subresources/logo_matches/methods/get)

brand\_protection.v2.logo\_matches.get(LogoMatchGetParams\*\*kwargs) -> [LogoMatchGetResponse](<https://developers.cloudflare.com/api/python/resources/brand_protection#(resource)%20brand_protection.v2.logo_matches%20%3E%20(model)%20logo_match_get_response%20%3E%20(schema)>)

GET/accounts/{account\_id}/cloudforce-one/v2/brand-protection/logo/matches

##### ModelsExpand Collapse

<details>

<summary>

class LogoMatchGetResponse: …

</summary>

<details>

<summary>

matches: List\[Match]

</summary>

id: int

<a href="#(resource)%20brand_protection.v2.logo_matches%20%3E%20(model)%20logo_match_get_response%20%3E%20(schema)%20%3E%20(property)%20matches%20%3E%20(items)%20%3E%20(property)%20id">Link to this property</a>

domain: Optional\[str]

<a href="#(resource)%20brand_protection.v2.logo_matches%20%3E%20(model)%20logo_match_get_response%20%3E%20(schema)%20%3E%20(property)%20matches%20%3E%20(items)%20%3E%20(property)%20domain">Link to this property</a>

matched\_at: Optional\[str]

<a href="#(resource)%20brand_protection.v2.logo_matches%20%3E%20(model)%20logo_match_get_response%20%3E%20(schema)%20%3E%20(property)%20matches%20%3E%20(items)%20%3E%20(property)%20matched_at">Link to this property</a>

query\_id: int

<a href="#(resource)%20brand_protection.v2.logo_matches%20%3E%20(model)%20logo_match_get_response%20%3E%20(schema)%20%3E%20(property)%20matches%20%3E%20(items)%20%3E%20(property)%20query_id">Link to this property</a>

registrar: Optional\[str]

<a href="#(resource)%20brand_protection.v2.logo_matches%20%3E%20(model)%20logo_match_get_response%20%3E%20(schema)%20%3E%20(property)%20matches%20%3E%20(items)%20%3E%20(property)%20registrar">Link to this property</a>

similarity\_score: float

<a href="#(resource)%20brand_protection.v2.logo_matches%20%3E%20(model)%20logo_match_get_response%20%3E%20(schema)%20%3E%20(property)%20matches%20%3E%20(items)%20%3E%20(property)%20similarity_score">Link to this property</a>

url\_scan\_id: Optional\[str]

<a href="#(resource)%20brand_protection.v2.logo_matches%20%3E%20(model)%20logo_match_get_response%20%3E%20(schema)%20%3E%20(property)%20matches%20%3E%20(items)%20%3E%20(property)%20url_scan_id">Link to this property</a>

content\_type: Optional\[str]

<a href="#(resource)%20brand_protection.v2.logo_matches%20%3E%20(model)%20logo_match_get_response%20%3E%20(schema)%20%3E%20(property)%20matches%20%3E%20(items)%20%3E%20(property)%20content_type">Link to this property</a>

image\_data: Optional\[str]

<a href="#(resource)%20brand_protection.v2.logo_matches%20%3E%20(model)%20logo_match_get_response%20%3E%20(schema)%20%3E%20(property)%20matches%20%3E%20(items)%20%3E%20(property)%20image_data">Link to this property</a>

</details>

<a href="#(resource)%20brand_protection.v2.logo_matches%20%3E%20(model)%20logo_match_get_response%20%3E%20(schema)%20%3E%20(property)%20matches">Link to this property</a>

total: int

minimum0

<a href="#(resource)%20brand_protection.v2.logo_matches%20%3E%20(model)%20logo_match_get_response%20%3E%20(schema)%20%3E%20(property)%20total">Link to this property</a>

</details>

[Link to this property](<#(resource)%20brand_protection.v2.logo_matches%20%3E%20(model)%20logo_match_get_response%20%3E%20(schema)>)