---
title: "Get campaigns for a profile's brand"
method: GET
path: "/v3/profiles/{profileId}/campaigns"
tags: ["Profiles"]
---

# Get campaigns for a profile's brand

`GET /v3/profiles/{profileId}/campaigns`

Retrieves all campaigns linked to the profile's brand, including use cases and sample messages. Returns inherited campaigns if inherit_tcr_campaign=true.

## Path parameters

- `profileId` string, uuid, required

## Headers

- `x-profile-id` string, uuid

## Response `200`

Campaigns retrieved successfully

- SentDmServicesEndpointsCustomerAPIv3ResponsesApiResponseOfListOfTcrCampaignWithUseCasesResponse — Standard API response envelope for all v3 endpoints
  - `success` boolean — Indicates whether the request was successful
  - `data` SentDmServicesCommonServicesCampaignsContractsTcrCampaignWithUseCasesResponse[], nullable — The response data (null if error)
    - `id` string, uuid — Unique identifier
    - `createdAt` string, date-time
    - `updatedAt` string, date-time, nullable
    - `kycSubmissionFormId` string, uuid, nullable
    - `type` string
    - `customerId` string, uuid
    - `name` string
    - `description` string
    - `submittedToTCR` boolean
    - `submittedAt` string, date-time, nullable
    - `billedDate` string, date-time, nullable
    - `cost` number, nullable
    - `telnyxCampaignId` string, nullable
    - `tcrCampaignId` string, nullable
    - `cspId` string, nullable
    - `status` 'SENT_CREATED' | 'ACTIVE' | 'EXPIRED'
    - `brandId` string, uuid, nullable
    - `resellerId` string, nullable
    - `messageFlow` string, nullable
    - `privacyPolicyLink` string, nullable
    - `termsAndConditionsLink` string, nullable
    - `optinMessage` string, nullable
    - `optoutMessage` string, nullable
    - `helpMessage` string, nullable
    - `optinKeywords` string, nullable
    - `optoutKeywords` string, nullable
    - `helpKeywords` string, nullable
    - `upstreamCnpId` string, nullable
    - `sharingStatus` 'PENDING' | 'ACCEPTED' | 'DECLINED'
    - `dcaElectionsComplete` boolean, nullable
    - `dcaElectionsCompletedAt` string, date-time, nullable
    - `useCases` SentDmServicesCommonEntitiesTcrCampaignUseCase[]
      - `id` string, uuid — Unique identifier
      - `createdAt` string, date-time
      - `updatedAt` string, date-time, nullable
      - `campaignId` string, uuid
      - `customerId` string, uuid
      - `messagingUseCaseUs` 'MARKETING' | 'ACCOUNT_NOTIFICATION' | 'CUSTOMER_CARE' | 'FRAUD_ALERT' | 'TWO_FA' | 'DELIVERY_NOTIFICATION' | 'SECURITY_ALERT' | 'M2M' | 'MIXED' | 'HIGHER_EDUCATION' | 'POLLING_VOTING' | 'PUBLIC_SERVICE_ANNOUNCEMENT' | 'LOW_VOLUME'
      - `sampleMessages` string[]
    - `tcrSyncError` string, nullable
  - `error` SentDmServicesEndpointsCustomerAPIv3ResponsesApiError — Error information
    - `code` string — Machine-readable error code (e.g., "RESOURCE_001")
    - `message` string — Human-readable error message
    - `details` object, nullable — Additional validation error details (field-level errors)
    - `doc_url` string, nullable — URL to documentation about this error
  - `meta` SentDmServicesEndpointsCustomerAPIv3ResponsesApiMeta — Request and response metadata
    - `request_id` string — Unique identifier for this request (for tracing and support)
    - `timestamp` string, date-time — Server timestamp when the response was generated
    - `version` string — API version used for this request

## Other responses

- `401` — Unauthorized - Valid API key required
- `403` — Forbidden
- `404` — Profile or brand not found
- `500` — Internal server error occurred

---

[API](https://skmtc.net/sentdm/apis/sent-dm-api-v3.md) · [All operations](https://skmtc.net/sentdm/apis/sent-dm-api-v3/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/sentdm/sent-dm-api-v3/versions/c451eca46f1b/schema)