# List 10DLC campaigns

> List 10DLC campaign registrations for this project.

`GET https://api.zavu.dev/v1/10dlc/campaigns`

List 10DLC campaign registrations for this project.

## Parameters

- `brandId` (query, string): Filter campaigns by brand ID.
- `limit` (query, integer)
- `cursor` (query, string)

## Responses

### 200

List of campaigns.

- `items` (object[], required)
  - `id` (string, required)
  - `brandId` (string, required): ID of the brand this campaign belongs to.
  - `name` (string, required)
  - `useCase` (string, required): Campaign use case type.
  - `subUseCases` (string[], nullable)
  - `description` (string, required): Description of the messaging campaign.
  - `sampleMessages` (string[], required): Sample messages representative of campaign content.
  - `subscriberOptIn` (boolean, required)
  - `subscriberOptOut` (boolean, required)
  - `subscriberHelp` (boolean, required)
  - `numberPooling` (boolean, required)
  - `directLending` (boolean, required)
  - `embeddedLink` (boolean, required)
  - `embeddedPhone` (boolean, required)
  - `affiliateMarketing` (boolean, required)
  - `ageGated` (boolean, required)
  - `messageFlow` (string, nullable)
  - `helpMessage` (string, nullable)
  - `optInKeywords` (string[], nullable)
  - `optOutKeywords` (string[], nullable)
  - `status` (string, required): Status of a 10DLC campaign registration. - `draft`: created, not yet submitted. - `pending`: submitted, awaiting the carriers. Re-read from the carrier every 30 minutes, so it moves on its own. - `approved`: SMS to +1 numbers can go out from numbers assigned to it. The monthly fee is charged while it is approved. - `rejected`: refused by the carriers. The one-time registration fee is refunded. - `failed`: the registration did not reach the carriers. The fee is refunded. - `expired`: was approved and has lapsed. One of: `draft`, `pending`, `approved`, `rejected`, `expired`, `failed`.
  - `dailyLimit` (integer, nullable): Daily message limit based on brand trust score.
  - `failureReason` (string, nullable)
  - `registrationCostCents` (integer, nullable): One-time registration cost in cents.
  - `monthlyFeeCents` (integer, nullable): Recurring monthly fee in cents.
  - `submittedAt` (string<date-time>, nullable)
  - `approvedAt` (string<date-time>, nullable)
  - `createdAt` (string<date-time>, required)
  - `updatedAt` (string<date-time>, required)
- `nextCursor` (string, nullable)

### 401

Unauthorized.

- `code` (string, required)
- `message` (string, required)
- `details` (object)

## Example

```bash
curl -X GET "https://api.zavu.dev/v1/10dlc/campaigns" \
  -H "Authorization: Bearer $ZAVUDEV_API_KEY"
```

```typescript
import Zavudev from "@zavudev/sdk";

const zavu = new Zavudev({ apiKey: process.env.ZAVUDEV_API_KEY });

const result = await zavu.number10dlc.campaigns.list();

console.log(result);
```