---
title: "List Brand identity appeals"
method: GET
path: "/v3/10dlc/brands/{brand_id}/appeals"
tags: ["10DLC"]
---

# List Brand identity appeals

`GET /v3/10dlc/brands/{brand_id}/appeals`

## Request

- Base URL: `https://api.wavix.com`
- URL: `https://api.wavix.com/v3/10dlc/brands/{brand_id}/appeals`
- Auth: HTTP bearer

Returns the identity verification appeals submitted for the 10DLC Brand identified by `brand_id`.

## Path parameters

- `brand_id` string, required

## Response `200`

Returns the list of identity verification appeals.

- TenDLCBrandAppeal[]
  - `categories` string[], required: A list of Brand Identity status appeal categories associated with the original request
  - `created_at` string, required: The date and time the appeal request is created
  - `evidence` string[], required: A list of evidence UUIDs to be associated with the appeal
  - `outcome` object, required: The appeal outcome details
    - `optional_attributes` object, required: An optional attributes that might be returned from TCR
    - `vetting_status` 'REVIEW' | 'VERIFIED' | 'UNVERIFIED' | 'VETTED_VERIFIED' | 'SUSPENDED', required: Identity verification status of the 10DLC Brand. One of: - `REVIEW` — verification is in progress. - `VERIFIED` — the Brand passed standard verification. - `UNVERIFIED` — verification has not succeeded. - `VETTED_VERIFIED` — the Brand also passed third-party vetting. - `SUSPENDED` — the Brand is blocked from sending.
    - `feedback` object, required: Brand Identity Verification appeal feedback, if any
      - `category` TCRFeedbackCategory[], required: The feedback category
        - `id` string, required: The submitted appeal category
        - `display_name` string, required: The display name of the category
        - `description` string, required: The description of the category
        - `fields` string, nullable, required: An array of Brand attributes
        - `errors` TCRErrorMessage[], nullable, required: An array of verification errors, if any
          - `code` string, required: TCR error code
          - `message` string, required: A human-readable error description
  - `status` string, required: The appeal status
  - `updated_at` string, required: The date and time the appeal request is updated
  - `explanation` string, required: The appeal justification

## Other responses

- `400`: Returns a validation error when a field value is invalid.
- `401`: Unauthorized
- `403`: Returns when the 10DLC feature is disabled for the account.
- `404`: Returns when the requested 10DLC resource does not exist.

## Changes

- **2026-09-14** `d4db3aae3627`: 3 breaking, 5 warning, 1 info
  - the `items/outcome` response's property type changed from no type to `object` for status `200`
  - the `items/outcome/allOf[subschema #1: TenDLCBrandAppealOutcome]/feedback` response's property type changed from no type to `object` for status `200`
  - the `items/outcome/allOf[subschema #1: TenDLCBrandAppealOutcome]/vetting_status` response's property type changed from no type to `string` for status `200`
  - added the new `REVIEW` enum value to the `items/outcome/allOf[subschema #1: TenDLCBrandAppealOutcome]/vetting_status` response property for the response status `200`
  - …5 more
- **2026-09-08** `6a89c962481c`: 5 breaking, 7 info
  - added the pattern `^B[A-Z0-9]{6}$` to the `path` request parameter `brand_id`
  - the response's body type changed from no type to `object` for status `400`
  - the response's body type changed from no type to `object` for status `404`
  - the `items/created_at` response's property format changed from `date-time` to no format for status `200`
  - …8 more
- **2026-06-15** `76b9bb35619f`: 2 info
  - added `#/components/schemas/TenDLCBrandAppealOutcome` to the `items/outcome` response property `allOf` list for the response status `200`
  - removed `#/components/schemas/TenDlcBrandAppealOutcome` from the `items/outcome` response property `allOf` list for the response status `200`
- …earlier changes not shown

[Operation history](https://skmtc.dev/wavix/apis/wavix-apis/changes/v3/10dlc/brands/:brand_id/appeals/get.md)

---

[API](https://skmtc.dev/wavix/apis/wavix-apis.md) - [All operations](https://skmtc.dev/wavix/apis/wavix-apis/llms.txt) - [OpenAPI document](https://skmtc.dev/wavix/apis/wavix-apis/revisions/f2dde79f05ab?raw)