---
title: "Qualify By Usecase"
method: GET
path: "/10dlc/campaignBuilder/brand/{brandId}/usecase/{usecase}"
tags: ["Campaign"]
---

# Qualify By Usecase

`GET /10dlc/campaignBuilder/brand/{brandId}/usecase/{usecase}`

## Request

- Base URL: `https://api.telnyx.com/v2`
- URL: `https://api.telnyx.com/v2/10dlc/campaignBuilder/brand/{brandId}/usecase/{usecase}`
- Auth: HTTP bearer

This endpoint allows you to see whether or not the supplied brand is suitable for your desired campaign use case.

## Path parameters

- `usecase` string, required
- `brandId` string, required

## Response `200`

Successful Response

- UsecaseMetadata
  - `annualFee` number: Campaign annual subscription fee
  - `maxSubUsecases` integer: Maximum number of sub-usecases declaration required.
  - `minSubUsecases` integer: Minimum number of sub-usecases declaration required.
  - `mnoMetadata` object: Map of usecase metadata for each MNO. Key is the network ID of the MNO (e.g. 10017), Value is the mno metadata for the usecase.
  - `monthlyFee` number: Campaign monthly subscription fee
  - `quarterlyFee` number: Campaign quarterly subscription fee
  - `usecase` string: Campaign usecase

## Other responses

- `422`: Validation Error
- `4XX`: Generic response error

## Changes

> 152 revisions in range; 1 not diffed.

- **2026-10-21** `19db5ee4ec59`: 1 breaking, 1 info
  - the `errors/items/code` response's property type changed from `integer` to `string`, and format from `int32` to no format for status `4XX`
  - added the optional property `errors/items/description` to the response with the `4XX` status
- **2026-09-16** `a6a61a29ecdd`: 1 breaking, 1 info
  - the `errors/items/code` response's property type changed from `string` to `integer`, and format from no format to `int32` for status `4XX`
  - added the optional property `errors/items/meta` to the response with the `4XX` status
- **2026-08-17** `1571b0380bd7`: 1 breaking, 1 warning
  - the `errors/items/code` response's property type changed from `integer` to `string`, and format from `int32` to no format for status `4XX`
  - removed the optional property `errors/items/meta` from the response with the `4XX` status
- **2026-08-04** `8f5f4e537994`: 1 breaking, 1 info
  - the `errors/items/code` response's property type changed from `string` to `integer`, and format from no format to `int32` for status `4XX`
  - added the optional property `errors/items/meta` to the response with the `4XX` status

[Operation history](https://skmtc.dev/team-telnyx/apis/telnyx-api-2/changes/10dlc/campaignBuilder/brand/:brandId/usecase/:usecase/get.md)

---

[API](https://skmtc.dev/team-telnyx/apis/telnyx-api-2.md) - [All operations](https://skmtc.dev/team-telnyx/apis/telnyx-api-2/llms.txt) - [OpenAPI document](https://skmtc.dev/team-telnyx/apis/telnyx-api-2/revisions/f82938f53ff4?raw)
