Topics

Get a single topic

GET

https://discourse.example.com/t/{id}.json

Get a single topic

curl -X GET 'https://discourse.example.com/t/string.json' \
  -H 'Api-Key: string' \
  -H 'Api-Username: string'

const response = await fetch('https://discourse.example.com/t/string.json', {
  method: 'GET',
  headers: {
    'Api-Key': 'string',
    'Api-Username': 'string',
  },
});

const data = await response.text();

import requests

response = requests.get(
    'https://discourse.example.com/t/string.json',
    headers={
        'Api-Key': 'string',
        'Api-Username': 'string',
    },
)
print(response.text)

200

{
  "post_stream": {
    "posts": [
      {
        "id": 0,
        "name": "string",
        "username": "string",
        "avatar_template": "string",
        "created_at": "string",
        "cooked": "string",
        "post_number": 0,
        "post_type": 0,
        "updated_at": "string",
        "reply_count": 0,
        "reply_to_post_number": "string",
        "quote_count": 0,
        "incoming_link_count": 0,
        "reads": 0,
        "readers_count": 0,
        "score": 0,
        "yours": true,
        "topic_id": 0,
        "topic_slug": "string",
        "display_username": "string",
        "primary_group_name": "string",
        "flair_name": "string",
        "flair_url": "string",
        "flair_bg_color": "string",
        "flair_color": "string",
        "version": 0,
        "can_edit": true,
        "can_delete": true,
        "can_recover": true,
        "can_see_hidden_post": true,
        "can_wiki": true,
        "link_counts": [
          {
            "url": "string",
            "internal": true,
            "reflection": true,
            "title": "string",
            "clicks": 0
          }
        ],
        "read": true,
        "user_title": "string",
        "bookmarked": true,
        "actions_summary": [
          {
            "id": 0,
            "can_act": true
          }
        ],
        "moderator": true,
        "admin": true,
        "staff": true,
        "user_id": 0,
        "hidden": true,
        "trust_level": 0,
        "deleted_at": "string",
        "user_deleted": true,
        "edit_reason": "string",
        "can_view_edit_history": true,
        "wiki": true,
        "reviewable_id": 0,
        "reviewable_score_count": 0,
        "reviewable_score_pending_count": 0
      }
    ],
    "stream": []
  },
  "timeline_lookup": [],
  "suggested_topics": [
    {
      "id": 0,
      "title": "string",
      "fancy_title": "string",
      "slug": "string",
      "posts_count": 0,
      "reply_count": 0,
      "highest_post_number": 0,
      "image_url": "string",
      "created_at": "string",
      "last_posted_at": "string",
      "bumped": true,
      "bumped_at": "string",
      "archetype": "string",
      "unseen": true,
      "pinned": true,
      "unpinned": "string",
      "excerpt": "string",
      "visible": true,
      "closed": true,
      "archived": true,
      "bookmarked": "string",
      "liked": "string",
      "tags": [
        {
          "id": 0,
          "name": "string",
          "slug": "string"
        }
      ],
      "tags_descriptions": {},
      "like_count": 0,
      "views": 0,
      "category_id": 0,
      "featured_link": "string",
      "posters": [
        {
          "extras": "string",
          "description": "string",
          "user": {
            "id": 0,
            "username": "string",
            "name": "string",
            "avatar_template": "string"
          }
        }
      ]
    }
  ],
  "tags": [
    {
      "id": 0,
      "name": "string",
      "slug": "string"
    }
  ],
  "tags_descriptions": {},
  "id": 0,
  "title": "string",
  "fancy_title": "string",
  "posts_count": 0,
  "created_at": "string",
  "views": 0,
  "reply_count": 0,
  "like_count": 0,
  "last_posted_at": "string",
  "visible": true,
  "closed": true,
  "archived": true,
  "has_summary": true,
  "archetype": "string",
  "slug": "string",
  "category_id": 0,
  "word_count": 0,
  "deleted_at": "string",
  "user_id": 0,
  "featured_link": "string",
  "pinned_globally": true,
  "pinned_at": "string",
  "pinned_until": "string",
  "image_url": "string",
  "slow_mode_seconds": 0,
  "draft": "string",
  "draft_key": "string",
  "draft_sequence": 0,
  "unpinned": "string",
  "pinned": true,
  "current_post_number": 0,
  "highest_post_number": 0,
  "deleted_by": "string",
  "has_deleted": true,
  "actions_summary": [
    {
      "id": 0,
      "count": 0,
      "hidden": true,
      "can_act": true
    }
  ],
  "chunk_size": 0,
  "bookmarked": true,
  "bookmarks": [],
  "topic_timer": "string",
  "message_bus_last_id": 0,
  "participant_count": 0,
  "show_read_indicator": true,
  "thumbnails": "string",
  "slow_mode_enabled_until": "string",
  "details": {
    "can_edit": true,
    "notification_level": 0,
    "can_move_posts": true,
    "can_delete": true,
    "can_remove_allowed_users": true,
    "can_create_post": true,
    "can_reply_as_new_topic": true,
    "can_invite_to": true,
    "can_invite_via_email": true,
    "can_flag_topic": true,
    "can_convert_topic": true,
    "can_review_topic": true,
    "can_close_topic": true,
    "can_archive_topic": true,
    "can_split_merge_topic": true,
    "can_edit_staff_notes": true,
    "can_toggle_topic_visibility": true,
    "can_pin_unpin_topic": true,
    "can_banner_topic": true,
    "can_moderate_category": true,
    "can_remove_self_id": 0,
    "participants": [
      {
        "id": 0,
        "username": "string",
        "name": "string",
        "avatar_template": "string",
        "post_count": 0,
        "primary_group_name": "string",
        "flair_name": "string",
        "flair_url": "string",
        "flair_color": "string",
        "flair_bg_color": "string",
        "flair_group_id": 0,
        "admin": true,
        "moderator": true,
        "trust_level": 0
      }
    ],
    "created_by": {
      "id": 0,
      "username": "string",
      "name": "string",
      "avatar_template": "string"
    },
    "last_poster": {
      "id": 0,
      "username": "string",
      "name": "string",
      "avatar_template": "string"
    }
  }
}

Parameters

idstringrequiredpath

Response

200OKany

specific posts

Response fields application/json

post_streamobjectrequired

Show child attributes

postsArray<object>required

Show child attributes

idintegerrequired

namestringrequired

usernamestringrequired

avatar_templatestringrequired

created_atstringrequired

cookedstringrequired

post_numberintegerrequired

post_typeintegerrequired

updated_atstringrequired

reply_countintegerrequired

reply_to_post_numberstring | nullrequired

quote_countintegerrequired

incoming_link_countintegerrequired

readsintegerrequired

readers_countintegerrequired

scorenumberrequired

yoursbooleanrequired

topic_idintegerrequired

topic_slugstringrequired

display_usernamestringrequired

primary_group_namestring | nullrequired

flair_namestring | nullrequired

flair_urlstring | nullrequired

flair_bg_colorstring | nullrequired

flair_colorstring | nullrequired

versionintegerrequired

can_editbooleanrequired

can_deletebooleanrequired

can_recoverbooleanrequired

can_see_hidden_postboolean

can_wikibooleanrequired

link_countsArray<object>required

Show child attributes

urlstringrequired

internalbooleanrequired

reflectionbooleanrequired

titlestringrequired

clicksintegerrequired

readbooleanrequired

user_titlestring | nullrequired

bookmarkedbooleanrequired

actions_summaryArray<object>required

Show child attributes

idintegerrequired

can_actbooleanrequired

moderatorbooleanrequired

adminbooleanrequired

staffbooleanrequired

user_idintegerrequired

hiddenbooleanrequired

trust_levelintegerrequired

deleted_atstring | nullrequired

user_deletedbooleanrequired

edit_reasonstring | nullrequired

can_view_edit_historybooleanrequired

wikibooleanrequired

reviewable_idintegerrequired

reviewable_score_countintegerrequired

reviewable_score_pending_countintegerrequired

streamArray<any>required

timeline_lookupArray<any>required

suggested_topicsArray<object>required

Show child attributes

idintegerrequired

titlestringrequired

fancy_titlestringrequired

slugstringrequired

posts_countintegerrequired

reply_countintegerrequired

highest_post_numberintegerrequired

image_urlstring | nullrequired

created_atstringrequired

last_posted_atstring | nullrequired

bumpedbooleanrequired

bumped_atstringrequired

archetypestringrequired

unseenbooleanrequired

pinnedbooleanrequired

unpinnedstring | nullrequired

excerptstringrequired

visiblebooleanrequired

closedbooleanrequired

archivedbooleanrequired

bookmarkedstring | nullrequired

likedstring | nullrequired

tagsArray<object>required

Show child attributes

idintegerrequired

namestringrequired

slugstringrequired

tags_descriptionsobjectrequired

like_countintegerrequired

viewsintegerrequired

category_idintegerrequired

featured_linkstring | nullrequired

postersArray<object>required

Show child attributes

extrasstringrequired

descriptionstringrequired

userobjectrequired

Show child attributes

idintegerrequired

usernamestringrequired

namestringrequired

avatar_templatestringrequired

tagsArray<object>required

Show child attributes

idintegerrequired

namestringrequired

slugstringrequired

tags_descriptionsobjectrequired

idintegerrequired

titlestringrequired

fancy_titlestringrequired

posts_countintegerrequired

created_atstringrequired

viewsintegerrequired

reply_countintegerrequired

like_countintegerrequired

last_posted_atstring | nullrequired

visiblebooleanrequired

closedbooleanrequired

archivedbooleanrequired

has_summarybooleanrequired

archetypestringrequired

slugstringrequired

category_idintegerrequired

word_countinteger | nullrequired

deleted_atstring | nullrequired

user_idintegerrequired

featured_linkstring | nullrequired

pinned_globallybooleanrequired

pinned_atstring | nullrequired

pinned_untilstring | nullrequired

image_urlstring | nullrequired

slow_mode_secondsintegerrequired

draftstring | nullrequired

draft_keystringrequired

draft_sequenceintegerrequired

unpinnedstring | nullrequired

pinnedbooleanrequired

current_post_numberinteger

highest_post_numberinteger | nullrequired

deleted_bystring | nullrequired

has_deletedbooleanrequired

actions_summaryArray<object>required

Show child attributes

idintegerrequired

countintegerrequired

hiddenbooleanrequired

can_actbooleanrequired

chunk_sizeintegerrequired

bookmarkedbooleanrequired

bookmarksArray<any>required

topic_timerstring | nullrequired

message_bus_last_idintegerrequired

participant_countintegerrequired

show_read_indicatorbooleanrequired

thumbnailsstring | nullrequired

slow_mode_enabled_untilstring | nullrequired

detailsobjectrequired

Show child attributes

can_editbooleanrequired

notification_levelintegerrequired

can_move_postsbooleanrequired

can_deletebooleanrequired

can_remove_allowed_usersbooleanrequired

can_create_postbooleanrequired

can_reply_as_new_topicbooleanrequired

can_invite_toboolean

can_invite_via_emailboolean

can_flag_topicboolean

can_convert_topicbooleanrequired

can_review_topicbooleanrequired

can_close_topicbooleanrequired

can_archive_topicbooleanrequired

can_split_merge_topicbooleanrequired

can_edit_staff_notesbooleanrequired

can_toggle_topic_visibilitybooleanrequired

can_pin_unpin_topicbooleanrequired

can_banner_topicboolean

can_moderate_categorybooleanrequired

can_remove_self_idintegerrequired

participantsArray<object>

Show child attributes

idintegerrequired

usernamestringrequired

namestringrequired

avatar_templatestringrequired

post_countintegerrequired

primary_group_namestring | nullrequired

flair_namestring | nullrequired

flair_urlstring | nullrequired

flair_colorstring | nullrequired

flair_bg_colorstring | nullrequired

flair_group_idinteger | null

adminbooleanrequired

moderatorbooleanrequired

trust_levelintegerrequired

created_byobjectrequired

Show child attributes

idintegerrequired

usernamestringrequired

namestringrequired

avatar_templatestringrequired

last_posterobjectrequired

Show child attributes

idintegerrequired

usernamestringrequired

namestringrequired

avatar_templatestringrequired

Docs by Sourcey