> For clean Markdown of any page, append .md to the page URL. > For a complete documentation index, see https://docs.getdial.ai/llms.txt. > For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.getdial.ai/_mcp/server. # Submit 10DLC registration POST https://api.getdial.ai/api/v1/numbers/{id}/10dlc Content-Type: multipart/form-data Register a US number for 10DLC — the carrier registration required before a number can send SMS or MMS to US phone numbers. US carriers **block** outbound SMS and MMS sent from an unregistered 10-digit number to a US phone number. Registering this number lifts that block. Inbound texts, voice calls in either direction, and messaging to numbers outside the US are unaffected. **Eligibility.** The number must be US, have the `sms` capability, and not have the `imessage` capability (iMessage numbers send over Apple Messages for Business, not carrier SMS). 10DLC registration is currently offered on pay-as-you-go accounts only. An ineligible number returns `403` — read the `tenDlc` object on the number to know in advance. **Fee.** A one-time **$25.00** per number, taken from the account's credit balance when the submission is accepted. A balance below the fee returns `402`. **Resubmitting after a rejection is free** — the number is charged at most once, ever. **What happens next.** The submission lands in `in_review` while Dial checks the details, moves to `with_carrier` once filed with the carrier registry, and finishes as `approved` or `rejected`. Carriers usually decide within 3–5 business days. Dial emails the account owner on approval and on rejection; a rejection carries a `reason` explaining exactly what to change before resubmitting. **Body.** `multipart/form-data` only — a screenshot of the opt-in flow is required. Send `kind`, a JSON `data` part carrying the field set for that kind, and one `optInImage` file part. ### Fields — both kinds Every field is required unless noted. | Key | Description | |---|---| | `firstName`, `lastName` | The person responsible for the registration. | | `email` | Contact email. | | `phone` | Mobile number in E.164. Receives a verification SMS — reply `YES`. | | `street`, `city`, `state`, `zip` | US mailing address; `state` is the 2-letter code. Carriers use it to verify the registration. | | `country` | Always `US`. | | `useCaseDescription` | Who is messaged and why. At least 40 characters. | | `messageFlow` | How people opt in. At least 40 characters. | | `containsUrls`, `containsPhones` | Booleans. Optional; default false. | ### Fields — `business` only | Key | Description | |---|---| | `businessName` | Registered business or DBA name. | | `numberCount` | How many numbers you plan to use. Whole number, at least 1. | | `businessType` | One of `Partnership`, `Corporation`, `LLC`, `Co-operative`, `Sole Proprietorship`, `Non-profit`. | | `industry` | The business's industry. | | `position` | Your position, e.g. `Head of Operations`. | | `ein` | Tax ID. | | `regIdType` | One of `EIN`, `DUNS`, `GIIN`, `LEI`. Optional; defaults to `EIN`. | | `companyType` | One of `Private`, `Public`, `Non profit`, `Government`. | | `website`, `privacyUrl`, `termsUrl` | Full `https://` URLs. | | `social` | Social media URL. Optional. | | `regions` | Regions of operation. Optional; defaults to `USA AND CANADA`. | | `useCase` | Campaign use case, e.g. `CUSTOMER CARE`. Optional; defaults to `MIXED`. | | `sample1`, `sample2` | Two sample messages, at least 20 characters each. Each must name the brand and carry an opt-out instruction. | Reference: https://docs.getdial.ai/api-reference/rest-api/phone-numbers/submit-ten-dlc-registration ## OpenAPI Specification ```yaml openapi: 3.1.0 info: title: rest version: 1.0.0 paths: /api/v1/numbers/{id}/10dlc: post: operationId: submit-ten-dlc-registration summary: Submit 10DLC registration description: > Register a US number for 10DLC — the carrier registration required before a number can send SMS or MMS to US phone numbers. US carriers **block** outbound SMS and MMS sent from an unregistered 10-digit number to a US phone number. Registering this number lifts that block. Inbound texts, voice calls in either direction, and messaging to numbers outside the US are unaffected. **Eligibility.** The number must be US, have the `sms` capability, and not have the `imessage` capability (iMessage numbers send over Apple Messages for Business, not carrier SMS). 10DLC registration is currently offered on pay-as-you-go accounts only. An ineligible number returns `403` — read the `tenDlc` object on the number to know in advance. **Fee.** A one-time **$25.00** per number, taken from the account's credit balance when the submission is accepted. A balance below the fee returns `402`. **Resubmitting after a rejection is free** — the number is charged at most once, ever. **What happens next.** The submission lands in `in_review` while Dial checks the details, moves to `with_carrier` once filed with the carrier registry, and finishes as `approved` or `rejected`. Carriers usually decide within 3–5 business days. Dial emails the account owner on approval and on rejection; a rejection carries a `reason` explaining exactly what to change before resubmitting. **Body.** `multipart/form-data` only — a screenshot of the opt-in flow is required. Send `kind`, a JSON `data` part carrying the field set for that kind, and one `optInImage` file part. ### Fields — both kinds Every field is required unless noted. | Key | Description | |---|---| | `firstName`, `lastName` | The person responsible for the registration. | | `email` | Contact email. | | `phone` | Mobile number in E.164. Receives a verification SMS — reply `YES`. | | `street`, `city`, `state`, `zip` | US mailing address; `state` is the 2-letter code. Carriers use it to verify the registration. | | `country` | Always `US`. | | `useCaseDescription` | Who is messaged and why. At least 40 characters. | | `messageFlow` | How people opt in. At least 40 characters. | | `containsUrls`, `containsPhones` | Booleans. Optional; default false. | ### Fields — `business` only | Key | Description | |---|---| | `businessName` | Registered business or DBA name. | | `numberCount` | How many numbers you plan to use. Whole number, at least 1. | | `businessType` | One of `Partnership`, `Corporation`, `LLC`, `Co-operative`, `Sole Proprietorship`, `Non-profit`. | | `industry` | The business's industry. | | `position` | Your position, e.g. `Head of Operations`. | | `ein` | Tax ID. | | `regIdType` | One of `EIN`, `DUNS`, `GIIN`, `LEI`. Optional; defaults to `EIN`. | | `companyType` | One of `Private`, `Public`, `Non profit`, `Government`. | | `website`, `privacyUrl`, `termsUrl` | Full `https://` URLs. | | `social` | Social media URL. Optional. | | `regions` | Regions of operation. Optional; defaults to `USA AND CANADA`. | | `useCase` | Campaign use case, e.g. `CUSTOMER CARE`. Optional; defaults to `MIXED`. | | `sample1`, `sample2` | Two sample messages, at least 20 characters each. Each must name the brand and carry an opt-out instruction. | tags: - phoneNumbers parameters: - name: id in: path required: true schema: type: string - name: Authorization in: header description: 'Your Dial API key, sent as `Authorization: Bearer sk_live_...`' required: true schema: type: string responses: '200': description: Submitted, and the fee charged unless this was a free resubmission. content: application/json: schema: $ref: >- #/components/schemas/Phone numbers_submitTenDlcRegistration_Response_200 '400': description: >- The body failed validation. For field-level problems the error code is `tendlc_validation_failed` and `error` is an object mapping each offending field key to a human-readable message. content: application/json: schema: $ref: '#/components/schemas/Error' '401': description: Missing or invalid API key. content: application/json: schema: $ref: '#/components/schemas/Error' '402': description: >- The account's credit balance is below the $25.00 registration fee. Add credit and submit again. (error code `insufficient_credit`.) content: application/json: schema: $ref: '#/components/schemas/Error' '403': description: >- 10DLC registration isn't available here. Either it doesn't apply to this number — it isn't US, or it has the `imessage` capability (error code `tendlc_not_applicable`) — or the account isn't pay-as-you-go and has no existing registration for the number (error code `tendlc_not_available`). The `tenDlc` object on the phone number is null in both cases. content: application/json: schema: $ref: '#/components/schemas/Error' '404': description: The requested resource was not found on this account. content: application/json: schema: $ref: '#/components/schemas/Error' '409': description: >- This number already has a registration that is in review, filed with the carrier registry, or approved. Only a rejected registration can be resubmitted. (error code `tendlc_already_registered`.) content: application/json: schema: $ref: '#/components/schemas/Error' '413': description: >- Request body too large — the opt-in screenshot exceeds the 2 MB limit. content: application/json: schema: description: Any type requestBody: content: multipart/form-data: schema: type: object properties: kind: $ref: >- #/components/schemas/ApiV1NumbersId10DlcPostRequestBodyContentMultipartFormDataSchemaKind description: >- Text part. Who is registering. A sole proprietor operates under their own name and has no EIN — lower throughput, quicker to approve. A business is a registered company with an EIN. data: type: string description: >- Text part. A JSON object carrying the field set for the chosen `kind` — see the tables above. optInImage: type: string format: binary description: >- A single uploaded file part: a screenshot of the form, checkbox, or page where people opt in, with the consent wording and the checkbox both visible. jpeg, png, gif, or webp; max 2 MB. required: - kind - data - optInImage servers: - url: https://api.getdial.ai description: Dial REST API components: schemas: ApiV1NumbersId10DlcPostRequestBodyContentMultipartFormDataSchemaKind: type: string enum: - sole_proprietor - business description: >- Text part. Who is registering. A sole proprietor operates under their own name and has no EIN — lower throughput, quicker to approve. A business is a registered company with an EIN. title: ApiV1NumbersId10DlcPostRequestBodyContentMultipartFormDataSchemaKind TenDlcRegistrationStatus: type: string enum: - in_review - with_carrier - approved - rejected description: >- Where the registration stands. Unlike the `tenDlc` summary on a phone number, this object only exists once something has been submitted, so `not_registered` never appears here. title: TenDlcRegistrationStatus TenDlcRegistrationKind: type: string enum: - sole_proprietor - business description: >- Who the number is registered as. A sole proprietor operates under their own name and has no EIN — lower throughput, quicker to approve. A business is a registered company with an EIN. title: TenDlcRegistrationKind TenDlcRegistration: type: object properties: phoneNumberId: type: string status: $ref: '#/components/schemas/TenDlcRegistrationStatus' description: >- Where the registration stands. Unlike the `tenDlc` summary on a phone number, this object only exists once something has been submitted, so `not_registered` never appears here. kind: $ref: '#/components/schemas/TenDlcRegistrationKind' description: >- Who the number is registered as. A sole proprietor operates under their own name and has no EIN — lower throughput, quicker to approve. A business is a registered company with an EIN. data: type: object additionalProperties: description: Any type description: >- The submitted field set, as sent. Which keys are present depends on `kind` — see Submit 10DLC registration for the full field list. optInImageUrl: type: string description: >- Short-lived URL of the submitted opt-in flow screenshot. Expires a few minutes after the response is generated; re-read this resource for a fresh one. feeCents: type: integer description: The one-time registration fee charged for this number, in USD cents. reason: type: - string - 'null' description: What needs to change. Non-null only when `status` is `rejected`. submittedAt: type: string format: date-time reviewedAt: type: - string - 'null' format: date-time description: When the registration was approved or rejected; null until then. required: - phoneNumberId - status - kind - data - feeCents - reason - submittedAt - reviewedAt description: >- A number's 10DLC registration, including the field set that was submitted. Returned by Get and Submit 10DLC registration. title: TenDlcRegistration Phone numbers_submitTenDlcRegistration_Response_200: type: object properties: registration: $ref: '#/components/schemas/TenDlcRegistration' title: Phone numbers_submitTenDlcRegistration_Response_200 ErrorError: oneOf: - type: string - type: object additionalProperties: description: Any type description: An error message, or a validation-error object for 400 responses. title: ErrorError Error: type: object properties: error: $ref: '#/components/schemas/ErrorError' description: An error message, or a validation-error object for 400 responses. title: Error securitySchemes: bearerAuth: type: http scheme: bearer description: 'Your Dial API key, sent as `Authorization: Bearer sk_live_...`' ``` ## Examples **Request** ```json { "kind": "sole_proprietor", "data": "{\"firstName\":\"Maya\",\"lastName\":\"Chen\",\"email\":\"maya.chen@example.com\",\"phone\":\"+14155550110\",\"street\":\"480 Bryant St\",\"city\":\"San Francisco\",\"state\":\"CA\",\"zip\":\"94107\",\"country\":\"US\",\"useCaseDescriptt", "optInImage": "" } ``` **Response** ```json { "registration": { "phoneNumberId": "pn_1234567890abcdef", "status": "in_review", "kind": "sole_proprietor", "data": {}, "feeCents": 2500, "reason": "", "submittedAt": "2024-04-20T14:00:00Z", "reviewedAt": "", "optInImageUrl": "https://api.getdial.ai/temp/optin_screenshot_12345.png" } } ``` **SDK Code** ```python import requests url = "https://api.getdial.ai/api/v1/numbers/id/10dlc" files = { "optInImage": "open('optin_screenshot.png', 'rb')" } payload = { "kind": "sole_proprietor", "data": "{\"firstName\":\"Maya\",\"lastName\":\"Chen\",\"email\":\"maya.chen@example.com\",\"phone\":\"+14155550110\",\"street\":\"480 Bryant St\",\"city\":\"San Francisco\",\"state\":\"CA\",\"zip\":\"94107\",\"country\":\"US\",\"useCaseDescriptt" } headers = {"Authorization": "Bearer "} response = requests.post(url, data=payload, files=files, headers=headers) print(response.json()) ``` ```javascript const url = 'https://api.getdial.ai/api/v1/numbers/id/10dlc'; const form = new FormData(); form.append('kind', 'sole_proprietor'); form.append('data', '{"firstName":"Maya","lastName":"Chen","email":"maya.chen@example.com","phone":"+14155550110","street":"480 Bryant St","city":"San Francisco","state":"CA","zip":"94107","country":"US","useCaseDescriptt'); form.append('optInImage', 'optin_screenshot.png'); const options = {method: 'POST', headers: {Authorization: 'Bearer '}}; options.body = form; try { const response = await fetch(url, options); const data = await response.json(); console.log(data); } catch (error) { console.error(error); } ``` ```go package main import ( "fmt" "strings" "net/http" "io" ) func main() { url := "https://api.getdial.ai/api/v1/numbers/id/10dlc" payload := strings.NewReader("-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"kind\"\r\n\r\nsole_proprietor\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"data\"\r\n\r\n{\"firstName\":\"Maya\",\"lastName\":\"Chen\",\"email\":\"maya.chen@example.com\",\"phone\":\"+14155550110\",\"street\":\"480 Bryant St\",\"city\":\"San Francisco\",\"state\":\"CA\",\"zip\":\"94107\",\"country\":\"US\",\"useCaseDescriptt\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"optInImage\"; filename=\"optin_screenshot.png\"\r\nContent-Type: application/octet-stream\r\n\r\n\r\n-----011000010111000001101001--\r\n") req, _ := http.NewRequest("POST", url, payload) req.Header.Add("Authorization", "Bearer ") res, _ := http.DefaultClient.Do(req) defer res.Body.Close() body, _ := io.ReadAll(res.Body) fmt.Println(res) fmt.Println(string(body)) } ``` ```ruby require 'uri' require 'net/http' url = URI("https://api.getdial.ai/api/v1/numbers/id/10dlc") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true request = Net::HTTP::Post.new(url) request["Authorization"] = 'Bearer ' request.body = "-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"kind\"\r\n\r\nsole_proprietor\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"data\"\r\n\r\n{\"firstName\":\"Maya\",\"lastName\":\"Chen\",\"email\":\"maya.chen@example.com\",\"phone\":\"+14155550110\",\"street\":\"480 Bryant St\",\"city\":\"San Francisco\",\"state\":\"CA\",\"zip\":\"94107\",\"country\":\"US\",\"useCaseDescriptt\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"optInImage\"; filename=\"optin_screenshot.png\"\r\nContent-Type: application/octet-stream\r\n\r\n\r\n-----011000010111000001101001--\r\n" response = http.request(request) puts response.read_body ``` ```java import com.mashape.unirest.http.HttpResponse; import com.mashape.unirest.http.Unirest; HttpResponse response = Unirest.post("https://api.getdial.ai/api/v1/numbers/id/10dlc") .header("Authorization", "Bearer ") .body("-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"kind\"\r\n\r\nsole_proprietor\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"data\"\r\n\r\n{\"firstName\":\"Maya\",\"lastName\":\"Chen\",\"email\":\"maya.chen@example.com\",\"phone\":\"+14155550110\",\"street\":\"480 Bryant St\",\"city\":\"San Francisco\",\"state\":\"CA\",\"zip\":\"94107\",\"country\":\"US\",\"useCaseDescriptt\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"optInImage\"; filename=\"optin_screenshot.png\"\r\nContent-Type: application/octet-stream\r\n\r\n\r\n-----011000010111000001101001--\r\n") .asString(); ``` ```php request('POST', 'https://api.getdial.ai/api/v1/numbers/id/10dlc', [ 'multipart' => [ [ 'name' => 'kind', 'contents' => 'sole_proprietor' ], [ 'name' => 'data', 'contents' => '{"firstName":"Maya","lastName":"Chen","email":"maya.chen@example.com","phone":"+14155550110","street":"480 Bryant St","city":"San Francisco","state":"CA","zip":"94107","country":"US","useCaseDescriptt' ], [ 'name' => 'optInImage', 'filename' => 'optin_screenshot.png', 'contents' => null ] ] 'headers' => [ 'Authorization' => 'Bearer ', ], ]); echo $response->getBody(); ``` ```csharp using RestSharp; var client = new RestClient("https://api.getdial.ai/api/v1/numbers/id/10dlc"); var request = new RestRequest(Method.POST); request.AddHeader("Authorization", "Bearer "); request.AddParameter("undefined", "-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"kind\"\r\n\r\nsole_proprietor\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"data\"\r\n\r\n{\"firstName\":\"Maya\",\"lastName\":\"Chen\",\"email\":\"maya.chen@example.com\",\"phone\":\"+14155550110\",\"street\":\"480 Bryant St\",\"city\":\"San Francisco\",\"state\":\"CA\",\"zip\":\"94107\",\"country\":\"US\",\"useCaseDescriptt\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"optInImage\"; filename=\"optin_screenshot.png\"\r\nContent-Type: application/octet-stream\r\n\r\n\r\n-----011000010111000001101001--\r\n", ParameterType.RequestBody); IRestResponse response = client.Execute(request); ``` ```swift import Foundation let headers = ["Authorization": "Bearer "] let parameters = [ [ "name": "kind", "value": "sole_proprietor" ], [ "name": "data", "value": "{\"firstName\":\"Maya\",\"lastName\":\"Chen\",\"email\":\"maya.chen@example.com\",\"phone\":\"+14155550110\",\"street\":\"480 Bryant St\",\"city\":\"San Francisco\",\"state\":\"CA\",\"zip\":\"94107\",\"country\":\"US\",\"useCaseDescriptt" ], [ "name": "optInImage", "fileName": "optin_screenshot.png" ] ] let boundary = "---011000010111000001101001" var body = "" var error: NSError? = nil for param in parameters { let paramName = param["name"]! body += "--\(boundary)\r\n" body += "Content-Disposition:form-data; name=\"\(paramName)\"" if let filename = param["fileName"] { let contentType = param["content-type"]! let fileContent = String(contentsOfFile: filename, encoding: String.Encoding.utf8) if (error != nil) { print(error as Any) } body += "; filename=\"\(filename)\"\r\n" body += "Content-Type: \(contentType)\r\n\r\n" body += fileContent } else if let paramValue = param["value"] { body += "\r\n\r\n\(paramValue)" } } let request = NSMutableURLRequest(url: NSURL(string: "https://api.getdial.ai/api/v1/numbers/id/10dlc")! as URL, cachePolicy: .useProtocolCachePolicy, timeoutInterval: 10.0) request.httpMethod = "POST" request.allHTTPHeaderFields = headers request.httpBody = postData as Data let session = URLSession.shared let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in if (error != nil) { print(error as Any) } else { let httpResponse = response as? HTTPURLResponse print(httpResponse) } }) dataTask.resume() ```