List texts
list_site_message_sends
Lists the texts a site sent, newest first, with their status, credits and errors.
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.