Documentation » API » Methods » board.getTopics

Returns the list of topics in a group’s discussion board.

Accessing topics in private or closed groups requires the groups:read permission.

This method can be called without an access token.

Parameters

group_id
integer

The group for which topics need to be returned.

order
enum

Sort order for the topics. Pinned topics, if any, will always be returned first regardless of this parameter.

  • updated_desc – By last post time, newest to oldest
  • created_desc – By creation time, newest to oldest
  • updated_asc – By last post time, oldest to newest
  • created_asc – By creation time, oldest to newest

By default updated_desc.

offset
integer (non-negative)

Offset into the list of topics for pagination.

count
integer (1..100)

How many topics to return.

By default 40.

extended
boolean

Whether to return information about users who created the topics and last posted in them.

By default false.

preview
enum

Comment preview mode.

  • first – Return the text of the first comment in comment_preview for each topic
  • last – Return the text of the last comment in comment_preview for each topic
  • none – Do not return comment_preview

By default none.

preview_length
integer (non-negative)

If preview is not none, how many characters of the comment text to return. The text will be truncated on a word boundary. Pass 0 to return complete texts.

By default 90.

Result

Returns a paginated list of board topics.

If extended is true, returns an extra profiles field with user objects for users who created these topics and last posted in them.

Errors

Global errors may occur when calling this method.