# Read the text message log

Every SMS and iMessage this workspace sent or received, newest first, across every thread. Narrow with direction, or with definitionId + rowId for one record's texts. Start here for "what have we texted them".

Access class: `workspace`.

## Endpoint

`GET /v1/comms/texts`

## Parameters

| Name | In | Type | Required |
| --- | --- | --- | --- |
| body | query | null | No |
| params | query | object | No |
| query | query | object | No |

## Responses

### 200

the action's answer

Content type: `application/json`.

```json
{
  "texts": [
    {
      "contact_identifier": "string",
      "contact_name": "string",
      "content": "string",
      "conversation_id": 1.5,
      "delivery": {
        "attempts": 1.5,
        "claimed_by": "string",
        "error": "string",
        "next_attempt_at": "string",
        "state": "string"
      },
      "direction": "string",
      "id": 1.5,
      "is_deleted": true,
      "medium": "string",
      "occurred_at": "string",
      "recorded_at": "string",
      "sender_id": 1.5,
      "sender_name": "string",
      "sender_type": "string",
      "status": "string",
      "text": {
        "error_code": "string",
        "error_message": "string",
        "media_count": 1.5,
        "provider": "string",
        "segment_count": 1.5
      }
    }
  ],
  "total": 1.5
}
```

### default

a refusal: `{"error": "<what a person needs to read>"}`. 401 no credential, 402 the plan does not include this, 403 the seat does not, 404 the thing does not exist or is not yours to see.

Content type: `application/json`.

```json
{
  "error": "string"
}
```