Endpoint: operador y portación de línea móvil

Con el número de una línea móvil colombiana devuelve el operador al que está asignada hoy, si registra portaciones y la fecha de la última. Viene del registro oficial de portabilidad numérica móvil y no pide documento ni titular. No entrega si la línea es prepago o pospago ni su antigüedad: esos datos no existen en fuente pública.

POST/api/telefono1 crédito

El operador al que una línea móvil colombiana está asignada HOY —venga o no de una portación—, si el número registra portaciones y la fecha de la última. Viene del registro oficial de portabilidad numérica móvil. Responde en segundos y no pide documento ni titular. ⚠️ NO entrega si la línea es prepago o pospago, ni su antigüedad de activación: ninguno de esos datos existe en una fuente pública. fechaPortacion es la fecha del último cambio de operador —una cota inferior de la edad de la línea—, no su fecha de alta. Cuesta 1 crédito.

Cuerpo de la solicitud

body (JSON)
{
  "numero": "3001234567"
}
Parámetros del cuerpo de la solicitud
CampoTipoQué es
numeroobligatoriostringNúmero de línea móvil colombiana, de 9 a 11 dígitos, sin espacios ni signos. Alias aceptado: `celular`.
refreshbooleanIgnora la caché y vuelve a consultar la fuente oficial. Ojo: una consulta refrescada con datos siempre cobra (el hit de caché no).

Ejemplos por lenguaje

cURL
curl -X POST 'https://placapi.com/api/telefono' \
  -H 'x-api-key: pk_live_TU_CLAVE' \
  -H 'content-type: application/json' \
  -d '{"numero":"3001234567"}'
JavaScript (fetch)
const res = await fetch("https://placapi.com/api/telefono", {
  method: "POST",
  headers: {
    "x-api-key": "pk_live_TU_CLAVE",
    "content-type": "application/json",
  },
  body: JSON.stringify({"numero":"3001234567"}),
});
const data = await res.json();
Python (requests)
import requests

res = requests.post(
    "https://placapi.com/api/telefono",
    headers={"x-api-key": "pk_live_TU_CLAVE"},
    json={"numero":"3001234567"},
)
data = res.json()

Respuesta exitosa

200 OK — ejemplo (placas y documentos ficticios)
{
  "source": "portabilidad-co",
  "status": "info",
  "data": {
    "numero": "3001234567",
    "operador": "TIGO",
    "operadorRazonSocial": "COLOMBIA MÓVIL S.A.",
    "portado": true,
    "fechaPortacion": "2024-04-16",
    "estado": "Retornado al operador asignatario del número",
    "nrn": "143"
  },
  "mode": "live",
  "fetchedAt": "2026-07-24T15:04:05.000Z",
  "cost": 1
}

Errores y cobro

Cuesta 1 crédito cuando devuelve datos. Códigos posibles: 400 401 402 404 429 500 502 — qué significa cada uno, cuál reintentar y cuál cobra, en errores y rate limits. Autenticación por x-api-key: cómo generar la clave.

Última revisión: 8 de septiembre de 2026 · PlacApi opera desde Colombia. PlacApi no es una entidad oficial del Gobierno.

Contacto