---
title: Get content by given content url or by list of GUID/Reference with given language
slug: cms-12/api/get-content-by-given-content-url-or-by-list-of-guidreference-with-given-language
docTags:
createdAt: 2026-08-28T13:16:06.833Z
---
{
"id": "3nDU-X0qr8E_8yqtUvNtc",
"type": "api-oas-v2",
"data": {
"method": "GET",
"url": "http://localhost:65349//api/episerver/v2.0/content",
"servers": [
{
"url": "http://localhost:65349//api/episerver/v2.0/content"
}
],
"name": "Get content by given content url or by list of GUID/Reference with given language",
"description": "If {matchExact}\"/> is set to false then it will route to the \"nearest\" content. Remaining segments are ignored. The url for the returned content can be\r\nused to determine if segments where ignored.\r\nOnly use contentUrl or guids/references for seperate request. Use contentUrl for get content by url and guids for get content by list of GUID/Reference.
",
"contentType": "application/json",
"request": {
"pathParameters": [],
"headerParameters": [
{
"name": "accept",
"type": "string",
"kind": "optional",
"description": "Generated from available response content types",
"enum": [
"application/json",
"text/json",
"application/xml",
"text/xml"
],
"default": "application/json"
},
{
"kind": "optional",
"name": "Accept-Language",
"type": "string",
"description": "Determines in which language the content should be retrieved. Example: 'en' or 'sv'
"
},
{
"kind": "required",
"name": "Authorization",
"type": "string",
"description": "It should be in the format 'Bearer your_token', where 'your_token' is the token provided after authorization to access API. Note that there should be a space between 'Bearer' and 'your_token'.
"
}
],
"queryParameters": [
{
"kind": "optional",
"name": "contentUrl",
"type": "string",
"description": "The absolute url to the content"
},
{
"kind": "optional",
"name": "guids",
"type": "string",
"description": "List of GUID seperated by ','
"
},
{
"kind": "optional",
"name": "references",
"type": "string",
"description": "List of ContentReference seperated by ','
"
},
{
"kind": "optional",
"name": "expand",
"type": "string",
"description": "List of properties needed to be expanded. The list is separated by comma"
},
{
"kind": "optional",
"name": "select",
"type": "string",
"description": "List of properties needed to be returned. The list is separated by comma. Default are all properties returned"
},
{
"kind": "optional",
"name": "matchExact",
"type": "boolean",
"description": "Specifies if the specified {contentUrl} should match url of the content exactly, that is no additional segments are allowed.
"
}
],
"bodyDataParameters": [],
"formDataParameters": [],
"oAuthParameters": [],
"cookieParameters": []
},
"responses": [
{
"statusCode": "200",
"description": "OK",
"jsonExample": "",
"isExpanded": true,
"schema": [
{
"kind": "optional",
"type": "array",
"description": "",
"customType": "ContentApiModel[]",
"schema": [
{
"name": "ContentLink",
"kind": "optional",
"type": "object",
"description": "",
"modelRef": "#/components/schemas/ContentModelReference",
"customType": "ContentModelReference",
"schema": [
{
"name": "Id",
"kind": "optional",
"type": "integer",
"description": "",
"format": "int32"
},
{
"name": "WorkId",
"kind": "optional",
"type": "integer",
"description": "",
"format": "int32"
},
{
"name": "GuidValue",
"kind": "optional",
"type": "string",
"description": "",
"example": "00000000-0000-0000-0000-000000000000",
"format": "uuid"
},
{
"name": "ProviderName",
"kind": "optional",
"type": "string",
"description": ""
},
{
"name": "Url",
"kind": "optional",
"type": "string",
"description": ""
},
{
"name": "Language",
"kind": "optional",
"type": "object",
"description": "",
"modelRef": "#/components/schemas/LanguageModel",
"customType": "LanguageModel",
"schema": [
{
"name": "DisplayName",
"kind": "optional",
"type": "string",
"description": ""
},
{
"name": "Name",
"kind": "optional",
"type": "string",
"description": ""
}
]
},
{
"name": "Expanded",
"kind": "optional",
"type": "object",
"description": "",
"modelRef": "#/components/schemas/ContentApiModel",
"customType": "ContentApiModel",
"schema": [
{
"name": "",
"description": "",
"customType": "Circular-Reference"
}
]
}
]
},
{
"name": "Name",
"kind": "optional",
"type": "string",
"description": ""
},
{
"name": "Language",
"kind": "optional",
"type": "object",
"description": "",
"modelRef": "#/components/schemas/LanguageModel",
"customType": "LanguageModel",
"schema": [
{
"name": "DisplayName",
"kind": "optional",
"type": "string",
"description": ""
},
{
"name": "Name",
"kind": "optional",
"type": "string",
"description": ""
}
]
},
{
"name": "ExistingLanguages",
"kind": "optional",
"type": "array",
"description": "",
"modelRef": "#/components/schemas/LanguageModel",
"customType": "LanguageModel[]",
"schema": [
{
"name": "DisplayName",
"kind": "optional",
"type": "string",
"description": ""
},
{
"name": "Name",
"kind": "optional",
"type": "string",
"description": ""
}
]
},
{
"name": "MasterLanguage",
"kind": "optional",
"type": "object",
"description": "",
"modelRef": "#/components/schemas/LanguageModel",
"customType": "LanguageModel",
"schema": [
{
"name": "DisplayName",
"kind": "optional",
"type": "string",
"description": ""
},
{
"name": "Name",
"kind": "optional",
"type": "string",
"description": ""
}
]
},
{
"name": "ContentType",
"kind": "optional",
"type": "array",
"description": "",
"example": "",
"itemType": "string",
"customType": "string[]",
"itemExample": "",
"itemDefault": ""
},
{
"name": "ParentLink",
"kind": "optional",
"type": "object",
"description": "",
"modelRef": "#/components/schemas/ContentModelReference",
"customType": "ContentModelReference",
"schema": [
{
"name": "Id",
"kind": "optional",
"type": "integer",
"description": "",
"format": "int32"
},
{
"name": "WorkId",
"kind": "optional",
"type": "integer",
"description": "",
"format": "int32"
},
{
"name": "GuidValue",
"kind": "optional",
"type": "string",
"description": "",
"example": "00000000-0000-0000-0000-000000000000",
"format": "uuid"
},
{
"name": "ProviderName",
"kind": "optional",
"type": "string",
"description": ""
},
{
"name": "Url",
"kind": "optional",
"type": "string",
"description": ""
},
{
"name": "Language",
"kind": "optional",
"type": "object",
"description": "",
"modelRef": "#/components/schemas/LanguageModel",
"customType": "LanguageModel",
"schema": [
{
"name": "DisplayName",
"kind": "optional",
"type": "string",
"description": ""
},
{
"name": "Name",
"kind": "optional",
"type": "string",
"description": ""
}
]
},
{
"name": "Expanded",
"kind": "optional",
"type": "object",
"description": "",
"modelRef": "#/components/schemas/ContentApiModel",
"customType": "ContentApiModel",
"schema": [
{
"name": "",
"description": "",
"customType": "Circular-Reference"
}
]
}
]
},
{
"name": "RouteSegment",
"kind": "optional",
"type": "string",
"description": ""
},
{
"name": "Url",
"kind": "optional",
"type": "string",
"description": ""
},
{
"name": "Changed",
"kind": "optional",
"type": "string",
"description": "",
"format": "date-time"
},
{
"name": "Created",
"kind": "optional",
"type": "string",
"description": "",
"format": "date-time"
},
{
"name": "StartPublish",
"kind": "optional",
"type": "string",
"description": "",
"format": "date-time"
},
{
"name": "StopPublish",
"kind": "optional",
"type": "string",
"description": "",
"format": "date-time"
},
{
"name": "Saved",
"kind": "optional",
"type": "string",
"description": "",
"format": "date-time"
},
{
"name": "Status",
"kind": "optional",
"type": "string",
"description": ""
}
],
"modelRef": "#/components/schemas/ContentApiModel",
"isExpanded": true
}
]
},
{
"statusCode": "400",
"description": "Bad Request",
"jsonExample": "",
"isExpanded": true
},
{
"statusCode": "403",
"description": "Forbidden",
"jsonExample": "",
"isExpanded": true
},
{
"statusCode": "404",
"description": "Not Found",
"jsonExample": "",
"isExpanded": true
}
],
"hasXCodeSamples": false,
"examples": {
"languages": [
{
"id": "J7wdzzVD7MUGsADHt01Zd",
"language": "curl",
"label": "cURL",
"code": "curl --request GET \\\n --url http://localhost:65349//api/episerver/v2.0/content \\\n --header 'accept: application/json' \\\n --header 'authorization: string'"
},
{
"id": "Cc5L20Uaot_5cj5_737qA",
"language": "javascript",
"label": "javascript",
"code": "var myHeaders = new Headers();\nmyHeaders.append(\"accept\", \"application/json\");\nmyHeaders.append(\"content-type\", \"application/json\");\nmyHeaders.append(\"authorization\", \"string\");\n\nvar requestOptions = {\n method: 'GET',\n headers: myHeaders,\n redirect: 'follow'\n};\n\nfetch(\"http://localhost:65349//api/episerver/v2.0/content\", requestOptions)\n .then(response => response.text())\n .then(result => console.log(result))\n .catch(error => console.log('error', error));"
},
{
"id": "NXdkBuQ7TxHSQL_hYlWM8",
"language": "ruby",
"label": "Ruby",
"code": "require \"uri\"\nrequire \"json\"\nrequire \"net/http\"\n\nurl = URI(\"http://localhost:65349//api/episerver/v2.0/content\")\n\nhttp = Net::HTTP.new(url.host, url.port);\nrequest = Net::HTTP::Get.new(url)\nrequest[\"accept\"] = \"application/json\"\nrequest[\"content-type\"] = \"application/json\"\nrequest[\"authorization\"] = \"string\"\n\nresponse = http.request(request)\nputs response.read_body\n"
},
{
"id": "leNwVqZdJAcLHwkj5ut9M",
"language": "python",
"label": "Python",
"code": "import requests\nimport json\n\nurl = \"http://localhost:65349//api/episerver/v2.0/content\"\n\npayload = {}\nheaders = {\n 'accept': 'application/json',\n 'content-type': 'application/json',\n 'authorization': 'string'\n}\n\nresponse = requests.request(\"GET\", url, headers=headers, data=payload)\n\nprint(response.text)\n"
}
],
"selectedLanguageId": "J7wdzzVD7MUGsADHt01Zd"
},
"results": {
"languages": [
{
"id": "response-0-200",
"language": "200",
"code": "// OK\n[\n {\n \"ContentLink\": {\n \"Id\": \"\",\n \"WorkId\": \"\",\n \"GuidValue\": \"00000000-0000-0000-0000-000000000000\",\n \"ProviderName\": \"\",\n \"Url\": \"\",\n \"Language\": {\n \"DisplayName\": \"\",\n \"Name\": \"\"\n },\n \"Expanded\": {\n \"\": \"\"\n }\n },\n \"Name\": \"\",\n \"Language\": {\n \"DisplayName\": \"\",\n \"Name\": \"\"\n },\n \"ExistingLanguages\": [\n {\n \"DisplayName\": \"\",\n \"Name\": \"\"\n }\n ],\n \"MasterLanguage\": {\n \"DisplayName\": \"\",\n \"Name\": \"\"\n },\n \"ContentType\": [\n \"\"\n ],\n \"ParentLink\": {\n \"Id\": \"\",\n \"WorkId\": \"\",\n \"GuidValue\": \"00000000-0000-0000-0000-000000000000\",\n \"ProviderName\": \"\",\n \"Url\": \"\",\n \"Language\": {\n \"DisplayName\": \"\",\n \"Name\": \"\"\n },\n \"Expanded\": {\n \"\": \"\"\n }\n },\n \"RouteSegment\": \"\",\n \"Url\": \"\",\n \"Changed\": \"\",\n \"Created\": \"\",\n \"StartPublish\": \"\",\n \"StopPublish\": \"\",\n \"Saved\": \"\",\n \"Status\": \"\"\n }\n]"
},
{
"id": "response-1-400",
"language": "400",
"code": "// Bad Request\n"
},
{
"id": "response-2-403",
"language": "403",
"code": "// Forbidden\n"
},
{
"id": "response-3-404",
"language": "404",
"code": "// Not Found\n"
}
],
"selectedLanguageId": "response-0-200"
}
},
"children": [
{
"text": ""
}
]
}