> For the complete documentation index, see [llms.txt](https://www.docpartner.dev/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://www.docpartner.dev/api/sms-partner/statut-et-statistiques/statut-multiple.md).
# Statut multiple
## URL
`POST` `https://api.smspartner.fr/v1/multi-status`
{% hint style="info" %}
Les comptes-rendus sont habituellement reçus en quelques secondes après l'envoi du SMS. Cependant, selon les opérateurs et la charge de notre plateforme, ce délai peut parfois aller jusqu'à 48 heures.
{% endhint %}
#### **Paramètres obligatoires**
#### Requêtes
{% tabs %}
{% tab title="PHP" %}
```php
'YOUR API KEY',
'SMSStatut_List'=>>array(
array('phoneNumber'=>'+336xxxxxxxx','messageId'=>messageId1),
array('phoneNumber'=>'+336xxxxxxxx','messageId'=>messageId2)
)
);
$curl = curl_init();
curl_setopt($curl, CURLOPT_URL,'https://api.smspartner.fr/v1/multi-status');
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
curl_setopt($curl, CURLOPT_TIMEOUT, 10);
curl_setopt($curl, CURLOPT_POST, 1);
curl_setopt($curl, CURLOPT_POSTFIELDS,json_encode($fields));
$result = curl_exec($curl);
curl_close($curl);
// Process your response here
echo $result;
?>
```
{% endtab %}
{% tab title="VB.net" %}
```vbnet
Imports System.IO
Imports System.Net
Module Module1
Sub Main()
Dim base_url As String = "http://api.smspartner.fr/v1/"
Dim apiKey As String = "VOTRE_APIKEY"
#send sms
url = base_url & "multi-status"
#note : utiliser une librairie JSON en production, par exemple :
#https//www.nuget.org/packages/Newtonsoft.Json/
Dim parameters As String = String.Format(
"{{""apiKey"":""{0}"",""SMSStatut_List"":""{1}""}}",
apiKey,
{{ ""phoneNumber"":"06xxxxxxx1",""messageId"":"msgId1"},{ ""phoneNumber"":"06xxxxxxx2",""message"":"msgId2"}}
)
Console.Write(parameters)
apiRequest("POST", url, parameters)
End Sub
Function apiRequest(method As String, url As String, parameters As String) As String
Dim request As HttpWebRequest
request = WebRequest.Create(url)
request.Method = method
request.Timeout = 10000 # timeout in ms
request.ContentType = "application/json; charset=utf-8"
request.ContentLength = 0
#set POST data
If Not String.IsNullOrEmpty(parameters) Then
request.ContentLength = parameters.Length
Using reqStream As StreamWriter = New StreamWriter(request.GetRequestStream())
reqStream.Write(parameters)
End Using
End If
#get response
Dim returnValue As String = Nothing
Using response As HttpWebResponse = request.GetResponse()
If response.StatusCode = HttpStatusCode.OK Then
Using resStream = response.GetResponseStream()
If resStream IsNot Nothing Then
Using reader As New StreamReader(resStream)
returnValue = reader.ReadToEnd()
End Using
End If
End Using
End If
End Using
apiRequest = returnValue
End Function
End Module
```
{% endtab %}
{% tab title="Python" %}
```python
# std
import logging
import json
from collections import OrderedDict
# 3p
import requests
API_KEY = "MY API KEY"
URL = "https://api.smspartner.fr/v1"
class SMSPartner():
def send_sms(self,phone_number, phone_number2, msgId1, msgId2):
print(phone_number)
data = {"apiKey":APIKEY,"SMSStatut_List":[{"phoneNumber":phone_number,"messageId":msgId1},{"phoneNumber":phone_number2,"messageId":msgId2}]}
url = URL + "/multi-status"
r = requests.post(url, data=json.dumps(data), verify=False)
r_json = r.json()
if r_json.get("success") == True:
print(r_json)
status = True
else:
print("SMS msg {} not delivered to {}".format(msg, phone_numbers))
status = False
return status
```
{% endtab %}
{% tab title="cURL" %}
```
curl -X POST https://api.smspartner.fr/v1/multi-status -H "Content-Type: application/json" -d '{"apiKey": "Votre clé API","SMSStatut_List": [{"phoneNumber": "0619922264", "messageId": 199897},{"phoneNumber": "06xxxxxxx2", "messageId": 1000},{"phoneNumber": "06xxxxxxx1", "messageId": 1222}]}'
```
{% endtab %}
{% endtabs %}
#### **Réponse**
{% tabs %}
{% tab title="json" %}
{% code fullWidth="true" %}
```json
{
"success": true,
"code": 200,
"StatutResponse_List": [
{
"success": true,
"code": 200,
"phoneNumber": "+33699999993",
"messageId": 111111,
"status": "Delivered",
"date": "1517934416",
"stopSms": "0",
"isSpam": "0"
},
{
"success": false,
"code": 4,
"phoneNumber": "+33699999992",
"messageId": 1000,
"status": "Numéro introuvable"
},
{
"success": false,
"code": 4,
"phoneNumber": "+33699999991",
"messageId": 1222,
"status": "Numéro introuvable"
}
]
}
```
{% endcode %}
{% endtab %}
{% tab title="xml" %}
```xml
true200true2001226613false41000false41222
```
{% endtab %}
{% endtabs %}
* Delivered (Livré) : Ce statut indique que le message a été livré avec succès au destinataire. Cela signifie que le message a été envoyé correctement et qu’il a été reçu sur l’appareil ou la plateforme du destinataire. La date et l’heure de la réception est normalement disponible.
* Not delivered (Non livré) : Ce statut fait référence aux messages qui n’ont pas pu être livrés au destinataire. Il peut y avoir plusieurs raisons pour lesquelles un message n’est pas livré : comme un numéro de téléphone non valide ou un problème opérateurs chez un opérateur.
* Waiting (En attente) : Ce statut indique que le message est en cours de livraison et qu’il n’a pas encore été confirmé s’il sera livré ou non. Cela peut se produire en cas de retards sur le réseau ou lorsque des confirmations supplémentaires sont nécessaires avant de pouvoir marquer le message comme livré ou non livré.
#### Erreurs
{% tabs %}
{% tab title="json" %}
```json
{
"success": false,
"code": 10,
"message": "Clé API incorrecte"
}
```
{% endtab %}
{% tab title="xml" %}
```xml
false10Clé API incorrecte
```
{% endtab %}
{% endtabs %}
#### **Code erreurs**
| Code de réponse | Réponse |
| --------------- | ---------------------- |
| 1 | La Clé API est requise |
| 4 | Message introuvable |
| 10 | Clé API incorrecte |
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://www.docpartner.dev/api/sms-partner/statut-et-statistiques/statut-multiple.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.