Conversations List

curl --request GET \
  --url https://app.tied.com/api/v1/accounts/{account_id}/conversations \
  --header 'api_access_token: <api-key>'

import requests

url = "https://app.tied.com/api/v1/accounts/{account_id}/conversations"

headers = {"api_access_token": "<api-key>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {api_access_token: '<api-key>'}};

fetch('https://app.tied.com/api/v1/accounts/{account_id}/conversations', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

require 'uri'
require 'net/http'

url = URI("https://app.tied.com/api/v1/accounts/{account_id}/conversations")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["api_access_token"] = '<api-key>'

response = http.request(request)
puts response.read_body

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://app.tied.com/api/v1/accounts/{account_id}/conversations"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("api_access_token", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

{
  "data": {
    "meta": {
      "mine_count": 1,
      "assigned_count": 1,
      "unassigned_count": 24,
      "all_count": 25
    },
    "payload": [
      {
        "meta": {
          "sender": {
            "additional_attributes": {
              "city": "San Francisco",
              "country": "United States",
              "location": "San Francisco, United States",
              "description": "Head of Customer Experience at Northwind Supply. Migrating off a legacy helpdesk and launching on Apple Messages first. Prefers async follow-up.",
              "company_name": "Northwind Supply Co.",
              "country_code": "US",
              "created_at_ip": "203.0.113.10",
              "updated_at_ip": "203.0.113.10",
              "avatar_url_hash": "0000000000000000000000000000000000000000",
              "social_profiles": {
                "github": "mokonkwo",
                "tiktok": "northwindsupply",
                "twitter": "mayabuildscx",
                "facebook": "northwindsupply",
                "linkedin": "maya-okonkwo",
                "instagram": "northwind.supply"
              },
              "last_avatar_sync_at": "2026-09-21T02:21:05Z",
              "social_telegram_user_name": "maya_okonkwo"
            },
            "availability_status": "offline",
            "email": "maya@northwindsupply.com",
            "id": 135,
            "name": "Maya Okonkwo",
            "phone_number": "+14155550198",
            "blocked": false,
            "identifier": "in_example",
            "thumbnail": "https://app.tied.com/rails/active_storage/blobs/proxy/EXAMPLE/avatar.png",
            "thumbnail_background_color": null,
            "domain_logo_avatar": false,
            "customer_verified": true,
            "custom_attributes": {
              "plan_tier": "Premium",
              "lead_source": "Apple Messages — pricing page",
              "profile_url": "https://tied.com/customers/northwind-supply",
              "customer_since": "2024-03-15",
              "lifetime_value": "48500",
              "loyalty_discount": "12",
              "newsletter_opt_in": true,
              "satisfaction_score": "92"
            },
            "last_activity_at": 1789957263,
            "created_at": 1789957262
          },
          "channel": "Channel::Amb",
          "assignee": {
            "id": 1,
            "account_id": 1,
            "availability_status": "offline",
            "auto_offline": true,
            "confirmed": true,
            "email": "you@example.com",
            "provider": "email",
            "available_name": "Alex Rivera",
            "name": "Alex Rivera",
            "role": "administrator",
            "thumbnail": "/dashboard/images/default-contact-avatars/031.svg",
            "avatar_url": "",
            "illustration_avatar": true,
            "accent_color": null,
            "custom_role_id": null
          },
          "hmac_verified": false
        },
        "id": 155,
        "messages": [
          {
            "id": 507,
            "content": "Tuesday at 11 works — see you then!",
            "account_id": 1,
            "inbox_id": 1,
            "conversation_id": 155,
            "message_type": 0,
            "created_at": 1789957083,
            "updated_at": "2026-09-21T02:18:03.023Z",
            "private": false,
            "status": "sent",
            "source_id": null,
            "content_type": "text",
            "content_attributes": {},
            "sender_type": "Contact",
            "sender_id": 135,
            "external_source_ids": {},
            "additional_attributes": {},
            "processed_message_content": null,
            "sentiment": {},
            "source_identity_uniqueness_exempt_at": null,
            "actor": null,
            "conversation": {
              "assignee_id": 1,
              "unread_count": 0,
              "last_activity_at": 1789957263,
              "contact_inbox": {
                "source_id": "sr_example"
              }
            },
            "sender": {
              "additional_attributes": {
                "city": "San Francisco",
                "country": "United States",
                "location": "San Francisco, United States",
                "description": "Head of Customer Experience at Northwind Supply. Migrating off a legacy helpdesk and launching on Apple Messages first. Prefers async follow-up.",
                "company_name": "Northwind Supply Co.",
                "country_code": "US",
                "created_at_ip": "203.0.113.10",
                "updated_at_ip": "203.0.113.10",
                "avatar_url_hash": "0000000000000000000000000000000000000000",
                "social_profiles": {
                  "github": "mokonkwo",
                  "tiktok": "northwindsupply",
                  "twitter": "mayabuildscx",
                  "facebook": "northwindsupply",
                  "linkedin": "maya-okonkwo",
                  "instagram": "northwind.supply"
                },
                "last_avatar_sync_at": "2026-09-21T02:21:05Z",
                "social_telegram_user_name": "maya_okonkwo"
              },
              "custom_attributes": {
                "plan_tier": "Premium",
                "lead_source": "Apple Messages — pricing page",
                "profile_url": "https://tied.com/customers/northwind-supply",
                "customer_since": "2024-03-15",
                "lifetime_value": "48500",
                "loyalty_discount": "12",
                "newsletter_opt_in": true,
                "satisfaction_score": "92"
              },
              "email": "maya@northwindsupply.com",
              "id": 135,
              "identifier": "in_example",
              "name": "Maya Okonkwo",
              "phone_number": "+14155550198",
              "thumbnail": "https://app.tied.com/rails/active_storage/blobs/proxy/EXAMPLE/avatar.png",
              "thumbnail_background_color": null,
              "domain_logo_avatar": false,
              "customer_verified": true,
              "blocked": false,
              "type": "contact"
            }
          }
        ],
        "account_id": 1,
        "uuid": "00000000-0000-4000-8000-000000000000",
        "additional_attributes": {
          "browser": {
            "device_name": "iPhone",
            "browser_name": "Safari",
            "platform_name": "iOS",
            "browser_version": "18.4",
            "platform_version": "18.4"
          },
          "referer": "https://tied.com/pricing",
          "initiated_at": {
            "timestamp": "2026-09-21 02:21:02 UTC"
          },
          "browser_language": "en",
          "spinoco_instance_id": "demo-instance-8"
        },
        "agent_last_seen_at": 1789957143,
        "assignee_last_seen_at": 0,
        "can_reply": true,
        "contact_last_seen_at": 0,
        "custom_attributes": {
          "setup_stage": "Apple Messages connected — flows next",
          "migrating_from": "Legacy helpdesk — 40k tickets to import",
          "primary_channel": "Apple Messages",
          "onboarding_status": "Confirmed",
          "onboarding_call_at": "2026-09-22T11:00:00Z"
        },
        "inbox_id": 1,
        "labels": [
          "needs-reply",
          "scheduling"
        ],
        "muted": false,
        "snoozed_until": null,
        "status": "open",
        "created_at": 1789957262,
        "updated_at": 1789957265.1759071,
        "timestamp": 1789957263,
        "first_reply_created_at": 0,
        "unread_count": 0,
        "last_non_activity_message": {
          "id": 507,
          "content": "Tuesday at 11 works — see you then!",
          "account_id": 1,
          "inbox_id": 1,
          "conversation_id": 155,
          "message_type": 0,
          "created_at": 1789957083,
          "updated_at": "2026-09-21T02:18:03.023Z",
          "private": false,
          "status": "sent",
          "source_id": null,
          "content_type": "text",
          "content_attributes": {},
          "sender_type": "Contact",
          "sender_id": 135,
          "external_source_ids": {},
          "additional_attributes": {},
          "processed_message_content": null,
          "sentiment": {},
          "source_identity_uniqueness_exempt_at": null,
          "actor": null,
          "conversation": {
            "assignee_id": 1,
            "unread_count": 0,
            "last_activity_at": 1789957263,
            "contact_inbox": {
              "source_id": "sr_example"
            }
          },
          "sender": {
            "additional_attributes": {
              "city": "San Francisco",
              "country": "United States",
              "location": "San Francisco, United States",
              "description": "Head of Customer Experience at Northwind Supply. Migrating off a legacy helpdesk and launching on Apple Messages first. Prefers async follow-up.",
              "company_name": "Northwind Supply Co.",
              "country_code": "US",
              "created_at_ip": "203.0.113.10",
              "updated_at_ip": "203.0.113.10",
              "avatar_url_hash": "0000000000000000000000000000000000000000",
              "social_profiles": {
                "github": "mokonkwo",
                "tiktok": "northwindsupply",
                "twitter": "mayabuildscx",
                "facebook": "northwindsupply",
                "linkedin": "maya-okonkwo",
                "instagram": "northwind.supply"
              },
              "last_avatar_sync_at": "2026-09-21T02:21:05Z",
              "social_telegram_user_name": "maya_okonkwo"
            },
            "custom_attributes": {
              "plan_tier": "Premium",
              "lead_source": "Apple Messages — pricing page",
              "profile_url": "https://tied.com/customers/northwind-supply",
              "customer_since": "2024-03-15",
              "lifetime_value": "48500",
              "loyalty_discount": "12",
              "newsletter_opt_in": true,
              "satisfaction_score": "92"
            },
            "email": "maya@northwindsupply.com",
            "id": 135,
            "identifier": "in_example",
            "name": "Maya Okonkwo",
            "phone_number": "+14155550198",
            "thumbnail": "https://app.tied.com/rails/active_storage/blobs/proxy/EXAMPLE/avatar.png",
            "thumbnail_background_color": null,
            "domain_logo_avatar": false,
            "customer_verified": true,
            "blocked": false,
            "type": "contact"
          }
        },
        "last_activity_at": 1789957263,
        "priority": "high",
        "waiting_since": 0,
        "sla_policy_id": null
      },
      {
        "meta": {
          "sender": {
            "additional_attributes": {},
            "availability_status": "offline",
            "email": null,
            "id": 15,
            "name": "Sophia Reed",
            "phone_number": null,
            "blocked": false,
            "identifier": null,
            "thumbnail": "",
            "thumbnail_background_color": null,
            "domain_logo_avatar": false,
            "customer_verified": false,
            "custom_attributes": {},
            "created_at": 1789850192
          },
          "channel": "Channel::Whatsapp",
          "hmac_verified": false
        },
        "id": 161,
        "messages": [
          {
            "id": 543,
            "content": "Do we need an approved template for this?",
            "account_id": 1,
            "inbox_id": 3,
            "conversation_id": 161,
            "message_type": 0,
            "created_at": 1789953903,
            "updated_at": "2026-09-21T01:25:03.118Z",
            "private": false,
            "status": "sent",
            "source_id": null,
            "content_type": "text",
            "content_attributes": {},
            "sender_type": "Contact",
            "sender_id": 15,
            "external_source_ids": {},
            "additional_attributes": {},
            "processed_message_content": null,
            "sentiment": {},
            "source_identity_uniqueness_exempt_at": null,
            "actor": null,
            "conversation": {
              "assignee_id": null,
              "unread_count": 0,
              "last_activity_at": 1789953663,
              "contact_inbox": {
                "source_id": "sr_example"
              }
            },
            "sender": {
              "additional_attributes": {},
              "custom_attributes": {},
              "email": null,
              "id": 15,
              "identifier": null,
              "name": "Sophia Reed",
              "phone_number": null,
              "thumbnail": "",
              "thumbnail_background_color": null,
              "domain_logo_avatar": false,
              "customer_verified": false,
              "blocked": false,
              "type": "contact"
            }
          }
        ],
        "account_id": 1,
        "uuid": "00000000-0000-4000-8000-000000000000",
        "additional_attributes": {},
        "agent_last_seen_at": 1789953963,
        "assignee_last_seen_at": 0,
        "can_reply": true,
        "contact_last_seen_at": 0,
        "custom_attributes": {},
        "inbox_id": 3,
        "labels": [],
        "muted": false,
        "snoozed_until": null,
        "status": "open",
        "created_at": 1789957263,
        "updated_at": 1789957263.3044538,
        "timestamp": 1789953663,
        "first_reply_created_at": 0,
        "unread_count": 0,
        "last_non_activity_message": {
          "id": 543,
          "content": "Do we need an approved template for this?",
          "account_id": 1,
          "inbox_id": 3,
          "conversation_id": 161,
          "message_type": 0,
          "created_at": 1789953903,
          "updated_at": "2026-09-21T01:25:03.118Z",
          "private": false,
          "status": "sent",
          "source_id": null,
          "content_type": "text",
          "content_attributes": {},
          "sender_type": "Contact",
          "sender_id": 15,
          "external_source_ids": {},
          "additional_attributes": {},
          "processed_message_content": null,
          "sentiment": {},
          "source_identity_uniqueness_exempt_at": null,
          "actor": null,
          "conversation": {
            "assignee_id": null,
            "unread_count": 0,
            "last_activity_at": 1789953663,
            "contact_inbox": {
              "source_id": "sr_example"
            }
          },
          "sender": {
            "additional_attributes": {},
            "custom_attributes": {},
            "email": null,
            "id": 15,
            "identifier": null,
            "name": "Sophia Reed",
            "phone_number": null,
            "thumbnail": "",
            "thumbnail_background_color": null,
            "domain_logo_avatar": false,
            "customer_verified": false,
            "blocked": false,
            "type": "contact"
          }
        },
        "last_activity_at": 1789953663,
        "priority": null,
        "waiting_since": 0,
        "sla_policy_id": null
      }
    ]
  }
}

{
  "error": "Resource could not be found"
}