Acceso a la cuenta y al proyecto
Utilice una cuenta API habilitada a través de HTTPS desde una dirección IP permitida. El proyecto debe pertenecer a esa cuenta y no debe estar eliminado. Utilice el identificador único del proyecto procedente del flujo de pedidos de portabilidad, no su identificador numérico de base de datos ni un número de teléfono. Aplique la codificación URL al identificador del proyecto al crear una solicitud.
Solicitud
curl --silent --show-error --user "$API_USER:$API_PASSWORD" \
"https://api.multitel.net/v3/lnp/project/$PROJECT_ID/numbers"Respuesta
Ejemplo ficticio de respuesta.
{
"status": {
"code": 200,
"msg": "Project Numbers",
"results": 1
},
"response": [
{
"id": 21,
"number": "12025550123",
"status": 0,
"status_str": "Pending",
"isocode": "US",
"updated": "2026-10-23 12:00:00",
"foc": "",
"comment": "Example customer-visible note",
"date_created": "2026-10-23 12:00:00",
"date_completed": ""
}
]
}response es una lista. Un proyecto existente sin números devuelve una lista vacía con el código API 200 y un valor de status.results igual a 0. En cambio, los proyectos inexistentes devuelven el código API 404.
Campos de los números
| Campo | Significado |
|---|---|
| id, number, isocode | Identificador numérico de la fila, texto almacenado del número de teléfono y código de país. El identificador de la fila no es el del proyecto. |
| status, status_str | Estado numérico y su etiqueta conocida. |
| foc | Valor de programación almacenado del compromiso firme del pedido. Puede estar vacío; el controlador no lo convierte a una zona horaria ni a un formato de marca de tiempo documentados. |
| updated, date_created, date_completed | Valores almacenados de actualización, creación y finalización. Trate explícitamente los valores vacíos; no dé por supuesto el formato ISO8601 ni deduzca una zona horaria del ejemplo ficticio. |
| comment | Comentario almacenado dirigido al cliente. Muéstrelo como texto, no como HTML ejecutable. |
Esta representación omite el campo internal_comment reservado al personal. Esto no significa que la consulta heredada e independiente de un solo número utilice la misma representación.
Orden y seguimiento
La consulta ordena los resultados por hora de creación ascendente. No se garantiza ningún orden adicional para las filas con la misma hora de creación. No hay paginación, cursor incremental ni filtro de fecha. Lea la lista completa para conciliar los datos de un proyecto y no considere su número actual de filas como un catálogo permanente.
Interpretar el estado de la portabilidad
| Valor | Etiqueta |
|---|---|
| 0 | Pending |
| 1 | In Progress |
| 2 | Completed |
| 9 | Rejected |
Conserve el estado numérico y admita valores desconocidos. Cuando no se conoce una etiqueta, se usa el valor almacenado en lugar de garantizar una etiqueta nueva. Un estado de finalización almacenado o una fecha programada no prueban por sí solos el enrutamiento entrante ni todos los servicios del número.
Errores y límites
Compruebe tanto la respuesta HTTP como status.code/status.msg. Un proyecto inexistente, eliminado o que no pertenece a la cuenta devuelve el código API 404 con un mensaje de proyecto no encontrado. También se aplican las restricciones de autenticación y de IP de origen. Los ejemplos no realizan ninguna solicitud real, y una respuesta correcta no demuestra que un operador haya aceptado o completado una transferencia.
Efectos
El controlador revisado solo lee el proyecto y las filas de números que tiene almacenadas. La respuesta es una instantánea, no una confirmación del operador ni una prueba real del servicio. No inicia una portabilidad, no cambia el enrutamiento ni carga un importe a la cuenta.