Get Comments

Get CommentsGET /comments.json

Retrieves multiple comments from a record in an app.
URI for Guest Space Apps


The user or API Token must have permission to view the record to retrieve comments.

Request Parameters

app Integer or String Yes The App ID.
record Integer or String Yes The Record ID.
order String Optional The sort order of the Comment ID. Specifying "asc" will sort the comments in ascending order, and "desc" will sort the comments in descending order.
offset Integer Optional This skips the retrieval of the first number of comments.
"offset": 30 skips the first 30 comments, and retrieves from the 31st comment. There is no maximum for this value.
limit Integer Optional The number of records to retrieve.
"limit": 5 will retrieve the first 5 comments. The default and maximum is 10 comments.

Sample Request using Query Strings

The query string is sent by joining the request parameters with an "&", and an URL encoded query value.

HTTP Query String


Request Header

GET /k/v1/record/comments.json? app=1&record=1 HTTP/1.1
X-Cybozu-Authorization: a2ludG9uZTpkZXZlbG9wZXI=
Authorization: Basic a2ludG9uZTpkZXZlbG9wZXI=

Content-Type header is not needed.

Sample Request using JSON

Request Header

GET /k/v1/record/comments.json HTTP/1.1
X-Cybozu-Authorization: a2ludG9uZTpkZXZlbG9wZXI=
Authorization: Basic a2ludG9uZTpkZXZlbG9wZXI=
Content-Type: application/json

Specify application/json for the Content-Type.

Sample Body

Response Parameters

comments Array An array of comments. An empty array is returned if no conditions are met.
comments[].id Integer The Comment ID.
comments[].text String The comment including the line feed codes.
If a"@" will be omitted and the name after "@" will be remained as string in the comment when the mention is placed in the comment. Repeating mention will be repeated as same time as they are appeared in the comment.
comments[].createdAt String The created date and time of the comment.
comments[].creator Object An object including information of the comment creator.
comments[].creator.code String The comment creator's user code (log in name).
comments[] String The comment creator's user name (display name).
comments[].mentions Array An array including information of mentioned users.
comments[].mentions[].code String The code of the mentioned user, group or organization.
comments[].mentions[].type String The type of the mention.
  • USER: User
  • GROUP: Group
  • ORGANIZATION: Department
older Boolean Information of older comments:
  • true: Older comments exist.
  • false: Older comments do not exist (i.e. the first comment)
newer Boolean Information of newer comments:
  • true: Newer comments exist.
  • false: Newer comments do not exist. (i.e. the last comment)

Sample Response



  • The maximum number of records that can be retrieved with the Get Comments API is 10.
  • An error will return if the commenting feature of the app is turned off.
  • For other limitations, check the limitations on this page
Was this article helpful?
0 out of 0 found this helpful
Do you have any questions or issues related to this article?
Please share your views with us in the Community forums!