List all conversations #
Used to retrieve a list of all ongoing or completed conversations associated with your account.
Quick start #
curl -X GET https://api.ip1.net/v3/conversations \
-H "Authorization: Bearer API_TOKEN"
Call #
Endpoint: /conversations
Methodology: GET
Example of call data #
https://api.ip1.net/v3/conversations
This call does not require a body. Any filtering will occur via pagination (if implemented).
Fields for call data #
No specific fields are required for this call beyond authentication.
Responsibility #
Example of response data #
Returns a list of conversation items.
[
{
"id": "65eb3d14f1234567890abcdef",
"brand": "min-butik-ab",
"agent": "kundservice",
"recipient": "46700123456",
"uniqueId": "conversation-12345-id",
"started": "2026-03-09T08:00:00Z"
}
]
Fields for response data #
| Field name | Description of the project | Type | Example |
| id | Unique conversation ID. | string | "65e15d14f1234547890ghijkl" |
| brand | Brand's internal name. | string | ”my-store-ab” |
| agent | The agent handling the conversation. | string | ”customer service” |
| recipient | Recipient's phone number. | string | ”46700123456” |
| uniqueId | Your own unique conversation ID. | string | ”conversation-12345-id” |
| started | Time conversation began. | DateTime | ”03-09-2026 10:00:00” |
List a single conversation #
Used to retrieve a list of all ongoing or completed conversations associated with your account.
Quick start #
curl -X GET https://api.ip1.net/v3/conversations/65e15d14f1234547890ghijkl \
-H "Authorization: Bearer API_TOKEN"
Call #
Endpoint: /conversations/{conversationId}
Methodology: GET
Example of call data #
https://api.ip1.net/v3/conversations/65e15d14f1234547890ghijkl
Fields for call data #
| Field name | Description of the project | Required | Type | Example |
| conversationId | ID of the conversation you want to retrieve | Yes | Query Parameter | 65e15d14f1234547890ghijkl |
Responsibility #
Example of response data #
Returns the current conversation object.
{
"id": "65eb3d14f1234567890abcdef",
"brand": "min-butik-ab",
"agent": "customer_service",
"recipient": "46700123456",
"uniqueId": "conversation-12345-id",
"started": "2026-03-09T08:00:00Z"
}
Fields for response data #
| Field name | Description of the project | Type | Example |
| id | Unique conversation ID. | string | "65e15d14f1234547890ghijkl" |
| brand | Brand's internal name. | string | ”my-store-ab” |
| agent | The agent handling the conversation. | string | ”customer service” |
| recipient | Recipient's phone number. | string | ”46700123456” |
| uniqueId | Your own unique conversation ID. | string | ”conversation-12345-id” |
| started | Time conversation began. | DateTime | ”03-09-2026 10:00:00” |