Get delivery report | QuantumTec API reference

POST request

POST request
Parameter	Description
`messageId`stringoptional	Message ID. When omitted, returns available delivery reports.
`Limit`integeroptional	Maximum reports to return. Default: 50. Maximum: 500.

curl --request POST 'https://api.quantumtec.eu/v1/sms/report' \
  --header 'X-ApiKey: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --header 'Accept: application/json' \
  --data '{
  "messageId": "19905880-9404-4686-a8af-54af8888b96d",
  "Limit": 50
}'

Response

The response is an array of reports. Match SMS parts by partId and read state for each part's delivery result. state 2 means Delivered.

Response
Parameter	Description
`messageId`string	Message identifier.
`to`number	Recipient number in the published response example.
`partId`string	Identifier of an SMS part.
`state`integer	Delivery state, 2–8.
`delivered`string	Time the delivery report was received, in UTC.
`errorCode`string	Operator error code; not supported by every operator.

[
  {
    "messageId": "19905880-9404-4686-a8af-54af8888b96d",
    "to": 37250000000,
    "partId": "300000005",
    "state": 2,
    "delivered": "2026-09-01T10:00:02.000Z",
    "errorCode": "000"
  }
]

GET alternative

GET uses the same messageId and Limit parameters in the URL query string, together with X-ApiKey. It returns the same report structure.

curl --get 'https://api.quantumtec.eu/v1/sms/report' \
  --header 'Accept: application/json' \
  --data-urlencode 'X-ApiKey=YOUR_API_KEY' \
  --data-urlencode 'messageId=19905880-9404-4686-a8af-54af8888b96d' \
  --data-urlencode 'Limit=50'