Location réutilisable · REST + MCP

Un numéro qui reste le vôtre

Louez un numéro privé pour une journée ou plus et continuez à recevoir des messages tout du long. Regardez quels intervalles sont disponibles et à quel prix, louez-en un, puis prolongez-le si la tâche s'éternise ou annulez-le quand vous avez fini.

Connecter votre client IA Aller au démarrage rapide REST
Durée de vie
Un jour ou plus
Ce que vous obtenez
Plusieurs SMS
Idéal pour
Les sessions, les tests et l'accès continu
800+ services couverts
200+ pays disponibles
Sans inscription pour voir les prix
Au numéro jamais d'abonnement

Commencez à construire

Obtenez votre clé d'API en moins d'une minute

Inscrivez-vous avec une adresse e-mail : sans carte, sans appel commercial. Le lien de connexion vous ramène directement sur cette page et vous remet une clé qui fonctionne avec l'API REST comme avec le serveur MCP.

La création est gratuite. Vous payez au numéro, jamais d'abonnement.

Comment ça marche

Quatre étapes, du début à la fin

Chaque étape ci-dessous correspond à de vrais endpoints et de vrais outils. Conservez l'id renvoyé par l'achat : tout ce qui suit en dépend.

  1. 1

    Consultez l'inventaire en direct

    Listez les services, les pays et les intervalles de location avec leurs prix exacts actuels en USD.

    GET /v1/sms/rental/servicesGET /v1/sms/rental/countriesGET /v1/sms/rental/intervals sms_rental_list_servicessms_rental_list_countriessms_rental_list_intervals
  2. 2

    Louez pour un intervalle

    Choisissez le solde prépayé ou le x402 sans compte, puis conservez l'id de location renvoyé.

    POST /v1/sms/rental/numbers sms_rental_buy_number
  3. 3

    Collectez les messages

    Interrogez le numéro pendant toute la location et utilisez les curseurs pour récupérer plusieurs messages sans doublons.

    GET /v1/sms/rental/numbers/{id}/codes sms_rental_get_codes
  4. 4

    Annulez ou prolongez

    Annulez tant que le remboursement est possible, ou listez les prolongations disponibles avec leurs prix et prolongez une location active.

    POST /v1/sms/rental/numbers/{id}/cancelGET /v1/sms/rental/numbers/{id}/extend-optionsPOST /v1/sms/rental/numbers/{id}/extend sms_rental_cancelsms_rental_list_extend_optionssms_rental_extend

Une seule configuration

Installez Voxisim dans votre client IA

Connectez l'endpoint hébergé et votre agent pourra comparer les prix, acheter un numéro et vous transmettre le code sans que vous écriviez la moindre requête. Rien à installer : pas de paquet, pas de serveur local, pas de conteneur — juste une URL et une connexion dans le navigateur.

Endpoint hébergé https://api.voxisim.com/mcp
Streamable HTTP · OAuth ou clé bearer
  1. 01

    Ajoutez l'endpoint

    Choisissez votre client ci-dessous et copiez le bloc dont il a besoin.

  2. 02

    Connectez-vous une fois

    Validez l'invite OAuth du navigateur, ou transmettez une clé vxs_ depuis votre gestionnaire de secrets si vous préférez éviter OAuth.

  3. 03

    Demandez, c'est tout

    Votre agent choisit les bons outils et fait circuler les ids entre eux : une seule phrase couvre tout le cycle.

Claude

Web + bureau

OAuth

Ouvrez Paramètres → Connecteurs, ajoutez un connecteur personnalisé nommé Voxisim, puis collez l'endpoint hébergé.

Aucun fichier de configuration 
https://api.voxisim.com/mcp

Cliquez sur Connecter et terminez la connexion dans le navigateur. Activez Voxisim depuis la recherche et les outils de votre conversation.

Déroulé de l'agent

Ce que fait réellement votre agent

Les outils sont typés et nommés selon leur tâche : les résultats reviennent en champs structurés plutôt qu'en texte que l'agent doit relire. Les achats peuvent puiser dans votre solde ou répondre par un défi de paiement que votre agent règle depuis un wallet.

9 outils pour ce produit

  • sms_rental_list_services
  • sms_rental_list_countries
  • sms_rental_list_intervals
  • sms_rental_buy_number
  • sms_rental_get_codes
  • sms_rental_list_numbers
  • sms_rental_cancel
  • sms_rental_list_extend_options
  • sms_rental_extend

Essayez de demander à votre agent

Compare les intervalles de location disponibles pour WhatsApp aux États-Unis et montre-moi les prix exacts.
Loue un numéro pour l'intervalle disponible le plus court, puis surveille les nouveaux messages.
Liste mes locations actives et prolonge celle qui expire le plus tôt d'un intervalle disponible.

REST

Démarrage rapide REST

La découverte est publique — vous pouvez exécuter le premier bloc tout de suite, sans compte. L'achat demande soit une clé prépayée, soit un paiement x402 signé, et le corps de la requête est identique dans les deux cas.

Deux façons de payer, un seul appel d'achat

Le solde prépayé est plus simple si vous achetez souvent. Le x402 sans compte convient mieux à un achat autonome ponctuel — conservez le receipt_token de la première réponse payée pour relire ensuite ce que vous avez acheté.

1. Explorez gratuitement

Aucun compte requis. Récupérez la disponibilité en direct et les prix exacts avant d'acheter.

curl 'https://api.voxisim.com/v1/sms/rental/services'
curl 'https://api.voxisim.com/v1/sms/rental/countries?service_id=SERVICE_ID'
curl 'https://api.voxisim.com/v1/sms/rental/intervals?service_id=SERVICE_ID&country_id=COUNTRY_ID'

2A. Utilisez un solde prépayé

Créez un compte une fois, alimentez-le via x402, puis utilisez la clé vxs_ renvoyée pour vos achats.

curl -X POST https://api.voxisim.com/v1/signup \
  -H 'content-type: application/json' \
  -d '{"label":"docs-quickstart"}'

curl -X POST https://api.voxisim.com/v1/sms/rental/numbers \
  -H 'authorization: Bearer YOUR_VXS_API_KEY' \
  -H 'content-type: application/json' \
  -d '{"service_id":"SERVICE_ID","country_id":COUNTRY_ID,"hours":HOURS}'

2B. Ou payez sans compte avec x402

Envoyez l'achat sans identifiants, signez l'une des exigences de la réponse 402, puis répétez la même requête.

curl -i -X POST https://api.voxisim.com/v1/sms/rental/numbers \
  -H 'content-type: application/json' \
  -d '{"service_id":"SERVICE_ID","country_id":COUNTRY_ID,"hours":HOURS}'

curl -X POST https://api.voxisim.com/v1/sms/rental/numbers \
  -H 'content-type: application/json' \
  -H 'X-PAYMENT: BASE64_SIGNED_AUTHORIZATION' \
  -d '{"service_id":"SERVICE_ID","country_id":COUNTRY_ID,"hours":HOURS}'

3. Récupérez les messages

Interrogez le numéro pendant toute la location ; utilisez last_id pour ne récupérer que les messages plus récents.

curl 'https://api.voxisim.com/v1/sms/rental/numbers/YOUR_RENTAL_ID/codes' \
  -H 'authorization: Bearer YOUR_VXS_API_KEY'
Méthode Route Ce qu'elle fait
GET /v1/sms/rental/services Lister les services louables
GET /v1/sms/rental/countries Lister les pays pour un service
GET /v1/sms/rental/intervals Lister les intervalles et les prix exacts
POST /v1/sms/rental/numbers Louer un numéro
GET /v1/sms/rental/numbers Lister les locations actives ou archivées
GET /v1/sms/rental/numbers/{id}/codes Récupérer les SMS reçus
POST /v1/sms/rental/numbers/{id}/cancel Annuler une location active
GET /v1/sms/rental/numbers/{id}/extend-options Lister les durées et prix de prolongation
POST /v1/sms/rental/numbers/{id}/extend Prolonger une location active

Notes d'exploitation

Remboursements, expiration et reprise propre

L'expiration et les ratés d'un fournisseur sont des états normaux, pas des exceptions. Branchez sur l'erreur typée, relancez la découverte avant de réessayer et ne supposez jamais que le prix du dernier appel tient toujours.

Les intervalles viennent de la découverte

Les durées et les prix ne forment pas un menu figé : ils viennent de la découverte d'intervalles en direct. La valeur hours envoyée à l'achat doit correspondre à l'une des options réellement proposées à ce moment-là.

Lisez les messages sans doublons

Interrogez avec last_id pour que chaque appel ne renvoie que du nouveau, et gardez l'id de la location — il vous servira pour annuler ou prolonger.

Annulez tôt, prolongez tard

Annulez dans la fenêtre ouvrant droit au remboursement si le numéro ne vous sert plus, ou prolongez une location active de n'importe quel intervalle encore disponible pour elle.

Quand quelque chose se passe mal

  • invalid_argument — votre service, pays ou intervalle est périmé. Relancez la découverte et envoyez une combinaison actuellement valide.
  • payment_required — attendu sur la voie x402. Signez l'une des exigences proposées et répétez la requête à l'identique.
  • number_unavailable ou un conflit — cette option vient d'être épuisée. Relancez la découverte et prenez-en une autre plutôt que de rejouer le même achat.
  • provider_unavailable ou limitation de débit — patientez et respectez l'indication de réessai fournie dans l'erreur. Réessayer immédiatement aggrave la situation.

Encore hésitant ?

Activation et location résolvent des problèmes différents

Prenez la durée de vie la plus courte qui couvre encore votre besoin. Le stock et les prix sont en direct pour les deux.

Activation SMS

Achetez un numéro de téléphone à usage unique et recevez son code de vérification.

  • Environ 20 minutes
  • Un code de vérification
  • La vérification de comptes et les flux OTP
Lire le guide Activation SMS

Location SMS

Vous êtes ici

Louez un numéro de téléphone pour la durée de votre choix et recevez ses SMS.

  • Un jour ou plus
  • Plusieurs SMS
  • Les sessions, les tests et l'accès continu

Où la location a sa place

Sessions à plusieurs messagesTests d'intégration longsAccès continu à un compteBoîtes surveillées par un agent

FAQ

Questions sur la location

  • Une journée au minimum, et les intervalles plus longs partent de là. Demandez à l'endpoint des intervalles ce qui est réellement proposé pour votre service et votre pays plutôt que de supposer un jeu figé — les options varient.

  • Autant qu'il en arrive pendant la location. C'est toute la différence avec une activation, qui s'arrête après un code.

  • Passez last_id lors de vos appels. Chaque appel ne renvoie alors que les messages plus récents que celui que vous avez déjà : vous pouvez interroger souvent sans dédoublonner de votre côté.

  • Oui, tant qu'elle est active, avec n'importe quel intervalle encore disponible pour elle. Prolonger coûte moins cher et perturbe moins que louer un nouveau numéro, puisque le numéro lui-même ne change pas.

  • Une annulation dans la fenêtre éligible rembourse la location. En dehors de cette fenêtre, la location va simplement au bout de son terme — annulez donc dès que vous savez que vous avez terminé.

  • Oui. La voie x402 fonctionne exactement comme pour les activations : envoyez l'achat, signez le défi qui revient et répétez la requête à l'identique.

Référence

Les contrats générés

Cette page explique le déroulé. Pour chaque paramètre, champ de réponse et entrée d'outil, allez voir la référence : elle est générée à partir du contrat en vigueur et ne peut donc pas diverger.

API interactiveExplorez les opérations dans Scalar REST en MarkdownGénéré depuis OpenAPI MCP en MarkdownGénéré depuis les métadonnées des outils OpenAPI JSONContrat lisible par machine

Prêt à acheter votre premier numéro ?

Connectez un client MCP et demandez-lui, ou copiez le démarrage rapide REST et exécutez-le.

Ouvrir la référence de l'API Comparer les deux produits