Entries
An entry is the actual piece of content created using one of the defined content types.
You can now pass the branch header in the API request to fetch or manage modules located within specific branches of the stack.
NoteBranches is a plan-based feature that is available only in the new Contentstack interface.
Additionally, you can also set the include_branch query parameter to true to include the _branch top-level key in the response. This key specifies the unique ID of the branch where the concerned Contentstack module resides.
Get all entries
GET
https://cdn.contentstack.io/v3/content_types/{content_type_uid}/entries?locale={locale_code}&include_fallback=trueThe Get all entries request fetches the list of all the entries of a particular content type. It returns the content of each entry in JSON format.
Additionally, if you wish to fetch the metadata attached to each entry, then you need to pass include_metadata as a query parameter. Set this parameter to true to include the entry metadata along with all entries in the response body.
You will find the entry metadata under the _metadata key in the response. It will be associated with a specific extension UID as follows:
"_metadata": {
"extensions": {
"{extension_uid}": [{
"image_copyrights": "Contentstack Branding",
"scope": "local"
}]
}
}
If an entry is not published in a specific locale, make use of the “include_fallback=true” query parameter to fetch the published content from its fallback locale.
Note If the fallback language of the specified locale is the master language itself, this parameter won't be applicable.
To include the publish details in the response, make use of the include_publish_details=true parameter. This will return the publishing details of the entry in every environment along with the version number that is published in each of the environments.
You can add other Queries to extend the functionality of this API call. Add a query parameter named query and provide your query (in JSON format) as the value.
When using Delivery Tokens
- Fetches ONLY published content
Passing the environment as a query parameter is optional but recommended to ensure that the CDN delivers the most recent content
- Locale is optional
- If no locale is specified, it returns the entry from the master locale
- If you specify a locale in the query, it returns the latest published version of the localized entry/entries
- If an entry is not localized, make use of the include_fallback=true query parameter to fetch the published content from its fallback locale
Tip This request returns only the first 100 entries of the specified content type. Refer to the Pagination section to retrieve the rest of your entries in a paginated form.
Sample Response
Status|200 OK
{
"entries": [
{
"locale": "en-us",
"title": "Redmi Note Prime",
"url": "/redmi-note-prime",
"description": "
\n
",
"images": [
{
"uid": "blt50a7a9dd6866776f",
"created_at": "2019-08-16T08:05:18.932Z",
"updated_at": "2019-08-16T08:05:18.932Z",
"created_by": "bltcd82b2c6bf913241",
"updated_by": "bltcd82b2c6bf913241",
"content_type": "image/jpeg",
"file_size": "145200",
"tags": [],
"filename": "01.jpg",
"url": "https://images.contentstack.io/v3/assets/blt02f7b45378b008ee/blt50a7a9dd6866776f/5d5663be34d39437c37c5376/01.jpg",
"ACL": [],
"is_dir": false,
"_version": 1,
"title": "01.jpg",
"publish_details": {
"environment": "blta39a4441696e35e0",
"locale": "en-us",
"time": "2019-08-19T12:28:56.964Z",
"user": "blt587a89fc7883c56700a95bfe"
}
}
],
"categories": [
{
"uid": "blt9d72fa3afc11d27f",
"_content_type_uid": "category"
}
],
"price_in_usd": 117.3,
"brand": [
{
"uid": "blta2e0d2130eb86263",
"_content_type_uid": "brand"
}
],
"launch_date": "2016-08-17",
"instock": true,
"tags": [],
"size": 16,
"color": "Black",
"additional_info": [
{
"rating": {
"stars": 3
}
},
{
"deals": {
"deal_name": "Deals of the Day",
"deal_details": "If you are looking for good Amazon deals and bargains, Deal's of The Day Deals is the place to come. We are your online one-stop shop for savings and specials on our products."
}
}
],
"bank_offers": [
{
"bank": [
{
"uid": "bltd9dc1c7363c42bbd",
"_content_type_uid": "bank"
}
],
"card_type": [
"Debit Card"
],
"discount_in_percentage": 27
},
{
"bank": [
{
"uid": "blt98058bb38f89fc5f",
"_content_type_uid": "bank"
}
],
"card_type": [
"Debit Card",
"Credit Card"
],
"discount_in_percentage": 24
}
],
"ACL": {},
"uid": "blt4f1fd991ec80e52f",
"created_by": "bltcd82b2c6bf913241",
"updated_by": "blt42e55757d70d5f81026a2b9f",
"created_at": "2019-08-16T08:19:25.397Z",
"updated_at": "2019-08-23T13:02:21.457Z",
"_version": 4,
"_in_progress": false,
"publish_details": {
"environment": "blta39a4441696e35e0",
"locale": "en-us",
"time": "2019-08-23T13:02:25.439Z",
"user": "blt42e55757d70d5f81026a2b9f"
}
},
{
"locale": "en-us",
"title": "Redmi Note 3",
"url": "/mobiles/redmi-note-3",
"description": "
",
"images": [
{
"uid": "blt9c3dff6e3151d374",
"created_at": "2019-08-16T08:05:27.886Z",
"updated_at": "2019-08-16T08:05:27.886Z",
"created_by": "bltcd82b2c6bf913241",
"updated_by": "bltcd82b2c6bf913241",
"content_type": "image/jpeg",
"file_size": "5275",
"tags": [],
"filename": "download.jpg",
"url": "https://images.contentstack.io/v3/assets/blt02f7b45378b008ee/blt9c3dff6e3151d374/5d5663c79722fb38d7db52e5/download.jpg",
"ACL": [],
"is_dir": false,
"_version": 1,
"title": "download.jpg",
"publish_details": {
"environment": "blta39a4441696e35e0",
"locale": "en-us",
"time": "2019-08-19T12:28:47.432Z",
"user": "blt587a89fc7883c56700a95bfe"
}
}
],
"categories": [
{
"uid": "blt9d72fa3afc11d27f",
"_content_type_uid": "category"
},
{
"uid": "blt9fa0f59d03862aa7",
"_content_type_uid": "category"
}
],
"price_in_usd": 146,
"brand": [
{
"uid": "blta2e0d2130eb86263",
"_content_type_uid": "brand"
}
],
"launch_date": "2016-03-09",
"instock": true,
"tags": [
"redmi",
"smart"
],
"size": 16,
"color": "Gold",
"additional_info": [
{
"deals": {
"deal_name": "Summer Deal",
"deal_details": "If you are looking for good Amazon deals and bargains, Summer's Deals is the place to come. We are your online one-stop shop for savings and specials on our products."
}
},
{
"rating": {
"stars": 4
}
}
],
"bank_offers": [
{
"bank": [
{
"uid": "bltc00b46e648007a0c",
"_content_type_uid": "bank"
}
],
"card_type": [
"Credit Card"
],
"discount_in_percentage": 12
}
],
"ACL": {},
"uid": "blta278bb5672180c94",
"created_by": "bltcd82b2c6bf913241",
"updated_by": "blt42e55757d70d5f81026a2b9f",
"created_at": "2019-08-16T08:19:27.182Z",
"updated_at": "2019-08-23T13:01:19.866Z",
"_version": 4,
"_in_progress": false,
"publish_details": {
"environment": "blta39a4441696e35e0",
"locale": "en-us",
"time": "2019-08-23T13:01:23.290Z",
"user": "blt42e55757d70d5f81026a2b9f"
}
},
{
"locale": "en-us",
"title": "iPhone 7 128GB",
"url": "/mobiles/iphone-7",
"description": "
",
"images": [
{
"uid": "bltc4f54f7ce3155b0e",
"created_at": "2019-08-16T08:05:15.889Z",
"updated_at": "2019-08-16T08:05:15.889Z",
"created_by": "bltcd82b2c6bf913241",
"updated_by": "bltcd82b2c6bf913241",
"content_type": "image/jpeg",
"file_size": "48163",
"tags": [],
"filename": "iphone7.jpg",
"url": "https://images.contentstack.io/v3/assets/blt02f7b45378b008ee/bltc4f54f7ce3155b0e/5d5663bbdf859f364dbe36dd/iphone7.jpg",
"ACL": [],
"is_dir": false,
"_version": 1,
"title": "iphone7.jpg",
"publish_details": {
"environment": "blta39a4441696e35e0",
"locale": "en-us",
"time": "2019-08-19T12:28:56.964Z",
"user": "blt587a89fc7883c56700a95bfe"
}
}
],
"categories": [
{
"uid": "blt9d72fa3afc11d27f",
"_content_type_uid": "category"
}
],
"price_in_usd": 749,
"brand": [
{
"uid": "blte6095f030e4b7a30",
"_content_type_uid": "brand"
}
],
"launch_date": "2016-09-07",
"instock": true,
"tags": [],
"size": 128,
"color": "Black",
"additional_info": [
{
"rating": {
"stars": 5
}
},
{
"deals": {
"deal_name": "Black Friday Deal",
"deal_details": "If you are looking for good Amazon deals and bargains, Black Friday Deals is the place to come. We are your online one-stop shop for savings and specials on our products."
}
}
],
"bank_offers": [
{
"bank": [
{
"uid": "bltf05621cb52725856",
"_content_type_uid": "bank"
}
],
"card_type": [
"Debit Card"
],
"discount_in_percentage": 12
}
],
"ACL": {},
"uid": "bltbd92ac498e3d5f96",
"created_by": "bltcd82b2c6bf913241",
"updated_by": "blt42e55757d70d5f81026a2b9f",
"created_at": "2019-08-16T08:19:20.072Z",
"updated_at": "2019-08-23T12:50:53.424Z",
"_version": 13,
"_in_progress": false,
"publish_details": {
"environment": "blta39a4441696e35e0",
"locale": "en-us",
"time": "2019-08-23T12:50:56.727Z",
"user": "blt42e55757d70d5f81026a2b9f"
}
},
{
"locale": "en-us",
"title": "iPhone 7 64GB",
"url": "/mobiles/iphone-7",
"description": "
",
"images": [
{
"uid": "bltda02effe8bc97bb9",
"created_at": "2019-08-16T08:05:09.588Z",
"updated_at": "2019-08-16T08:05:09.588Z",
"created_by": "bltcd82b2c6bf913241",
"updated_by": "bltcd82b2c6bf913241",
"content_type": "image/jpeg",
"file_size": "45091",
"tags": [],
"filename": "Apple-iPhone-SE-Rose-Gold.jpg",
"url": "https://images.contentstack.io/v3/assets/blt02f7b45378b008ee/bltda02effe8bc97bb9/5d5663b546d2e3383a96ec5e/Apple-iPhone-SE-Rose-Gold.jpg",
"ACL": [],
"is_dir": false,
"_version": 1,
"title": "Apple-iPhone-SE-Rose-Gold.jpg",
"publish_details": {
"environment": "blta39a4441696e35e0",
"locale": "en-us",
"time": "2019-08-19T12:28:56.964Z",
"user": "blt587a89fc7883c56700a95bfe"
}
}
],
"categories": [
{
"uid": "blt9d72fa3afc11d27f",
"_content_type_uid": "category"
},
{
"uid": "blt9fa0f59d03862aa7",
"_content_type_uid": "category"
}
],
"price_in_usd": 649,
"brand": [
{
"uid": "blte6095f030e4b7a30",
"_content_type_uid": "brand"
}
],
"launch_date": "2016-09-07",
"instock": true,
"tags": [],
"size": 32,
"color": "Rose Gold",
"additional_info": [
{
"rating": {
"stars": 5
}
},
{
"deals": {
"deal_name": "Independence Day Deal",
"deal_details": "If you are looking for good Amazon deals and bargains, Independence Day Deals is the place to come. We are your online one-stop shop for savings and specials on our products."
}
},
{
"related_products": {
"products": [
{
"uid": "bltbd92ac498e3d5f96",
"_content_type_uid": "product"
}
]
}
}
],
"bank_offers": [
{
"bank": [
{
"uid": "blt98058bb38f89fc5f",
"_content_type_uid": "bank"
}
],
"card_type": [
"Credit Card"
],
"discount_in_percentage": 60
},
{
"bank": [
{
"uid": "bltd9dc1c7363c42bbd",
"_content_type_uid": "bank"
}
],
"card_type": [
"Credit Card",
"Debit Card"
],
"discount_in_percentage": 55
}
],
"ACL": {},
"uid": "blt70cc672f4f806d3e",
"created_by": "bltcd82b2c6bf913241",
"updated_by": "blt42e55757d70d5f81026a2b9f",
"created_at": "2019-08-16T08:19:23.624Z",
"updated_at": "2019-08-23T12:42:21.386Z",
"_version": 4,
"_in_progress": false,
"publish_details": {
"environment": "blta39a4441696e35e0",
"locale": "en-us",
"time": "2019-08-23T12:59:36.361Z",
"user": "blt42e55757d70d5f81026a2b9f"
}
},
{
"locale": "en-us",
"title": "Galaxy Note",
"url": "/mobiles/galaxy-note",
"description": "
",
"size": 32,
"color": "Gold",
"images": [
{
"uid": "blt19c34e5374418484",
"created_at": "2019-08-16T08:05:30.460Z",
"updated_at": "2019-08-16T08:05:30.460Z",
"created_by": "bltcd82b2c6bf913241",
"updated_by": "bltcd82b2c6bf913241",
"content_type": "image/jpeg",
"file_size": "69609",
"tags": [],
"filename": "in-galaxy-note-5-n9208-sm-n9208zdvins-000000003-back-gold.jpg",
"url": "https://images.contentstack.io/v3/assets/blt02f7b45378b008ee/blt19c34e5374418484/5d5663ca9e9032233cab321a/in-galaxy-note-5-n9208-sm-n9208zdvins-000000003-back-gold.jpg",
"ACL": [],
"is_dir": false,
"_version": 1,
"title": "in-galaxy-note-5-n9208-sm-n9208zdvins-000000003-back-gold.jpg",
"publish_details": {
"environment": "blta39a4441696e35e0",
"locale": "en-us",
"time": "2019-08-19T12:28:47.432Z",
"user": "blt587a89fc7883c56700a95bfe"
}
},
{
"uid": "bltf8c7852efd06d11f",
"created_at": "2019-08-16T08:05:05.009Z",
"updated_at": "2019-08-16T08:05:05.009Z",
"created_by": "bltcd82b2c6bf913241",
"updated_by": "bltcd82b2c6bf913241",
"content_type": "image/png",
"file_size": "63422",
"tags": [],
"filename": "in-galaxy-note-5-n9208-sm-n9208zdvins-000000006-l30-2-gold-thumb.png",
"url": "https://images.contentstack.io/v3/assets/blt02f7b45378b008ee/bltf8c7852efd06d11f/5d5663b166aa1a361fba10f9/in-galaxy-note-5-n9208-sm-n9208zdvins-000000006-l30-2-gold-thumb.png",
"ACL": [],
"is_dir": false,
"_version": 1,
"title": "in-galaxy-note-5-n9208-sm-n9208zdvins-000000006-l30-2-gold-thumb.png",
"publish_details": {
"environment": "blta39a4441696e35e0",
"locale": "en-us",
"time": "2019-08-19T12:29:04.717Z",
"user": "blt587a89fc7883c56700a95bfe"
}
}
],
"categories": [
{
"uid": "blt9d72fa3afc11d27f",
"_content_type_uid": "category"
}
],
"price_in_usd": 101,
"brand": [
{
"uid": "blt5499dd00bb716b14",
"_content_type_uid": "brand"
}
],
"launch_date": "2016-07-07",
"instock": false,
"tags": [
"redmi"
],
"additional_info": [
{
"rating": {
"stars": 2
}
},
{
"deals": {
"deal_name": "Christmas Deal",
"deal_details": "If you are looking for good Amazon deals and bargains, Christma's Deals is the place to come. We are your online one-stop shop for savings and specials on our products."
}
},
{
"related_products": {
"products": [
{
"uid": "bltf8ab1ad67af3c66b",
"_content_type_uid": "product"
}
]
}
}
],
"bank_offers": [
{
"bank": [
{
"uid": "blt6e94809281fc418f",
"_content_type_uid": "bank"
}
],
"card_type": [
"Debit Card"
],
"discount_in_percentage": 8
}
],
"ACL": {},
"uid": "blt5b85ef3b0587565c",
"created_by": "bltcd82b2c6bf913241",
"updated_by": "blt42e55757d70d5f81026a2b9f",
"created_at": "2019-08-16T08:19:18.286Z",
"updated_at": "2019-08-23T12:41:55.402Z",
"_version": 4,
"_in_progress": false,
"publish_details": {
"environment": "blta39a4441696e35e0",
"locale": "en-us",
"time": "2019-08-23T12:41:59.165Z",
"user": "blt42e55757d70d5f81026a2b9f"
}
},
{
"locale": "en-us",
"title": "Redmi 3S",
"url": "/mobiles/redmi-3s",
"description": "
\n
",
"images": [
{
"uid": "blt198546991c0eea0a",
"created_at": "2019-08-16T08:05:21.114Z",
"updated_at": "2019-08-16T08:05:21.114Z",
"created_by": "bltcd82b2c6bf913241",
"updated_by": "bltcd82b2c6bf913241",
"content_type": "image/jpeg",
"file_size": "28485",
"tags": [],
"filename": "xiaomi-redmi-note-3-gray.jpg",
"url": "https://images.contentstack.io/v3/assets/blt02f7b45378b008ee/blt198546991c0eea0a/5d5663c1295d353852cf6bce/xiaomi-redmi-note-3-gray.jpg",
"ACL": [],
"is_dir": false,
"_version": 1,
"title": "xiaomi-redmi-note-3-gray.jpg",
"publish_details": {
"environment": "blta39a4441696e35e0",
"locale": "en-us",
"time": "2019-08-19T12:28:56.964Z",
"user": "blt587a89fc7883c56700a95bfe"
}
}
],
"categories": [
{
"uid": "blt9d72fa3afc11d27f",
"_content_type_uid": "category"
}
],
"price_in_usd": 102.63,
"brand": [
{
"uid": "blta2e0d2130eb86263",
"_content_type_uid": "brand"
}
],
"launch_date": "2016-08-17",
"instock": true,
"tags": [],
"size": 16,
"color": "Gray",
"additional_info": [
{
"rating": {
"stars": 3
}
},
{
"deals": {
"deal_name": "Christmas Deal",
"deal_details": "If you are looking for good Amazon deals and bargains, Christma's Deals is the place to come. We are your online one-stop shop for savings and specials on our products."
}
},
{
"related_products": {
"products": [
{
"uid": "blta278bb5672180c94",
"_content_type_uid": "product"
}
]
}
}
],
"bank_offers": [
{
"bank": [
{
"uid": "blt8312af2299516ccf",
"_content_type_uid": "bank"
}
],
"card_type": [],
"discount_in_percentage": 15
}
],
"ACL": {},
"uid": "bltf2fa776b05a127a2",
"created_by": "bltcd82b2c6bf913241",
"updated_by": "blt42e55757d70d5f81026a2b9f",
"created_at": "2019-08-16T08:19:21.851Z",
"updated_at": "2019-08-23T12:41:07.543Z",
"_version": 5,
"_in_progress": false,
"publish_details": {
"environment": "blta39a4441696e35e0",
"locale": "en-us",
"time": "2019-08-23T12:41:13.700Z",
"user": "blt42e55757d70d5f81026a2b9f"
}
},
{
"locale": "en-us",
"title": "Galaxy J1",
"url": "/mobiles/galaxyj1",
"description": "
",
"images": [
{
"uid": "blt11b00b9a335ed526",
"created_at": "2019-08-16T08:05:18.935Z",
"updated_at": "2019-08-16T08:05:18.935Z",
"created_by": "bltcd82b2c6bf913241",
"updated_by": "bltcd82b2c6bf913241",
"content_type": "image/jpeg",
"file_size": "166189",
"tags": [],
"filename": "samsung-galaxy-j1.jpg",
"url": "https://images.contentstack.io/v3/assets/blt02f7b45378b008ee/blt11b00b9a335ed526/5d5663be995bf53944dfaf7b/samsung-galaxy-j1.jpg",
"ACL": [],
"is_dir": false,
"_version": 1,
"title": "samsung-galaxy-j1.jpg",
"publish_details": {
"environment": "blta39a4441696e35e0",
"locale": "en-us",
"time": "2019-08-19T12:28:56.964Z",
"user": "blt587a89fc7883c56700a95bfe"
}
}
],
"categories": [
{
"uid": "blt9d72fa3afc11d27f",
"_content_type_uid": "category"
},
{
"uid": "blt9fa0f59d03862aa7",
"_content_type_uid": "category"
}
],
"price_in_usd": 159.78,
"brand": [
{
"uid": "blt5499dd00bb716b14",
"_content_type_uid": "brand"
}
],
"launch_date": "2017-01-06",
"instock": true,
"tags": [],
"size": 8,
"color": "Black",
"additional_info": [
{
"rating": {
"stars": 4
}
},
{
"deals": {
"deal_name": "Black Friday Deal",
"deal_details": "If you are looking for good Amazon deals and bargains, Black Friday Deals is the place to come. We are your online one-stop shop for savings and specials on our products."
}
}
],
"bank_offers": [
{
"bank": [
{
"uid": "bltc00b46e648007a0c",
"_content_type_uid": "bank"
}
],
"card_type": [
"Credit Card",
"Debit Card"
],
"discount_in_percentage": 25
},
{
"bank": [
{
"uid": "blt6e94809281fc418f",
"_content_type_uid": "bank"
}
],
"card_type": [
"Credit Card"
],
"discount_in_percentage": 30
}
],
"ACL": {},
"uid": "bltf8ab1ad67af3c66b",
"created_by": "bltcd82b2c6bf913241",
"updated_by": "blt42e55757d70d5f81026a2b9f",
"created_at": "2019-08-16T08:19:28.965Z",
"updated_at": "2019-08-23T11:38:15.309Z",
"_version": 3,
"_in_progress": false,
"publish_details": {
"environment": "blta39a4441696e35e0",
"locale": "en-us",
"time": "2019-08-23T11:38:18.546Z",
"user": "blt42e55757d70d5f81026a2b9f"
}
}
]
}Get a single entry
GET
https://cdn.contentstack.io/v3/content_types/{content_type_uid}/entries/{entry_uid}The Get a single entry request fetches a particular entry of a content type.
TipTo get a specific version, refer to the Get a Single Entry management API. This request returns only the latest version.
Additionally, if you wish to fetch the metadata attached to each entry, then you need to pass include_metadata as a query parameter. Set this parameter to true to include the entry metadata along with all entries in the response body.
You will find the entry metadata under the _metadata key in the response. It will be associated with a specific extension UID as follows:
"_metadata": {
"extensions": {
"{extension_uid}": [{
"image_copyrights": "Contentstack Branding",
"scope": "local"
}]
}
}
If an entry is not published in a specific locale, make use of the “include_fallback=true” query parameter to fetch the published content from its fallback locale.
Note If the fallback language of the specified locale is the master language itself, this parameter won't be applicable.
To include the publish details in the response, make use of the include_publish_details=true parameter. This will return the publishing details of the entry in every environment along with the version number that is published in each of the environments.
NoteTo retrieve an entry from a particular branch, provide the branch_uid under the branch header.
You can add other Queries to extend the functionality of this API call. Add a query parameter named query and provide your query (in JSON format) as the value.
When using Delivery Tokens
- Fetches ONLY published content
Passing the environment as a query parameter is optional but recommended to ensure that the CDN delivers the most recent content
- Locale is optional
- If no locale is specified, it returns the entry from the master locale
- If you specify a locale in the query, it returns the latest published version of the localized entry/entries
- If an entry is not localized, make use of the include_fallback=true query parameter to fetch the published content from its fallback locale
Sample Response
Status|200 OK
{
"entry": {
"locale": "en-us",
"title": "Redmi Note 3",
"url": "/mobiles/redmi-note-3",
"description": "
",
"images": [{
"uid": "blt9c3dff6e3151d374",
"created_at": "2019-08-16T08:05:27.886Z",
"updated_at": "2019-08-16T08:05:27.886Z",
"created_by": "bltcd82b2c6bf913241",
"updated_by": "bltcd82b2c6bf913241",
"content_type": "image/jpeg",
"file_size": "5275",
"tags": [],
"filename": "download.jpg",
"url": "https://images.contentstack.io/v3/assets/blt02f7b45378b008ee/blt9c3dff6e3151d374/5d5663c79722fb38d7db52e5/download.jpg",
"ACL": [],
"is_dir": false,
"_version": 1,
"title": "download.jpg",
"publish_details": {
"environment": "blta39a4441696e35e0",
"locale": "en-us",
"time": "2019-08-19T12:28:47.432Z",
"user": "blt587a89fc7883c56700a95bfe"
}
}],
"categories": [{
"uid": "blt9d72fa3afc11d27f",
"_content_type_uid": "category"
},
{
"uid": "blt9fa0f59d03862aa7",
"_content_type_uid": "category"
}
],
"price_in_usd": 146,
"brand": [{
"uid": "blta2e0d2130eb86263",
"_content_type_uid": "brand"
}],
"launch_date": "2016-03-09",
"instock": true,
"tags": [
"redmi",
"smart"
],
"size": 16,
"color": "Gold",
"additional_info": [{
"deals": {
"deal_name": "Summer Deal",
"deal_details": "If you are looking for good Amazon deals and bargains, Summer's Deals is the place to come. We are your online one-stop shop for savings and specials on our products."
}
},
{
"rating": {
"stars": 4
}
}
],
"bank_offers": [{
"bank": [{
"uid": "bltc00b46e648007a0c",
"_content_type_uid": "bank"
}],
"card_type": [
"Credit Card"
],
"discount_in_percentage": 12
}],
"ACL": {},
"uid": "blta278bb5672180c94",
"created_by": "bltcd82b2c6bf913241",
"updated_by": "blt42e55757d70d5f81026a2b9f",
"created_at": "2019-08-16T08:19:27.182Z",
"updated_at": "2019-08-23T13:01:19.866Z",
"_version": 4,
"_in_progress": false,
"publish_details": {
"environment": "blta39a4441696e35e0",
"locale": "en-us",
"time": "2019-08-23T13:01:23.290Z",
"user": "blt42e55757d70d5f81026a2b9f"
}
}
}Get information on embedded RTE objects
GET
https://cdn.contentstack.io/v3/content_types/{content_type_uid}/entries/{entry_uid}?&locale={locale_code}&include_embedded_items[]=BASEThe Get information on embedded RTE objects request returns comprehensive information on all entries and/or assets embedded within the Rich Text Editor field.
If your entry contains a Rich Text Editor field and you wish to fetch the content schema of the items embedded inside the rich text, then you need to pass the include_embedded_items[]=BASE query parameter.
You can view information about the embedded objects under the _embedded_items parameter in the JSON response body.
NoteContentstack’s Content Delivery SDKs help consume the embedded entries and assets returned in the API response. You can then render the embedded objects on the front end however required.
Sample Response
Status|200 OK
{
"entry": {
"title": "Sample One",
"tags": [],
"locale": "en-us",
"uid": "blte16f93640bfa7f93",
"created_by": "blt3cs27664f6b61df3",
"updated_by": "blt3df27964f6b61df3",
"created_at": "2022-11-30T05:43:01.357Z",
"updated_at": "2022-12-02T07:26:27.624Z",
"ACL": {},
"_version": 4,
"_in_progress": false,
"_embedded_items": {
"rich_text_editor": [
{
"title": "Test Entry",
"json_rte": {
"type": "doc",
"attrs": {},
"uid": "40d2bcb7222f4712a27cbd906295b437",
"children": [
{
"type": "p",
"uid": "78ca555c91aa4bbbaa93fd13b1974649",
"attrs": {},
"children": [
{
"text": "Sample blog content."
}
]
}
],
"_version": 2
},
"rich_text_editor": "
",
"modular_blocks": [
{
"block_1": {
"rich_text_editor": "
",
"_metadata": {
"uid": "cs5a4e5837bbac8516"
}
}
}
],
"tags": [],
"locale": "en-us",
"uid": "bltdf3d45019b5ef76c",
"created_by": "blt3cf27834e6b61df3",
"updated_by": "blt3cf37864e6b61df3",
"created_at": "2022-11-29T11:12:23.183Z",
"updated_at": "2022-12-02T07:25:54.847Z",
"_content_type_uid": "sample",
"ACL": {},
"_version": 2,
"_workflow": {
"uid": "blt1198186676a58926",
"updated_at": "2022-11-29T11:12:23.183Z",
"updated_by": "blt3cf27864e6b61df3",
"version": 1
},
"_in_progress": false
},
{
"uid": "blt3324e18f48c4d71c",
"created_at": "2022-08-17T06:11:07.365Z",
"updated_at": "2022-08-17T06:11:54.542Z",
"created_by": "blt3cf27864e6b61df3",
"updated_by": "blt3cf27864e6b61df3",
"content_type": "image/jpeg",
"file_size": "1161714",
"tags": [],
"filename": "1.jpg",
"url": "https://images.contentstack.io/v3/assets/blta8a5690107d35d6e/blt3324e18f48c4d71c/62fc867b9b71c064a0584583/1.jpg",
"ACL": [],
"parent_uid": null,
"_version": 2,
"title": "1.jpg",
"_content_type_uid": "sys_assets"
}
]
},
"rich_text_editor": "
"
}
}Get all entries with defined taxonomies
GET
https://cdn.contentstack.io/v3/taxonomies/entries?query={"taxonomies.taxonomy_uid": "term_uid"}The Get all entries with defined taxonomies request returns comprehensive information of all the entries associated with a specific taxonomy or term available in a particular stack in your organization.
To retrieve entries that match only taxonomy and term UID and belong to a specific content type.
query={
"taxonomies.taxonomy_uid" : "term_uid",
"_content_type_uid": "_content_type_uid"
}Example: If you want to match entries with the term red from the products content type.
query={
"taxonomies.color" : "red",
"_content_type_uid": "products"
}To retrieve entries that match only taxonomy and term UID and belong to multiple content types.
query={
"taxonomies.taxonomy_uid" : "term_uid",
"_content_type_uid": { "$in" : ["_content_type_uid1", "_content_type_uid2"] }
}Example: If you want to match entries with the term red from the products or blogs content types.
query={
"taxonomies.color" : "red",
"_content_type_uid": { "$in" : ["products", "blogs"] }
}NoteRefer to the Taxonomy Queries section for more query filters.
Sample Response
Status|200 OK
{
"entries": [
{
"uid": "entry_uid_1",
"title": "Summer Hat",
"color": [
{
"uid": "yellow",
"name": "Yellow",
"depth": 1,
"order": 2
}
],
"_content_type_uid": "accessories"
}
]
}