Lister l’inventaire des numéros achetés

Lister les enregistrements des numéros achetés dont le propriétaire enregistré correspond au compte associé à vos identifiants d’API. La présence d’un enregistrement ne signifie pas qu’un test d’appel en conditions réelles a réussi.

Requête

Utilisez des identifiants d’API côté serveur via HTTPS. Les exemples lisent les identifiants depuis des variables d’environnement ; ils ne contiennent aucun identifiant utilisable. Vérifiez status.code dans le corps JSON ainsi que le statut HTTP. Ces gestionnaires historiques ne définissent pas systématiquement un statut d’erreur HTTP en cas d’erreur applicative.

curl --user "$MULTITEL_API_USER:$MULTITEL_API_PASSWORD" \
  "https://api.multitel.net/v3/inventory"

Pour filtrer sur un seul numéro de téléphone enregistré, utilisez la variante facultative du chemin :

curl --user "$MULTITEL_API_USER:$MULTITEL_API_PASSWORD" \
  "https://api.multitel.net/v3/inventory/12025550100"

Utilisez le numéro de téléphone international enregistré sous forme de chiffres, indicatif du pays compris. Ne transmettez pas à sa place une extension PBX, un UUID de numéro, un identifiant de zone ou un identifiant de préfixe. Le numéro fourni sélectionne un enregistrement existant ; il ne permet ni d’acheter ni de configurer un numéro.

Réponse

Le membre response est toujours un tableau en cas de succès, y compris avec la variante du chemin pour un seul numéro. status.results correspond à la longueur du tableau.

Cet exemple illustre la structure de la réponse ; il ne contient ni données de compte ni devis tarifaire actuel.

{
  "status": {
    "code": 200,
    "msg": "",
    "results": 1
  },
  "response": [
    {
      "number": "12025550100",
      "uuid": "NUMBER_UUID",
      "description": "Main reception",
      "isocode": "US",
      "config": {
        "uri": "sip:reception@example.com",
        "uri2": "",
        "uri3": "",
        "forward_destination": "",
        "sms_uri": "",
        "sms_forward_destination": ""
      },
      "features": {
        "voice": "1",
        "sms": "1",
        "mms": "0"
      },
      "status": {
        "capacity": {
          "assigned_channels": "2",
          "used_channels": "0",
          "overflow": "0",
          "overage_charge": "0.01"
        },
        "origination": {
          "origination_trunk_id": "ORIGINATION_ID",
          "origination_trunk_name": "ORIGINATION_NAME",
          "origination_country_iso": "US",
          "origination_continent_iso": "NA",
          "origination_continent_name": "North America"
        },
        "service_active": "1",
        "force_codec": "",
        "force_dtmf": ""
      },
      "billing": {
        "cnam": "0",
        "overflow": "0",
        "autorenew": "1",
        "persistent": "0",
        "date_created": "2026-01-01 00:00:00"
      },
      "price": {
        "setup_price": "0.00",
        "monthly_price": "1.00",
        "per_minute": "0.01",
        "free_minutes": "0",
        "remaining_minutes": "0"
      }
    }
  ]
}

Champs renvoyés pour les numéros
Champ	Signification
`number, uuid, description, isocode`	Le numéro de téléphone enregistré, l’identifiant opaque du numéro, la description et le code du pays.
`config`	Champs enregistrés pour les destinations vocales, le renvoi externe, la destination SMS et le renvoi des SMS. Ce point de terminaison ne les modifie pas.
`features`	Indicateurs enregistrés des capacités vocales, SMS et MMS. Il n’est pas garanti que les indicateurs historiques enregistrés soient des booléens JSON.
`status.capacity`	Valeurs des canaux attribués et utilisés, paramètre de débordement et frais de dépassement enregistrés. Il s’agit de métadonnées enregistrées, et non d’un nouveau devis de capacité ou d’un test d’appel en conditions réelles.
`status.origination`	Métadonnées enregistrées sur l’origine des appels. Traitez les identifiants comme opaques ; ne déduisez pas de logique applicative des noms internes.
`status.service_active, force_codec, force_dtmf`	Champs enregistrés d’activation et de configuration des médias. Un indicateur seul ne prouve pas que les appels entrants sont acheminés correctement.
`billing`	Valeurs enregistrées de CNAM, de débordement, de renouvellement, de persistance et de création. Leur consultation ne modifie ni le renouvellement ni les autres paramètres de facturation.
`price`	Tarifs enregistrés de mise en service, mensuels et à la minute, ainsi que les quotas de minutes. Le gestionnaire ne fournit ni champ de devise ni nouveau devis. Ne déduisez pas la devise des valeurs d’exemple et ne les utilisez pas comme devis d’achat actuel.

Filtrage et pagination

Ce gestionnaire ne prévoit ni pagination, ni limite de taille de page, ni ordre de tri explicite. Il renvoie tous les enregistrements non annulés sélectionnés par sa requête. Il ne propose ni filtre limité aux numéros dont le service est actif, ni vue distincte des numéros archivés. Ne supposez pas que l’ordre des enregistrements renvoyés est stable.

Aucun numéro correspondant

Si le compte ne comporte aucun enregistrement non annulé correspondant, le corps JSON contient status.code à la valeur 404 et un message contenant no numbers found. Il ne renvoie pas un tableau vide avec un statut de succès. Le message comporte un suffixe de référence au code source que les clients ne doivent pas analyser comme un identifiant stable.

Étapes suivantes

Utilisez numberinfo lorsque vous avez besoin des champs historiques supplémentaires d’enregistrement et de référence pour un numéro donné. Vérifiez les destinations vocales et de messagerie avant de modifier un routage au moyen d’une opération de configuration distincte.