Connected session · FullPool

Conversations

Your conversations, newest first.

GETapi.tikultra.com/v1/account/dm/conversation/list20 cr

Upstream/im/v1/conversation/get_list{ cursor, has_more }Growth and up

Parameters

Name	Type	Description
`account_id`required	string	A connected account, from /dash/sessions or POST /v1/account/import. e.g. acc_7Hq2
`cursor`	string	The cursor from the previous page. Omit it for the first page.
`count`	integer	Items per page. e.g. 20

Pricing

Plan	Per call	Per 1,000 calls
Starter	20 credits	$2.32
Growth	20 credits	$1.58
Scale	20 credits	$1.16

Connected sessions run on FullPool and are for accounts you own or are authorized to operate. Growth and up.

Responses

A 200 returns JSON with stable field names. Every response carries x-credits-cost, x-credits-tier and x-credits-remaining. Errors return a JSON body with a stable code and cost 0 credits. Error codes

curl -G https://api.tikultra.com/v1/account/dm/conversation/list \
  -H "x-api-key: $TIKULTRA_KEY" \
  --data-urlencode "account_id=acc_7Hq2"

{
  "cursor": null,
  "has_more": false,
  "items": [
    {
      "conversation_id": "0:1:6970000000000000001:6970000000000000002",
      "peer": {
        "uid": "6970000000000000002",
        "unique_id": "kbfan",
        "nickname": "KB Fan"
      },
      "unread_count": 1,
      "last_message_preview": "Hey! Would love to review the new 75% build.",
      "updated_at": 1762900020
    }
  ]
}

Try it in the playground Full reference in the docs

More in Connected sessions

POST/v1/account/importImport session25 cr POST/v1/account/login/otp/sendEmail sign-in: send code25 cr POST/v1/account/login/otp/verifyEmail sign-in: verify code25 cr POST/v1/account/sessionRefresh session25 cr GET/v1/account/healthSession health15 cr POST/v1/account/warm/nicheWarm session for niche25 cr GET/v1/account/upload/precheckUpload precheck15 cr POST/v1/account/upload/videoPublish video100 cr POST/v1/account/upload/slideshowPublish slideshow100 cr POST/v1/account/upload/deleteDelete post15 cr POST/v1/account/post/visibilityPost visibility15 cr GET/v1/account/upload/placesPlaces for a post15 cr POST/v1/account/profile/updateUpdate profile25 cr POST/v1/account/profile/usernameChange username25 cr POST/v1/account/profile/avatarChange avatar25 cr POST/v1/account/profile/privacyPrivacy settings25 cr POST/v1/account/settingsApp settings15 cr POST/v1/account/wellbeingDigital wellbeing15 cr POST/v1/account/commentPost comment25 cr POST/v1/account/comment/likeLike comment15 cr POST/v1/account/comment/unlikeUnlike comment15 cr POST/v1/account/comment/deleteDelete comment15 cr GET/v1/account/dm/inboxInbox20 cr GET/v1/account/dm/conversation/messagesConversation messages20 cr POST/v1/account/dm/conversation/createStart conversation20 cr POST/v1/account/dm/conversation/readMark read20 cr POST/v1/account/dm/sendSend message35 cr POST/v1/account/dm/send-imageSend image35 cr POST/v1/account/dm/send-voiceSend voice note35 cr POST/v1/account/dm/replyReply to message35 cr POST/v1/account/dm/stickerSend sticker35 cr POST/v1/account/dm/share-videoShare video35 cr POST/v1/account/dm/reactReact to message15 cr POST/v1/account/dm/recallUnsend message15 cr GET/v1/account/dm/group/infoGroup info20 cr GET/v1/account/dm/group/membersGroup members20 cr GET/v1/account/dm/streaksStreaks20 cr POST/v1/account/live/startStart LIVE100 cr POST/v1/account/live/pingLIVE heartbeat15 cr POST/v1/account/live/finishEnd LIVE15 cr POST/v1/account/live/moderateModerate LIVE20 cr POST/v1/account/live/cohostCo-host20 cr POST/v1/account/live/battleLIVE match20 cr GET/v1/account/shop/cartCart25 cr GET/v1/account/shop/order-centerOrders25 cr GET/v1/account/shop/csShop support chat25 cr

Ready to build?

Start with 2,500 free credits and test every public endpoint, then pick a plan.

Get an API key See pricing