---
title: "List and filter conversations"
method: GET
path: "/v4/authvia/conversations"
tags: ["Authvia TXT2PAY"]
---

# List and filter conversations

`GET /v4/authvia/conversations`

## Query parameters

- `merchantId` string, int32 — The merchant ID from NMI. This is only required for partners; for merchants it is ignored.
- `startDate` string, date — The start date to filter.
- `endDate` string, date — The end date to filter.
- `status[]` ConversationStatus[] — The list of conversation statuses to filter.
- `phone` string — The conversation customer's ten-digit phone number. US and CA numbers only.
- `firstName` string — The conversation customer's first name.
- `lastName` string — The conversation customer's last name.
- `minAmount` number, float — The minimum conversation amount to include in the filter.
- `maxAmount` number, float — The maximum conversation amount to include in the filter.

## Response `200`

The list of conversations with optional filters applied.

- object[]
  - `id` string — The Authvia v4 UUID for the conversation.
  - `phone` string — The conversation customer's ten-digit phone number. US and CA numbers only.
  - `date` string, date-time — The creation date for the conversation.
  - `status` 'in progress' | 'expired' | 'completed' — The conversation status.
  - `firstName` string — The conversation customer's first name.
  - `lastName` string — The conversation customer's last name.
  - `recordId` string — The NMI marketplace v4 UUID for the conversation.
  - `expiration` string, date-time — The expiration date for the conversation.
  - `amount` string — The conversation amount in USD.

---

[API](https://skmtc.net/nmi/apis/embedded-components-api.md) · [All operations](https://skmtc.net/nmi/apis/embedded-components-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/nmi/embedded-components-api/revisions/45c2ecda3685/schema)