Meddelanden

Varje mottagare i en batch får ett eget meddelandedokument. Listan visar den senaste statusen; ett enskilt dokument visar hela statushistoriken.

Endpoints

Metod	Sökväg	Beskrivning
GET	/v2/batches/{batchId}/messages	Lista alla meddelanden i batchen.
GET	/v2/batches/{batchId}/messages/{messageId}	Läs ett meddelande och dess statushistorik.

Lista meddelanden

curl "https://api.ip1sms.com/v2/batches/{batchId}/messages" \
  -H "Authorization: Bearer $IP1_TOKEN" \
  -H "Accept: application/json"

Resultatet är kronologiskt och paginerat. Varje dokument innehåller den senaste tillgängliga statusen.

Läs ett meddelande

curl "https://api.ip1sms.com/v2/batches/{batchId}/messages/{messageId}" \
  -H "Authorization: Bearer $IP1_TOKEN" \
  -H "Accept: application/json"

Svaret för ett enskilt meddelande innehåller hela statuses-listan.

Exempel på meddelandedokument

{
  "id": "message_abc123",
  "batchId": "batch_abc123",
  "owner": "ip1-XXXXX",
  "sender": "DittForetag",
  "recipient": "46700000000",
  "body": "Din bokning är bekräftad.",
  "direction": "MT",
  "segments": 1,
  "type": "sms",
  "datacoding": "ucs",
  "priority": 1,
  "price": 0.0416,
  "currency": "SEK",
  "statuses": [
    {
      "created": "2026-10-05T08:03:21Z",
      "code": 201,
      "duration": 0
    }
  ],
  "modified": "2026-10-05T08:03:21Z",
  "reference": "order-123",
  "mcc": "240",
  "mnc": "01"
}

Fält

Fält	Typ	Beskrivning
id	string	Meddelandets unika ID.
batchId	string	Överliggande batch.
owner	string	Ägande SMS-konto.
sender	string	Meddelandets avsändare.
recipient	string	Mottagarens MSISDN.
body	string	Slutlig meddelandetext för mottagaren.
direction	string	MT för utgående, MO för inkommande.
segments	integer	Antal SMS-segment.
type	string	Meddelandetyp.
datacoding	string	Minsta kodning som behövs, gsm eller ucs.
priority	integer	Leveransprioritet.
price	number	Total kostnad för meddelandets segment.
currency	string	Prisets valuta.
statuses	object[]	Statushändelser med created, code och duration.
modified	string	Senaste uppdatering i ISO 8601.
reference	string | null	Egen referens från batchen.
mcc	string | null	Mobile Country Code när operatören tillhandahåller det.
mnc	string | null	Mobile Network Code när operatören tillhandahåller det.

Ett meddelande kan bestå av flera debiterade SMS-segment. Dividera inte priset utan att också kontrollera segments. För tolkning av statuses[].code, se statuskoder.