---
title: "Get a thread with its messages"
method: GET
path: "/inbox/threads/{id}"
tags: ["Inbox"]
---

# Get a thread with its messages

`GET /inbox/threads/{id}`

## Request

- Base URL: `https://api.rizamo.com/v1`
- URL: `https://api.rizamo.com/v1/inbox/threads/{id}`
- Auth: HTTP bearer

Its messages oldest first: every one without `limit`; with it, the newest `limit`, and `nextCursor`, passed as `before`, gives the ones before them.

## Path parameters

- `id` string, required: The thread's id (`thr_`).

## Query parameters

- `limit` integer: How many of the newest messages. Left out: every message.
- `before` string: `nextCursor` from the answer before: the messages older than those it gave.

## Response `200`

OK

- object
  - `thread` Thread, required
    - `id` string, required
    - `profileId` string, required
    - `accountId` string, required
    - `network` 'instagram' | 'facebook' | 'threads' | 'linkedin' | 'tiktok' | 'youtube' | 'x' | 'pinterest' | 'google', required
    - `kind` 'comment' | 'dm' | 'mention' | 'review', required: comment: a first comment on a post, with the replies under it. dm: private messages with one person. mention and review: not collected yet.
    - `contact` Contact, nullable, required
      - `name` string, required
      - `handle` string, required
      - `initials` string, required
      - `color` string, required
      - `avatarUrl` string, nullable, required: Their picture. On Facebook, Instagram, Threads, TikTok and LinkedIn, whose own links expire, a small copy Rizamo keeps, on Rizamo's media host: the link works for a few hours, so get the thread again for a fresh one. The network's own link elsewhere, and until the copy is made. Null when the network gives none, or its link expired with no copy.
    - `postId` string, nullable, required: Comments: the Rizamo post (`post_`) the comment is on, when it went out through Rizamo. Null on posts made elsewhere, and for messages.
    - `networkPostId` string, nullable, required: Comments: the post they are on (`npost_`), as `Get a post on a network` returns it, once Rizamo has listed it.
    - `preview` string, required: The newest message's text, empty when that message has none.
    - `lastMessageAt` string, date-time, required
    - `unread` boolean, required
    - `status` 'open' | 'done', required
    - `assignee` union, required
      - object
        - `type` 'agent', required
        - `agent` 'claude' | 'chatgpt' | 'claudecode' | 'cursor' | 'codex' | 'gemini' | 'perplexity' | 'openclaw' | 'n8n' | 'make' | 'zapier', nullable, required
        - `name` string, required
        - `agentId` string
        - `onBehalfOf` object: The person whose agent it is, who connected it and whom it acts as, with their role: "Ana via Claude Code". Events from before 2026-11-02 have it too, with the person's name now. Left out of an agent with no person, and of other records from before. After the person's erasure, `name` is "A former member" and `userId` empty.
          - `userId` string, required
          - `name` string, required
      - object
        - `type` 'user', required
        - `userId` string, required
        - `name` string, required
        - `initials` string, required
      - object
        - `type` 'api_key', required
        - `keyId` string, required
        - `name` string, required
      - object
        - `type` 'automation', required
        - `automationId` string, required
        - `name` string, required
    - `sentiment` 'positive' | 'neutral' | 'negative', required: Not computed yet: always `neutral` until Rizamo reads sentiment, so do not rely on it.
    - `replyWindowEndsAt` string, date-time, nullable, required: Messages: replies are possible until then, 24 hours after the person's last message (Meta's messaging window). Null for comments, which have none.
  - `messages` Message[], required
    - `id` string, required
    - `threadId` string, required
    - `direction` 'in' | 'out', required
    - `text` string, required: Empty when the network does not share it, as Instagram does not for GIF and sticker comments, or when the message is only an attachment.
    - `at` string, date-time, required
    - `sentBy` union, required
      - object
        - `type` 'agent', required
        - `agent` 'claude' | 'chatgpt' | 'claudecode' | 'cursor' | 'codex' | 'gemini' | 'perplexity' | 'openclaw' | 'n8n' | 'make' | 'zapier', nullable, required
        - `name` string, required
        - `agentId` string
        - `onBehalfOf` object: The person whose agent it is, who connected it and whom it acts as, with their role: "Ana via Claude Code". Events from before 2026-11-02 have it too, with the person's name now. Left out of an agent with no person, and of other records from before. After the person's erasure, `name` is "A former member" and `userId` empty.
          - `userId` string, required
          - `name` string, required
      - object
        - `type` 'user', required
        - `userId` string, required
        - `name` string, required
        - `initials` string, required
      - object
        - `type` 'api_key', required
        - `keyId` string, required
        - `name` string, required
      - object
        - `type` 'automation', required
        - `automationId` string, required
        - `name` string, required
    - `author` Contact, nullable, required
      - `name` string, required
      - `handle` string, required
      - `initials` string, required
      - `color` string, required
      - `avatarUrl` string, nullable, required: Their picture. On Facebook, Instagram, Threads, TikTok and LinkedIn, whose own links expire, a small copy Rizamo keeps, on Rizamo's media host: the link works for a few hours, so get the thread again for a fresh one. The network's own link elsewhere, and until the copy is made. Null when the network gives none, or its link expired with no copy.
    - `delivery` 'sending' | 'sent' | 'failed', nullable, required: Where a reply stands. `sending`: on its way (a Threads, LinkedIn or YouTube reply goes out in the background, within seconds to a minute; read the thread again to follow it). `sent`: on the network. `failed`: not sent, with why in `deliveryError`; reply again with `retryOf` set to its id to try it once more, which never sends it twice. Null for messages received.
    - `deliveryError` string, nullable, required: Why the reply was not sent, in plain words, when `delivery` is `failed`.
    - `hidden` boolean, required: Comments: hidden on the network, from Rizamo (`Hide a comment`) or the network's own app, as Rizamo last read it. Others no longer see it; the person who wrote it may. Always false for messages.
    - `liked` boolean, nullable, required: Facebook comments (and LinkedIn Pages'): whether the Page likes it (`Like a comment`). Null elsewhere, where Rizamo does not like comments.
    - `first` boolean, required: Comments: the thread's first comment, which started it. Deleting it deletes the thread, and it is the only one Threads hides (with the replies under it). False for the replies, and for every message; false for all of a thread whose first comment Rizamo never read.
  - `nextCursor` string, nullable, required: Older messages remain: pass it as `before`. Null when these are the oldest.

## Other responses

- `400`: `invalid_request`: A field is missing or wrong, or the request cannot be done as asked: the message names the field or says what to change.
- `401`: `unauthorized`: No API key or sign-in, or the key does not work: it was deleted, or it expired.
- `403`: `forbidden`: The caller may not do this: the key or agent lacks the scope (the message names it), or the action needs another role or a fresh sign-in.
- `404`: `not_found`: No such object, or it is outside your team or the profiles your key reaches.
- `429`: `rate_limited`: Over one of Rizamo's limits, or a network asked Rizamo to slow down: wait for `Retry-After` seconds, or as long as the message says.
- `500`: `internal`: Our side failed: retry, and send the `requestId` if it keeps failing.
- `503`: `timeout`: The request took too long to work out, most often a report: try again in a moment, or ask a report for a shorter period or one profile.

---

[API](https://skmtc.dev/rizamo/apis/rizamo-api.md) - [All operations](https://skmtc.dev/rizamo/apis/rizamo-api/llms.txt) - [OpenAPI document](https://skmtc.dev/rizamo/apis/rizamo-api/revisions/31b0c1b1ffb5?raw)
