{"id":16983,"date":"2020-10-20T13:19:21","date_gmt":"2020-10-20T00:19:21","guid":{"rendered":"http:\/\/help.psoda.com\/?page_id=16983"},"modified":"2024-12-02T23:59:10","modified_gmt":"2024-12-02T23:59:10","slug":"list-of-child-objects","status":"publish","type":"page","link":"https:\/\/www.psoda.com\/help\/list-of-child-objects\/","title":{"rendered":"Psoda API: List of child objects"},"content":{"rendered":"<div class='content-column three_fourth'><h3>Psoda API &#8211; \/rest_api\/v2\/objects\/{object id}\/children.json<\/h3>\r\nUse this URI to retrieve a list of child objects for the selected object identified by {object id}. You can filter the results using the following parameters:\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 children 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: 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 types of children that will be returned from the query. It is a comma separted list for example &#8220;risk,issue,action&#8221;.\r\n<br>\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: include_archived (optional)<\/h3>\r\nThe default is to include any archived items in the query response. You can set this optional parameter to &#8220;false&#8221; to block 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<br>\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<br>\r\n<br>\r\nThe pagination object contains the following fields:\r\n<br>\r\n<br>\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<br>\r\n<br>\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<br>\r\n<br>\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<br>\r\n<br>\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.\r\n<br>\r\n<br><\/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        <li><a href=\"\/help\/top-level\/\">API top level<\/a><\/li>\r\n \t<li><a href=\"\/help\/list-of-descendants\">Listing descendants 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        <li><a href=\"\/help\/the-language-string\/\">Retrieve Psoda string by its ID and language<\/a><\/li>\r\n        <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}\/children.json  Use this URI to retrieve a list of child objects for the selected object identified by {object id}. You can filter the results using the following parameters:  Header: API-Key (mandatory)  You must specify an API-Key to access any data from Psoda. You can find your<\/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-16983","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 child objects - Psoda Help Centre<\/title>\n<meta name=\"description\" content=\"Read the documentation and learn how to use Psoda&#039;s Psoda API: List of child objects\" \/>\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-child-objects\/\" \/>\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 child objects - Psoda Help Centre\" \/>\n<meta property=\"og:description\" content=\"Read the documentation and learn how to use Psoda&#039;s Psoda API: List of child objects\" \/>\n<meta property=\"og:url\" content=\"https:\/\/www.psoda.com\/help\/list-of-child-objects\/\" \/>\n<meta property=\"og:site_name\" content=\"Psoda Help Centre\" \/>\n<meta property=\"article:modified_time\" content=\"2024-12-02T23:59:10+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-child-objects\/\",\"url\":\"https:\/\/www.psoda.com\/help\/list-of-child-objects\/\",\"name\":\"Psoda API: List of child objects - Psoda Help Centre\",\"isPartOf\":{\"@id\":\"https:\/\/www.psoda.com\/help\/#website\"},\"datePublished\":\"2020-10-20T00:19:21+00:00\",\"dateModified\":\"2024-12-02T23:59:10+00:00\",\"description\":\"Read the documentation and learn how to use Psoda's Psoda API: List of child objects\",\"breadcrumb\":{\"@id\":\"https:\/\/www.psoda.com\/help\/list-of-child-objects\/#breadcrumb\"},\"inLanguage\":\"en-NZ\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\/\/www.psoda.com\/help\/list-of-child-objects\/\"]}]},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\/\/www.psoda.com\/help\/list-of-child-objects\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Home\",\"item\":\"https:\/\/www.psoda.com\/help\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Psoda API: List of child objects\"}]},{\"@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 child objects - Psoda Help Centre","description":"Read the documentation and learn how to use Psoda's Psoda API: List of child objects","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-child-objects\/","og_locale":"en_US","og_type":"article","og_title":"Psoda API: List of child objects - Psoda Help Centre","og_description":"Read the documentation and learn how to use Psoda's Psoda API: List of child objects","og_url":"https:\/\/www.psoda.com\/help\/list-of-child-objects\/","og_site_name":"Psoda Help Centre","article_modified_time":"2024-12-02T23:59:10+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-child-objects\/","url":"https:\/\/www.psoda.com\/help\/list-of-child-objects\/","name":"Psoda API: List of child objects - Psoda Help Centre","isPartOf":{"@id":"https:\/\/www.psoda.com\/help\/#website"},"datePublished":"2020-10-20T00:19:21+00:00","dateModified":"2024-12-02T23:59:10+00:00","description":"Read the documentation and learn how to use Psoda's Psoda API: List of child objects","breadcrumb":{"@id":"https:\/\/www.psoda.com\/help\/list-of-child-objects\/#breadcrumb"},"inLanguage":"en-NZ","potentialAction":[{"@type":"ReadAction","target":["https:\/\/www.psoda.com\/help\/list-of-child-objects\/"]}]},{"@type":"BreadcrumbList","@id":"https:\/\/www.psoda.com\/help\/list-of-child-objects\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https:\/\/www.psoda.com\/help\/"},{"@type":"ListItem","position":2,"name":"Psoda API: List of child objects"}]},{"@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\/16983","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=16983"}],"version-history":[{"count":17,"href":"https:\/\/www.psoda.com\/help\/wp-json\/wp\/v2\/pages\/16983\/revisions"}],"predecessor-version":[{"id":24699,"href":"https:\/\/www.psoda.com\/help\/wp-json\/wp\/v2\/pages\/16983\/revisions\/24699"}],"wp:attachment":[{"href":"https:\/\/www.psoda.com\/help\/wp-json\/wp\/v2\/media?parent=16983"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}