Check SMS Status

GET

/v2/sms/check

const url = 'https://api.contacta.mx/v2/sms/check?token=199999';
const options = {method: 'GET', headers: {Authorization: 'Basic <credentials>'}};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

curl --request GET \
  --url 'https://api.contacta.mx/v2/sms/check?token=199999' \
  --header 'Authorization: Basic <credentials>'

Checks the delivery status of a previously sent SMS by its message ID.

Authorizations

BasicAuth

Parameters

Query Parameters

token

required

string

Message ID returned when the SMS was sent

Example

Responses

200

SMS status retrieved successfully

application/json

object

status

boolean

error

boolean

description

object

message

object

carrier

string

control

Internal carrier control reference

string

disposicion

Line type (e.g. MOVIL, FIJO)

string

encoding

string

Allowed values: gsm unicode

loops

Number of delivery retry loops

string

msg

Original message text

string

parts

Number of SMS segments

integer

phone

Destination phone number

string

received_date

Date the message was received by the platform

string format: date-time

send_date

Date the message was delivered to the carrier (zeros if pending)

string format: date-time

size

Character count of the message

integer

status

Delivery status reported by the carrier

string

var_a

Custom variable A (usually set to your external ID)

string

var_b

Custom variable B

string

nullable

answers

Incoming replies to this message (if two-way SMS is enabled)

Array<object>

object

Example

{
  "status": true,
  "error": false,
  "description": {
    "message": {
      "carrier": "ATT COMERCIALIZACION MOVIL S. DE R.L. DE C.V.",
      "control": "1006095262300",
      "disposicion": "MOVIL",
      "encoding": "gsm",
      "loops": 1,
      "msg": "Tu codigo de verificacion es 1234456",
      "parts": 1,
      "phone": "8100001234",
      "received_date": "2026-06-24 16:16:52",
      "send_date": "2026-06-24 16:16:53",
      "size": 36,
      "status": "ENVIO CONFIRMADO",
      "var_a": "API-8100001234",
      "var_b": null
    },
    "answers": []
  }
}

400

Missing required parameters

application/json

Example

{
  "status": false,
  "error": true,
  "description": "Missing params, please verify or contact to support"
}

401

Your key auth is not valid

application/json

Example

{
  "status": false,
  "error": true,
  "description": "Your key auth is not valid, please check with your administrator to get the new key"
}