For the complete documentation index, see llms.txt. Any page on this site can be fetched as Markdown by appending .md to its URL.

RoutingToll free verification

Resubmit a denied toll-free verification request

PUT
/v1/sms-registration/tfv/{tfvRequestId}

Resubmit a denied request with an updated business profile. Only the request's denied numbers are sent again; a pending or verified number on it is left as it is. Only accepted while the request's status is denied; a request that is still pending or already verified is rejected. The carrier accepts a resubmission within 7 days of its decision (deniedAt), and only for a number whose resubmitAllowed is not false. Any other denied number is skipped; when every denied number on the request is one, the resubmit answers 409; submit those numbers as a new request instead. A 400 with code TFV_REJECTED is the carrier refusing the resubmission, as on submit.

Authorization

bearerAuth
AuthorizationBearer <token>

A Tandem bearer token. Requests are scoped to the organization the token belongs to; no organization header is required.

In: header

Path Parameters

tfvRequestId*string

The toll-free verification request's unique ID.

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X PUT "https://example.com/v1/sms-registration/tfv/string" \  -H "Content-Type: application/json" \  -d '{    "profile": {      "businessName": "string",      "businessEntityType": "SOLE_PROPRIETOR",      "businessAddress": {        "addressLine1": "string",        "city": "string",        "state": "string",        "zip": "string",        "websiteUrl": "string"      },      "businessContact": {        "firstName": "string",        "lastName": "string",        "email": "string",        "phone": "string"      },      "useCase": "string",      "useCaseSummary": "string",      "productionMessageContent": "string",      "estimatedMonthlyVolume": 10,      "optIn": {        "description": "string",        "images": [          {            "kind": "upload",            "key": "string"          }        ]      }    }  }'
{  "id": "string",  "numbers": [    {      "numberId": "string",      "phoneNumber": "string",      "status": "pending",      "denialReason": "string",      "resubmitAllowed": true,      "deniedAt": "2019-08-24T14:15:22Z"    }  ],  "profile": {    "businessName": "string",    "businessDba": "string",    "businessEntityType": "SOLE_PROPRIETOR",    "businessRegistrationNumber": "string",    "businessRegistrationType": "EIN",    "businessRegistrationIssuingCountry": "string",    "businessAddress": {      "addressLine1": "string",      "addressLine2": "string",      "city": "string",      "state": "string",      "zip": "string",      "websiteUrl": "string"    },    "businessContact": {      "firstName": "string",      "lastName": "string",      "email": "string",      "phone": "string"    },    "useCase": "string",    "useCaseSummary": "string",    "productionMessageContent": "string",    "estimatedMonthlyVolume": 10,    "optIn": {      "description": "string",      "images": [        {          "kind": "upload",          "key": "string"        }      ],      "confirmationResponse": "string"    },    "privacyPolicyUrl": "string",    "termsUrl": "string",    "additionalInformation": "string"  },  "status": "pending",  "createdAt": "2019-08-24T14:15:22Z",  "updatedAt": "2019-08-24T14:15:22Z"}
{  "error": {    "code": "string",    "message": "string"  }}
{  "error": {    "code": "string",    "message": "string"  }}
{  "error": {    "code": "string",    "message": "string"  }}
{  "error": {    "code": "string",    "message": "string"  }}