List texts

list_site_message_sends

Lists the texts a site sent, newest first, with their status, credits and errors.

POST /v1/list_site_message_sendsScopeconfig:readRead only

Each text has its template, number, country, channel, status, credits, the included credits it used (includedCredits, with included true when they paid all of it), parts and why it failed. filter keeps texts that are in-progress, delivered, failed or cancelled, and phone finds the texts to one number. Pass nextCursor back as cursor for the next page. Texts stay in the history for 90 days. See History.

Request

Call it with a POST to https://api.modulify.ai/v1/list_site_message_sends, sending the inputs below as a JSON object. The token needs the config:read scope.

It only reads and changes nothing, so retrying it is safe.

curl -X POST https://api.modulify.ai/v1/list_site_message_sends \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"projectId":"PROJECT_ID"}'

Over MCP, the same method is the list_site_message_sends tool.

Inputs

Input Type Required Description
projectId string Yes The site id.
filter string No all, the default, in-progress, delivered, failed or cancelled.
phone string No A phone number, or part of one.
limit integer No How many texts to a page, 25 by default and 100 at most.
cursor string No nextCursor from the previous page.

Response

Every call answers with the JSON envelope of success, message, data, code and version. data holds the result described above, and on a method that returns a total, count carries it. The response headers carry the call's X-Request-Id and what is left of your per-minute budget in X-RateLimit-Limit, X-RateLimit-Remaining and X-RateLimit-Reset. Errors explains every status code a call can answer with.