---
title: "List All Contents"
method: GET
path: "/cx/social-messaging/v1/contents"
tags: ["Contents"]
---

# List All Contents

`GET /cx/social-messaging/v1/contents`

List contents by creation date. The default creation order is descending.

The account context of this request is determined by the RC Account Id associated with the access token provided
in the Authorization header.

The query parameters provided shall be considered an AND operation to filter the list.

A query parameter not specified or a query parameter provided with no value is treated as not required for
filtering the list.

## Query parameters

- `intervention` string[]
- `identity` string[]
- `identityGroup` string[]
- `source` string[]
- `thread` string[]
- `text` string[]
- `status` ContentStatus[]
- `orderBy` '-creationTime' | '+creationTime' | 'creationTime' — Ordering by creationTime is descending by default.
- `pageToken` string
- `perPage` integer

## Response `200`

Successful response.

- ContentList
  - `records` ContentModel[], required
    - `attachments` ContentAttachment[], required — An array containing the attachments that are attached to the content.
      - `contentType` string — Type of the attachment, which is generally a MIME attachment type like "image/jpeg", etc. Security level in ED determines what type of attachment is allowed. Based on the security level the following attachment types are supported. "Strict" level allows safe extensions below: Content name and supported types * audio (supports aac mp3 ogg m4a) * image (supports bmp gif jpg jpeg png svg webp) * pdf (supports pdf) * text (supports csv txt log) * video (supports avi flv m4v mkv mov mp4 mpg qt wmv) * other (supports amr dms vcard tif tiff mpeg) "Relaxed" level allows documents: Content name and supported types * excel (supports xls xlsm xlsx xlc xlt xltm xltx) * presentation (supports key odp otp) * powerpoint (supports pps ppt pptx pot) * spreadsheet (supports numbers ods ots) * word (supports doc docm docx dotm dotx) * word_processing (supports pages odt ott rtf) "Permissive" level allows all documents. However, there are no security level restrictions for content posted through the channel.
      - `creationTime` string, date-time — Creation time of the attachment.
      - `embedded` boolean — Embedded in a content.
      - `filename` string — Filename of the attachment.
      - `id` string — Identifier of the attachment.
      - `public` boolean — Privacy setting of the attachment.
      - `size` integer — Size of the attachment.
      - `lastModifiedTime` string, date-time — The time when the last modification was completed.
      - `uri` string, uri — Uri of the attachment.
    - `authorIdentityId` string, required — Identity identifier of the author of content. Not mandatory on creation, by default it uses the token's user first identity on channel.
    - `autoSubmitted` boolean, required — Auto submitted content: - won't reopen tasks or interventions - can be used to send automatic messages like asking an user to follow on twitter, sending a survey, etc, - doesn't get included in statistics
    - `body` string, required — The content's body. On creation this field is mandatory except for WhatsApp content using templates. The following are the max length restrictions for the different channels supported. Channel and max length * Apple Messages For Business (max length 10000) * Email (max length 262144) * RingCX Digital Messaging (max length 1024) * Facebook (max length 8000) * GoogleBusinessMessages (max length 3000) * Google My Business (max length 4000) * Instagram (max length 950) * Instagram Messaging (max length 1000) * LinkedIn (max length 3000) * Messenger (max length 2000) * Twitter (max length 280) * Viber (max length 7000) * WhatsApp (max length 3800) * Youtube (max length 8000)
    - `bodyFormatted` ContentBodyFormatted, required — Text and HTML formatted versions of the content body.
      - `html` string
      - `text` string
    - `bodyInputFormat` 'Text' | 'Html', required — Values can be Text or Html.
    - `categoryIds` string[], required — List of the category identifiers of the content.
    - `contextData` ContentContextData — Additional data of the content. The contextData hash keys are the custom fields keys.
    - `creationTime` string, date-time, required — Creation time of the resource.
    - `createdFrom` 'Synchronizer' | 'Interface' | 'Api' | 'AutoSurvey' | 'AutoResponseTrigger' | 'AutoRequestEmail', required — Created from of the content.
    - `creatorId` string, required — RC user id of the creator
    - `foreignCategories` string[] — External categories of the content. Present only if the content has foreignCategories.
    - `id` string, required — Identifier of the content.
    - `inReplyToAuthorIdentityId` string, required — The identity identifier of the content to which this content is a reply to.
    - `inReplyToContentId` string, required — The content identifier to which this content is a reply to. On creation, if omitted, a new discussion will be created. If the channel does not support to initiate discussion this parameter is mandatory.
    - `interventionId` string, required — The intervention identifier of the content.
    - `language` string, required — Language of the content.
    - `public` boolean, required — True if the content is publicly visible on the remote channel (default). Private content is NOT supported on every channel.
    - `published` boolean, required — True if the content is published on the remote channel.
    - `rating` integer, required — Rating of the content. Present only if the content supports rating and rating is filled.
    - `remotelyDeleted` boolean, required — True if the content has been deleted on the remote channel.
    - `sourceId` string, required — Identifier of the channel. On creation if `inReplyToContentId` is specified, the channel will be determined from it. Otherwise, this parameter is mandatory.
    - `sourceType` 'AppleMessagesForBusiness' | 'Email' | 'EngageMessaging' | 'Facebook' | 'GoogleBusinessMessages' | 'GoogleMyBusiness' | 'Instagram' | 'InstagramMessaging' | 'Linkedin' | 'Messenger' | 'Twitter' | 'Viber' | 'WhatsApp' | 'Youtube', required — Type of the channel.
    - `sourceUri` string, uri, required — External Uri of the content channel.
    - `status` 'New' | 'Assigned' | 'Replied' | 'UserReply' | 'UserInitiated' | 'Ignored', required — Content status.
    - `synchronizationStatus` string, required — Synchronization status.
    - `synchronizationError` string, required — Synchronization error details.
    - `threadId` string, required — Content thread identifier of the content.
    - `title` string, required — Applicable to Email channels only. The subject of the email. This field is mandatory when initiating a discussion.
    - `type` 'Album' | 'AuthenticateMessage' | 'AuthenticateResponse' | 'Carousel' | 'CarouselMessage' | 'Comment' | 'ContactMessage' | 'Content' | 'Email' | 'FormMessage' | 'FormResponse' | 'HsmMessage' | 'Link' | 'ListMessage' | 'Media' | 'Message' | 'OutboundMessage' | 'PaymentMessage' | 'Photo' | 'PostbackMessage' | 'PrivateTweet' | 'PromptMessage' | 'Question' | 'Review' | 'ReviewResponse' | 'RichLinkMessage' | 'SelectMessage' | 'Status' | 'TemplateMessage' | 'TimePickerMessage' | 'Tweet' | 'Video' | 'VideoCallRequestMessage', required — Type of the content.
    - `lastModifiedTime` string, date-time, required — The time when the last modification was completed.
    - `capabilitiesSupported` string[], required — Types of structured messages that can be used to reply to this type of message.
  - `paging` NonEnumeratedPagingModel, required
    - `perPage` integer, required — Current page size, describes how many items are in each page. Matches "perPage" parameter from the request.
    - `pageToken` string — Current page token. May be omitted if result is empty (because non-existent page was specified or perPage=0 was requested)
    - `nextPageToken` string — A page token to be used to fetch the next page of the result set. May be omitted if the current page is the last one.
    - `previousPageToken` string — A page token to be used to fetch the previous page of the result set. May be omitted if the current page is the first one or if the result set does not support backward navigation.
    - `firstPageToken` string — A page token to be used to fetch the first page of the result set.

## Other responses

- `400` — Error 400 on content creation
- `422` — Error 422 on content list

---

[API](https://skmtc.net/ringcentral/apis/ringcentral-api.md) · [All operations](https://skmtc.net/ringcentral/apis/ringcentral-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/ringcentral/ringcentral-api/revisions/8d602198ec97/schema)