Список номерів у проєкті перенесення

Доступ до облікового запису та проєкту

Використовуйте ввімкнений обліковий запис API через HTTPS з дозволеної IP-адреси. Проєкт має належати цьому обліковому запису й не бути видаленим. Використовуйте унікальний ідентифікатор проєкту з процесу замовлення перенесення номерів, а не його числовий ідентифікатор у базі даних чи номер телефону. Під час формування запиту застосовуйте URL-кодування до ідентифікатора проєкту.

Запит

curl --silent --show-error --user "$API_USER:$API_PASSWORD" \
  "https://api.multitel.net/v3/lnp/project/$PROJECT_ID/numbers"

Відповідь

Вигаданий приклад відповіді.

{
  "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 — це список. Наявний проєкт без номерів повертає порожній список із кодом API 200 і значенням status.results, що дорівнює 0. Натомість відсутні проєкти повертають код API 404.

Поля номерів

Поля номерів для перенесення
Поле	Значення
id, number, isocode	Числовий ідентифікатор рядка, збережений текст номера телефону та код країни. Ідентифікатор рядка не є ідентифікатором проєкту.
status, status_str	Числовий статус і його відома мітка.
foc	Збережене значення планування остаточного зобов’язання за замовленням. Воно може бути порожнім; обробник не перетворює його на документований часовий пояс чи формат позначки часу.
updated, date_created, date_completed	Збережені значення оновлення, створення та завершення. Явно обробляйте порожні значення; не припускайте формат ISO8601 і не визначайте часовий пояс за вигаданим прикладом.
comment	Збережений коментар для клієнта. Відображайте його як текст, а не як виконуваний HTML.

Це представлення даних не містить поля internal_comment, призначеного лише для працівників. Це не означає, що окремий застарілий пошук одного номера використовує те саме представлення.

Порядок і моніторинг

Запит упорядковує результати за часом створення за зростанням. Для рядків з однаковим часом створення жодного додаткового порядку не гарантовано. Немає поділу на сторінки, інкрементального курсора чи фільтра за датою. Прочитайте весь список для звірки даних проєкту й не вважайте його поточну кількість рядків постійним каталогом.

Тлумачення статусу перенесення

Відомі значення статусу номерів
Значення	Мітка
0	Pending
1	In Progress
2	Completed
9	Rejected

Зберігайте числовий статус і враховуйте невідомі значення. Для невідомих міток використовується збережене значення без гарантії нової мітки. Збережений статус завершення чи запланована дата самі по собі не перевіряють маршрутизацію вхідних викликів або всі послуги номера.

Помилки й обмеження

Перевіряйте і відповідь HTTP, і status.code/status.msg. Відсутній, видалений або чужий проєкт повертає код API 404 з повідомленням про те, що проєкт не знайдено. Також діють обмеження автентифікації та вихідної IP-адреси. Приклади не виконують реального запиту, а успішна відповідь не доводить, що оператор прийняв чи завершив перенесення.

Наслідки

Перевірений обробник лише читає проєкт і його збережені рядки номерів. Відповідь — це знімок даних, а не підтвердження оператора чи реальний тест послуги. Вона не розпочинає перенесення, не змінює маршрутизацію й не списує коштів з облікового запису.