Consulter un numéro acheté

Consultez la fiche d’un numéro acheté et sa configuration enregistrée. Cette opération renvoie un objet plutôt que le tableau renvoyé par le point de terminaison inventory.

Requête

Utilisez des identifiants d’API côté serveur via HTTPS. Les exemples lisent les identifiants dans des variables d’environnement ; ils ne contiennent aucun identifiant fonctionnel. Vérifiez status.code dans le corps JSON ainsi que le statut HTTP. Ces anciens gestionnaires 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/numberinfo/12025550100"

Le segment de chemin obligatoire est le numéro de téléphone international enregistré, et non son UUID ni un numéro de poste PBX. Ce gestionnaire n’utilise aucun paramètre de requête ni corps de requête.

Réponse

Cette structure de réponse est fournie à titre d’exemple ; elle ne représente ni les données d’un compte ni un devis actualisé.

{
  "status": {
    "code": 200,
    "msg": ""
  },
  "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",
      "perminute_charges": "0"
    },
    "needs_registration": "0",
    "vrating": "",
    "country_id": "COUNTRY_REFERENCE",
    "area_id": "AREA_REFERENCE",
    "provider_id": "OPAQUE_LEGACY_REFERENCE"
  }
}

Champs du numéro renvoyés
Champ	Signification
`number, uuid, description, isocode`	Le numéro de téléphone enregistré, son identifiant opaque, sa description et son code pays.
`config`	Champs enregistrés concernant les destinations des appels vocaux, le renvoi externe, la destination des SMS et le renvoi des SMS. Ce point de terminaison ne les modifie pas.
`features`	Indicateurs enregistrés des fonctionnalités voix, SMS et MMS. Les anciens indicateurs enregistrés ne sont pas nécessairement 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 devis actualisé de capacité ni d’un test d’appel en direct.
`status.origination`	Métadonnées enregistrées relatives à l’origine des appels. Traitez les identifiants comme des valeurs opaques ; ne déduisez pas la logique de votre application 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 communications entrantes sont correctement acheminées.
`billing`	Valeurs enregistrées concernant le CNAM, le débordement, le renouvellement, la persistance et la création. Leur consultation ne modifie ni le renouvellement ni les autres paramètres de facturation.
`price`	Tarifs enregistrés de mise en service, d’abonnement mensuel et à la minute, ainsi que les quotas de minutes. Le gestionnaire ne fournit aucun champ de devise ni devis actualisé. Ne déduisez pas la devise des valeurs d’exemple et ne les utilisez pas comme devis d’achat actuel.

Par rapport à inventory, ce point de terminaison renvoie également needs_registration, vrating, country_id, area_id, provider_id et price.perminute_charges. Il s’agit d’anciennes valeurs enregistrées, et non d’une réponse distincte d’approbation de l’identité. Les identifiants de référence doivent être traités comme des valeurs opaques ; ne construisez pas d’URL de découverte et n’en déduisez pas de correspondances avec des fournisseurs sans disposer de la réponse de découverte appropriée.

Aucun numéro correspondant

Si aucune fiche correspondante non annulée n’est trouvée pour le compte authentifié, le corps JSON contient status.code 404 et un message contenant number not found. Ne vous fiez pas au suffixe indiquant la ligne du code source. Vérifiez le numéro enregistré et inventory avant de réessayer.

Utiliser le résultat

Cette opération consulte les données enregistrées. Elle n’achète pas de numéro, n’approuve pas de documents d’identité, ne modifie pas de destination et ne garantit pas qu’un appel, un fax ou un message sera acheminé. Testez séparément chaque service activé lors de la configuration d’un numéro.