Messaging

Get an SMS send

Returns the status and charge of one SMS send.

GEThttps://api.klasstack.com/v1/messaging/sms/{id}

  • messaging:read
  • Billable
  • Test key: example response

Authorizations

  • Authorizationstringheaderrequired

    Your secret key as a bearer token, in the form Bearer ks_live_sk_... or Bearer ks_test_sk_.... Keep it on your server. A test key gets the documented example and touches no school data.

Path Parameters

  • idstringpathrequired

    Example: 18

Response

200, application/json

  • dataobjectrequired

    Show child attributes
    • idnumberrequired

    • statusstringrequired

    • pagesnumberrequired

      SMS pages per recipient.

    • recipientCountnumberrequired

      Recipients the message was accepted for.

    • skippedCountnumber or nullrequired

      Recipients named but not sent to (no number on record, or a suppressed number). Null on a status read.

    • chargenumberrequired

      The in-app SMS charge held on the SERVICE wallet, in major units.

    • currencystringrequired

    • pendingCountnumberrequired

    • sentCountnumberrequired

    • deliveredCountnumberrequired

    • failedCountnumberrequired

    • failureReasonstring or nullrequired

    • createdOnstringrequired

  • metaobjectrequired

    Show child attributes
    • request_idstringrequired

      Also returned in the X-Request-ID header.

    • paginationobject

      Show child attributes
      • limitintegerrequired

        Required range: x <= 100

      • has_morebooleanrequired

      • next_cursorstring or nullrequired

        Send this back as cursor for the next page. Opaque: never parse it.

Errors

What each code means, and what to do about it, is in the errors guide.

Webhook events

This call triggers no webhook event.