Read user comments

Defaults to the current user. Only a Bitrix24 admin can choose another user; Bitrix24 leaves text blank in that mode. firstId takes precedence over lastId; both use the feed comment ID.

GET /v1/posts/comments

Bitrix24: log.blogcomment.user.get | Scope: log | Auth: X-Api-Key

Parameters

Parameter	Type	Required	Description
ParameteruserId	Typeinteger	Requiredno	DescriptionPositive user ID; defaults to the current user
ParameterfirstId	Typeinteger	Requiredno	DescriptionFeed comment cursor; 0 allowed; takes precedence over lastId
ParameterlastId	Typeinteger	Requiredno	DescriptionFeed comment cursor for older entries; 0 allowed
Parameterlimit	Typeinteger	Requiredno	DescriptionDefault 100, positive; clamped to 1000

Response fields

data.comments[]: id (feed), commentId (blog), postId, date, text, attach (file IDs). data.files is either an array or a dictionary keyed by numeric file IDs. Each file contains only the optional fields below; unknown fields are omitted and credential-bearing URLs are redacted.

Field	Type	Description
Fieldid	Typeinteger	DescriptionDisk file ID
Fielddate	Typestring	DescriptionFile timestamp
Fieldtype	Typestring	DescriptionFile type
Fieldname	Typestring	DescriptionFile name
Fieldsize	Typenumber	DescriptionFile size in bytes
Fieldimage	Type`false` or object	DescriptionImage metadata; the object contains optional `width` and `height` numbers
FieldauthorId	Typeinteger	DescriptionAuthor user ID
FieldauthorName	Typestring	DescriptionAuthor display name
FieldurlPreview	Typestring or `null`	DescriptionPreview URL
FieldurlShow	Typestring	DescriptionDisplay URL
FieldurlDownload	Typestring	DescriptionRedacted upstream download URL; metadata only, not a callable API URL

The array form preserves file positions. The dictionary form uses positive numeric file IDs as keys. files: [] and files: {} remain valid empty forms; image: false and urlPreview: null are preserved.

urlShow and urlDownload are upstream metadata only. They may be redacted and must not be replayed as API URLs. This log endpoint does not provide a file-download operation. The timeline download endpoint (GET /v1/timelines/{commentId}/files/{fileRef}/download) requires the crm scope and a timeline comment ID; the feed id returned here is not interchangeable with that commentId.

JSON

{
  "success": true,
  "data": {
    "comments": [],
    "files": []
  }
}

Examples

Terminal

curl -X GET "https://vibecode.bitrix24.com/v1/posts/comments" -H "X-Api-Key: vibe_api_DUMMY_personal"

Terminal

curl -X GET "https://vibecode.bitrix24.com/v1/posts/comments" -H "X-Api-Key: vibe_app_DUMMY_oauth" -H "Authorization: Bearer DUMMY_SESSION"

javascript

const response = await fetch("https://vibecode.bitrix24.com/v1/posts/comments", {
  method: "GET", headers: { "X-Api-Key": "vibe_api_DUMMY_personal" }
});
const result = await response.json();

javascript

const response = await fetch("https://vibecode.bitrix24.com/v1/posts/comments", {
  method: "GET", headers: { "X-Api-Key": "vibe_app_DUMMY_oauth", "Authorization": "Bearer DUMMY_SESSION" }
});
const result = await response.json();

Errors

HTTP	Code	Meaning
HTTP400	CodeINVALID_PARAMS	MeaningInvalid input; no Bitrix24 call
HTTP401	CodeTOKEN_MISSING / INVALID_API_KEY	MeaningMissing tokens or unusable key
HTTP403	CodeSCOPE_DENIED / BITRIX_ACCESS_DENIED	MeaningMissing scope, portal permission refusal, or forbidden write
HTTP422	CodeBITRIX_ERROR	MeaningPortal business refusal or unsuccessful operation
HTTP429	CodeBITRIX_RATE_LIMIT	MeaningPortal rate limit
HTTP502 / 503	CodeBITRIX_ERROR	MeaningInvalid response, unavailable portal or timeout

400: invalid input.