Endpoint: fecha de creación probable de una línea móvil

Con el número de una línea móvil colombiana devuelve una sola cosa: la fecha probable de su creación. No pide documento ni titular. Es una cota inferior —la línea existía en esa fecha o antes, y puede ser bastante más antigua— y no todas las líneas tienen fecha: cuando no hay ninguna, el campo llega en null.

POST/api/telefono1 crédito

La fecha probable de creación de una línea móvil colombiana. Responde en segundos, por número, sin documento ni titular. ⚠️ Es una fecha PROBABLE y una cota inferior: la línea existía en esa fecha o antes, y puede ser bastante más antigua. ⚠️ No todas las líneas tienen fecha: cuando no hay ninguna, fechaCreacionProbable llega en null y la consulta cobra igual —es una respuesta válida—. 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": "telefono",
  "status": "info",
  "data": {
    "numero": "3001234567",
    "fechaCreacionProbable": "2024-04-16"
  },
  "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: 9 de septiembre de 2026 · PlacApi opera desde Colombia. PlacApi no es una entidad oficial del Gobierno.