diff --git a/site/docs/messaging/campaign-management/csp/campaign-api.mdx b/site/docs/messaging/campaign-management/csp/campaign-api.mdx index 7169e4c38..6fbed53b1 100644 --- a/site/docs/messaging/campaign-management/csp/campaign-api.mdx +++ b/site/docs/messaging/campaign-management/csp/campaign-api.mdx @@ -73,8 +73,8 @@ HTTP/1.1 429 Too Many Requests 6. [Deactivate Campaign](#deactivate-campaign) 7. [Re-Vet Campaign](#re-vet-campaign) 8. [Update Campaign TN Relationship](#update-campaign-tn-relationship) -9. [Bulk Update Campaign TN Relationships](#bulk-update-campaign-tn-relationships) - +9. [Fetch Campaign TNs](#fetch-campaign-tns) +10. [Bulk Update Campaign TN Relationships](#bulk-update-campaign-tn-relationships) ## Create campaign @@ -955,6 +955,50 @@ Location: https://dashboard.bandwidth.com/api/accounts/accounts/{accountId}/tnop ``` +## Fetch Campaign TNs + +This endpoint allows you to fetch the telephone numbers that have been registered to a specific campaign. + +### Request URL + +GET https://dashboard.bandwidth.com/api/accounts/{accountId}/campaignManagement/10dlc/campaigns/{campaignId}/tn + +### Examples + +> Request + +```http +GET https://dashboard.bandwidth.com/api/accounts/{accountId}/campaignManagement/10dlc/campaigns/{campaignId}/tn HTTP/1.1 +Content-Type: application/xml; charset=utf-8 +Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ= +``` + +> Response + +```http +HTTP/1.1 200 No Content +Content-Type: application/xml + + + 1 + + 8888888888 + + +``` + +> Error Response + +```http + + + + 5081 + Number Format 'wrong' is invalid. + + +``` + ## Bulk Update Campaign TN Relationships We do not have a publicly exposed REST endpoint for bulk TN updates. Please see how to import a csv in our [CSP campaign Dashboard UI guide](https://support.bandwidth.com/hc/en-us/articles/5900095168663-How-to-register-a-campaign-for-10DLC).
For more info on TNs, please see [Number Management](/docs/numbers/).