List all conversations #

Used to retrieve a list of all ongoing or completed conversations associated with your account.

Quick start #

💻
Quick Start (cURL)
Copy to clipboard
curl -X GET https://api.ip1.net/v3/conversations \
  -H "Authorization: Bearer API_TOKEN"

Call #

Endpoint: /conversations

Methodology: GET

Example of call data #

📋
Call (URL)
Copy to clipboard
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.

📋
Responsdata (JSON)
Copy to clipboard
[
  {
    "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 nameDescription of the projectTypeExample
idUnique conversation ID.string"65e15d14f1234547890ghijkl"
brandBrand's internal name.string”my-store-ab”
agentThe agent handling the conversation.string”customer service”
recipientRecipient's phone number.string”46700123456”
uniqueIdYour own unique conversation ID.string”conversation-12345-id”
startedTime 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 #

💻
Quick start (cURL)
Copy to clipboard
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 #

📋
Call (URL)
Copy to clipboard
https://api.ip1.net/v3/conversations/65e15d14f1234547890ghijkl

Fields for call data #

Field nameDescription of the projectRequiredTypeExample
conversationIdID of the conversation you want to retrieveYesQuery Parameter65e15d14f1234547890ghijkl

Responsibility #

Example of response data #

Returns the current conversation object.

📋
Responsdata (JSON)
Copy to clipboard
  {
    "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 nameDescription of the projectTypeExample
idUnique conversation ID.string"65e15d14f1234547890ghijkl"
brandBrand's internal name.string”my-store-ab”
agentThe agent handling the conversation.string”customer service”
recipientRecipient's phone number.string”46700123456”
uniqueIdYour own unique conversation ID.string”conversation-12345-id”
startedTime conversation began.DateTime”03-09-2026 10:00:00”