Get Comments


Retrieves multiple comments from a record in an app.
Method GET
URL https://{subdomain}
URL(guest space) https://{subdomain}{SpaceID}/v1/record/comments.json
Authentication API Token Authentication , Password Authentication
Content-Type application/json (not needed if specifying the query with a query string)


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.
If ignored, "desc" will be set.
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 (Query String)

JavaScript (using Kintone REST API Request)

curl Sample

Sample Request (JSON)

JavaScript (using Kintone REST API Request)

curl Sample

Response Parameters

comments Array of Objects 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 user is mentioned within a comment, the "@" symbol will be omitted from the String.
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!