## List blocked handles

`client.BlockedHandles.List(ctx) (*BlockedHandleListResponse, error)`

**get** `/v3/blocked_handles`

Returns all handles you have blocked. Inbound messages from a blocked
handle are dropped and produce no webhooks, and direct sends to a
blocked handle are rejected with `403` (error code `2026`). Group
sends that include unblocked members are not restricted.

### Returns

- `type BlockedHandleListResponse struct{…}`

  - `BlockedHandles []BlockedHandleEntry`

    All handles blocked by the partner, newest first

    - `BlockedAt Time`

      When the handle was blocked

    - `Handle string`

      The blocked handle, normalized (E.164 phone, lowercased email, short code, or sender ID)

    - `Reason string`

      Optional note recorded when the handle was blocked

### Example

```go
package main

import (
  "context"
  "fmt"

  "github.com/linq-team/linq-go"
  "github.com/linq-team/linq-go/option"
)

func main() {
  client := linqgo.NewClient(
    option.WithAPIKey("My API Key"),
  )
  blockedHandles, err := client.BlockedHandles.List(context.TODO())
  if err != nil {
    panic(err.Error())
  }
  fmt.Printf("%+v\n", blockedHandles.BlockedHandles)
}
```

#### Response

```json
{
  "blocked_handles": [
    {
      "handle": "+12025551234",
      "reason": "spam",
      "blocked_at": "2026-07-30T16:42:00Z"
    }
  ]
}
```