{"id":16977,"date":"2020-10-20T13:17:51","date_gmt":"2020-10-20T00:17:51","guid":{"rendered":"http:\/\/help.psoda.com\/?page_id=16977"},"modified":"2024-12-02T23:59:51","modified_gmt":"2024-12-02T23:59:51","slug":"list-of-descendants","status":"publish","type":"page","link":"https:\/\/www.psoda.com\/help\/list-of-descendants\/","title":{"rendered":"Psoda API: List of descendants"},"content":{"rendered":"<div class='content-column three_fourth'><h3>Psoda API &#8211; \/rest_api\/v2\/objects\/{object id}\/descendants.json<\/h3>\r\nUse this URI to retrieve a list of descendant objects for the selected object identified by {object id}.\r\n\r\nWARNING: This method can return a very large number of results. Please use the filters below to restrict the results to just what you need.\r\n<h3>Header: API-Key (mandatory)<\/h3>\r\nYou must specify an API-Key to access any data from Psoda. You can find your API-Key by logging into Psoda with the user account you want to use for the API, navigate to &#8220;My stuff&#8221; and then click on the &#8220;API Code&#8221; button in the top header area.\r\n<h3>Header: If-Modified-Since (optional)<\/h3>\r\nUse this header if you want to limit the results to only those descendants that have been modified since the specified date. The date is in a text format, e.g. 15 Nov 1994 12:45:26 GMT\r\n<h3>Header: Accept-Language (optional)<\/h3>\r\nUse this header if you want to change the language for the user. The following languages are currently supported:\r\n<ul>\r\n \t<li>af &#8211; Afrikaans<\/li>\r\n \t<li>en &#8211; English<\/li>\r\n \t<li>en-nz &#8211; English<\/li>\r\n \t<li>en-uk &#8211; English<\/li>\r\n \t<li>en-us &#8211; United States English<\/li>\r\n \t<li>ja &#8211; Japanese<\/li>\r\n \t<li>ru &#8211; Russian<\/li>\r\n \t<li>zh-cn &#8211; Simplified Chinese<\/li>\r\n \t<li>zh-hk &#8211; Simplified Chinese<\/li>\r\n \t<li>zh-mo &#8211; Simplified Chinese<\/li>\r\n \t<li>zh-sg &#8211; Simplified Chinese<\/li>\r\n \t<li>zh-tw &#8211; Simplified Chinese<\/li>\r\n \t<li>zh &#8211; Simplified Chinese<\/li>\r\n<\/ul>\r\n<h3>Parameter: pageSize (optional)<\/h3>\r\nYou can use this parameter to specify how many objects you want in your result set. If this is left blank, then 100 objects will be returned as a default.\r\n<h3>Parameter: start (optional)<\/h3>\r\nYou can use this parameter to specify where you want your result set to start from. If this is left blank, 0 will be used and your result set will start from the first object.\r\n<h3>Parameter: lang (optional)<\/h3>\r\nAlternatively, you can use this parameter to set the language.\r\n<h3>Parameter: fields (optional)<\/h3>\r\nYou can use this parameter to limit which attributes are returned from the API call. You can specify multiple fields with commas separating them. If the field does not exist for the item then it will not be included in the result.\r\n<h3>Parameter: classes (optional)<\/h3>\r\nYou can use this parameter to specify the types of descendants that will be returned from the query. It is a comma separted list. For example &#8220;risk,issue,action&#8221;\r\n\r\nA link to the list of available classes: <a href=\"https:\/\/www.psoda.com\/help\/psoda-api-classes\/\">https:\/\/www.psoda.com\/help\/psoda-api-classes\/<\/a>\r\n<h3>Parameter: max_levels (optional)<\/h3>\r\nSet this parameter to the maximum number of levels to include in the results. max_levels=1 is equivalent to using \/children.json. The default is -1 which returns all levels.\r\n<h3>Parameter: include_archived (optional)<\/h3>\r\nThe default is to NOT include any archived items in the query response. You can set this optional parameter to &#8220;true&#8221; to include archived items from being returned.\r\n<h3>Parameter: include_deleted (optional)<\/h3>\r\nThe default is to not include any deleted items in the response. You can set this optional parameter to &#8220;true&#8221; to include deleted items.\r\n<h3>Response: pagination<\/h3>\r\nOur REST API supports pagination. If your pageSize parameter is less than the total amount of objects you&#8217;re querying on, then you will be provided with information that will allow you to obtain the next set of objects. <a href=\"https:\/\/www.psoda.com\/help\/psoda-api-next-page\/\">More details can be found here.<\/a>\r\n\r\n\r\nThe pagination object contains the following fields:\r\n\r\n\r\n<b>cursor<\/b>: If you haven&#8217;t received all of your data in one request, then a cursor will be returned. This cursor can be used in a subsequent next request that will return the next set of objects.\r\n\r\n\r\n<b>start<\/b>: This will show you where your result set has started from. Your first request will start with 0, then increment based on the pageSize parameter (if the pageSize was 100, it would be 0, 100, 200, 300)\r\n\r\n\r\n<b>pageSize<\/b>: This will show how many objects were in the result set, which is specified in the pageSize parameter. If the result set was less than what was specified in the pageSize parameter then this field will reflect that (if the pageSize parameter was set 100 but the result only contained 50 objects, then this field would be 50).\r\n\r\n\r\n<b>total<\/b>: This will show the total amount of objects, when the start field + pageSize field is greater than or equal to this number that means you are at the last request.\r\n<h3>Response: links<\/h3>\r\nIf your pageSize parameter is less than the total amount of objects you&#8217;re querying on, a URI will be given that can be used to retrieve your next page of information. If there is no more data to obtain, this field will be empty. This URI will contain any parameters used in the previous request which can simplify the pagination process.<\/div>\r\n<div class='content-column one_fourth last_column'><h4>Related topics<\/h4>\r\n<ul>\r\n \t<li><a href=\"https:\/\/www.psoda.com\/help\/api-and-integration\/\">API integration home page<\/a><\/li>\r\n \t<li><a href=\"\/help\/top-level\/\">API top level<\/a><\/li>\r\n \t<li><a href=\"\/help\/list-of-child-objects\">Listing child objects API call<\/a><\/li>\r\n \t<li><a href=\"\/help\/psoda-api-next-page\">Psoda API next page call<\/a><\/li>\r\n \t<li><a href=\"\/help\/details-of-a-specific-object\">Details of a specific object<\/a><\/li>\r\n \t<li><a href=\"\/help\/details-of-the-api-user\">Details of the API user<\/a><\/li>\r\n \t<li><a href=\"\/help\/psoda-api-classes\/\">List of available classes for the API<\/a><\/li>\r\n \t<li><a href=\"\/help\/list-of-preferences\">List preferences API call<\/a><\/li>\r\n \t<li><a href=\"\/help\/the-language-string\/\">Retrieve Psoda string by its ID and language<\/a><\/li>\r\n \t<li><a href=\"\/help\/system-time-from-the-server\/\">Retrieve the time on the Psoda server<\/a><\/li>\r\n<\/ul><\/div><div class='clear_column'><\/div>","protected":false},"excerpt":{"rendered":"<p><div class='content-column three_fourth'><\/div>  Psoda API &#8211; \/rest_api\/v2\/objects\/{object id}\/descendants.json  Use this URI to retrieve a list of descendant objects for the selected object identified by {object id}.    WARNING: This method can return a very large number of results. Please use the filters below to restrict the results to just what you need. <\/p>\n","protected":false},"author":1,"featured_media":0,"parent":0,"menu_order":0,"comment_status":"closed","ping_status":"closed","template":"","meta":{"inline_featured_image":false,"footnotes":""},"class_list":["post-16977","page","type-page","status-publish","hentry"],"yoast_head":"<!-- This site is optimized with the Yoast SEO plugin v27.0 - https:\/\/yoast.com\/product\/yoast-seo-wordpress\/ -->\n<title>Psoda API: List of descendants - Psoda Help Centre<\/title>\n<meta name=\"description\" content=\"Read the documentation and learn how to use Psoda&#039;s Psoda API: List of descendants\" \/>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/www.psoda.com\/help\/list-of-descendants\/\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"Psoda API: List of descendants - Psoda Help Centre\" \/>\n<meta property=\"og:description\" content=\"Read the documentation and learn how to use Psoda&#039;s Psoda API: List of descendants\" \/>\n<meta property=\"og:url\" content=\"https:\/\/www.psoda.com\/help\/list-of-descendants\/\" \/>\n<meta property=\"og:site_name\" content=\"Psoda Help Centre\" \/>\n<meta property=\"article:modified_time\" content=\"2024-12-02T23:59:51+00:00\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:label1\" content=\"Est. reading time\" \/>\n\t<meta name=\"twitter:data1\" content=\"4 minutes\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\/\/schema.org\",\"@graph\":[{\"@type\":\"WebPage\",\"@id\":\"https:\/\/www.psoda.com\/help\/list-of-descendants\/\",\"url\":\"https:\/\/www.psoda.com\/help\/list-of-descendants\/\",\"name\":\"Psoda API: List of descendants - Psoda Help Centre\",\"isPartOf\":{\"@id\":\"https:\/\/www.psoda.com\/help\/#website\"},\"datePublished\":\"2020-10-20T00:17:51+00:00\",\"dateModified\":\"2024-12-02T23:59:51+00:00\",\"description\":\"Read the documentation and learn how to use Psoda's Psoda API: List of descendants\",\"breadcrumb\":{\"@id\":\"https:\/\/www.psoda.com\/help\/list-of-descendants\/#breadcrumb\"},\"inLanguage\":\"en-NZ\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\/\/www.psoda.com\/help\/list-of-descendants\/\"]}]},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\/\/www.psoda.com\/help\/list-of-descendants\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Home\",\"item\":\"https:\/\/www.psoda.com\/help\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Psoda API: List of descendants\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\/\/www.psoda.com\/help\/#website\",\"url\":\"https:\/\/www.psoda.com\/help\/\",\"name\":\"Psoda Help Centre\",\"description\":\"Information and support to help you use Psoda\",\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\/\/www.psoda.com\/help\/?s={search_term_string}\"},\"query-input\":{\"@type\":\"PropertyValueSpecification\",\"valueRequired\":true,\"valueName\":\"search_term_string\"}}],\"inLanguage\":\"en-NZ\"}]}<\/script>\n<!-- \/ Yoast SEO plugin. -->","yoast_head_json":{"title":"Psoda API: List of descendants - Psoda Help Centre","description":"Read the documentation and learn how to use Psoda's Psoda API: List of descendants","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/www.psoda.com\/help\/list-of-descendants\/","og_locale":"en_US","og_type":"article","og_title":"Psoda API: List of descendants - Psoda Help Centre","og_description":"Read the documentation and learn how to use Psoda's Psoda API: List of descendants","og_url":"https:\/\/www.psoda.com\/help\/list-of-descendants\/","og_site_name":"Psoda Help Centre","article_modified_time":"2024-12-02T23:59:51+00:00","twitter_card":"summary_large_image","twitter_misc":{"Est. reading time":"4 minutes"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"WebPage","@id":"https:\/\/www.psoda.com\/help\/list-of-descendants\/","url":"https:\/\/www.psoda.com\/help\/list-of-descendants\/","name":"Psoda API: List of descendants - Psoda Help Centre","isPartOf":{"@id":"https:\/\/www.psoda.com\/help\/#website"},"datePublished":"2020-10-20T00:17:51+00:00","dateModified":"2024-12-02T23:59:51+00:00","description":"Read the documentation and learn how to use Psoda's Psoda API: List of descendants","breadcrumb":{"@id":"https:\/\/www.psoda.com\/help\/list-of-descendants\/#breadcrumb"},"inLanguage":"en-NZ","potentialAction":[{"@type":"ReadAction","target":["https:\/\/www.psoda.com\/help\/list-of-descendants\/"]}]},{"@type":"BreadcrumbList","@id":"https:\/\/www.psoda.com\/help\/list-of-descendants\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https:\/\/www.psoda.com\/help\/"},{"@type":"ListItem","position":2,"name":"Psoda API: List of descendants"}]},{"@type":"WebSite","@id":"https:\/\/www.psoda.com\/help\/#website","url":"https:\/\/www.psoda.com\/help\/","name":"Psoda Help Centre","description":"Information and support to help you use Psoda","potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/www.psoda.com\/help\/?s={search_term_string}"},"query-input":{"@type":"PropertyValueSpecification","valueRequired":true,"valueName":"search_term_string"}}],"inLanguage":"en-NZ"}]}},"_links":{"self":[{"href":"https:\/\/www.psoda.com\/help\/wp-json\/wp\/v2\/pages\/16977","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.psoda.com\/help\/wp-json\/wp\/v2\/pages"}],"about":[{"href":"https:\/\/www.psoda.com\/help\/wp-json\/wp\/v2\/types\/page"}],"author":[{"embeddable":true,"href":"https:\/\/www.psoda.com\/help\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/www.psoda.com\/help\/wp-json\/wp\/v2\/comments?post=16977"}],"version-history":[{"count":19,"href":"https:\/\/www.psoda.com\/help\/wp-json\/wp\/v2\/pages\/16977\/revisions"}],"predecessor-version":[{"id":24700,"href":"https:\/\/www.psoda.com\/help\/wp-json\/wp\/v2\/pages\/16977\/revisions\/24700"}],"wp:attachment":[{"href":"https:\/\/www.psoda.com\/help\/wp-json\/wp\/v2\/media?parent=16977"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}