# Matches

## Read matches for string queries by ID

`client.BrandProtection.Matches.Get(ctx, params) (*MatchGetResponse, error)`

**get** `/accounts/{account_id}/brand-protection/matches`

Return matches for string queries based on ID

### Parameters

- `params MatchGetParams`

  - `AccountID param.Field[string]`

    Path param

  - `ID param.Field[string]`

    Query param

  - `IncludeDomainID param.Field[bool]`

    Query param

  - `Limit param.Field[int64]`

    Query param

  - `Offset param.Field[int64]`

    Query param

### Returns

- `type MatchGetResponse struct{…}`

  - `Matches []map[string, unknown]`

  - `Total int64`

### Example

```go
package main

import (
  "context"
  "fmt"

  "github.com/cloudflare/cloudflare-go"
  "github.com/cloudflare/cloudflare-go/brand_protection"
  "github.com/cloudflare/cloudflare-go/option"
)

func main() {
  client := cloudflare.NewClient(
    option.WithAPIToken("Sn3lZJTBX6kkg7OdcBUAxOO963GEIyGQqnFTOFYY"),
  )
  match, err := client.BrandProtection.Matches.Get(context.TODO(), brand_protection.MatchGetParams{
    AccountID: cloudflare.F("x"),
  })
  if err != nil {
    panic(err.Error())
  }
  fmt.Printf("%+v\n", match.Matches)
}
```

#### Response

```json
{
  "matches": [
    {
      "foo": "bar"
    }
  ],
  "total": 0
}
```

## Download matches for string queries by ID

`client.BrandProtection.Matches.Download(ctx, params) (*MatchDownloadResponse, error)`

**get** `/accounts/{account_id}/brand-protection/matches/download`

Return matches as CSV for string queries based on ID

### Parameters

- `params MatchDownloadParams`

  - `AccountID param.Field[string]`

    Path param

  - `ID param.Field[string]`

    Query param

  - `IncludeDomainID param.Field[bool]`

    Query param

  - `Limit param.Field[int64]`

    Query param

  - `Offset param.Field[int64]`

    Query param

### Returns

- `type MatchDownloadResponse struct{…}`

  - `Matches []map[string, unknown]`

  - `Total int64`

### Example

```go
package main

import (
  "context"
  "fmt"

  "github.com/cloudflare/cloudflare-go"
  "github.com/cloudflare/cloudflare-go/brand_protection"
  "github.com/cloudflare/cloudflare-go/option"
)

func main() {
  client := cloudflare.NewClient(
    option.WithAPIToken("Sn3lZJTBX6kkg7OdcBUAxOO963GEIyGQqnFTOFYY"),
  )
  response, err := client.BrandProtection.Matches.Download(context.TODO(), brand_protection.MatchDownloadParams{
    AccountID: cloudflare.F("x"),
  })
  if err != nil {
    panic(err.Error())
  }
  fmt.Printf("%+v\n", response.Matches)
}
```

#### Response

```json
{
  "matches": [
    {
      "foo": "bar"
    }
  ],
  "total": 0
}
```