GetFolders1

# GetFolders1 API

Returns the list of direct subfolders of the specified folder in short form (folder names and IDs only). This is a lightweight alternative to GetFolders when you do not need rules, property sets, security, or owner details.

Endpoint¶

/srv.asmx/GetFolders1

Methods¶

GET /srv.asmx/GetFolders1?authenticationTicket=...&Path=...
POST /srv.asmx/GetFolders1 (form data)
SOAP Action: http://tempuri.org/GetFolders1

Parameters¶

Parameter	Type	Required	Description
`authenticationTicket`	string	Yes	Authentication ticket obtained from `AuthenticateUser`.
`Path`	string	Yes	Full infoRouter path to the parent folder (e.g. `/Finance`).

Response¶

Success Response¶

<response success="true">
  <folder id="456" name="Reports" />
  <folder id="457" name="Invoices" />
  <folder id="458" name="Contracts" />
</response>

Error Response¶

<response error="Folder not found." />

Required Permissions¶

The calling user must have read permission on the parent folder. Only subfolders the user has access to are returned.

Example¶

GET Request¶

GET /srv.asmx/GetFolders1
  ?authenticationTicket=3f2504e0-4f89-11d3-9a0c-0305e82c3301
  &Path=/Finance
HTTP/1.1

POST Request¶

POST /srv.asmx/GetFolders1 HTTP/1.1
Content-Type: application/x-www-form-urlencoded

authenticationTicket=3f2504e0-4f89-11d3-9a0c-0305e82c3301
&Path=/Finance

SOAP Request¶

<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"
               xmlns:tns="http://tempuri.org/">
  <soap:Body>
    <tns:GetFolders1>
      <tns:authenticationTicket>3f2504e0-4f89-11d3-9a0c-0305e82c3301</tns:authenticationTicket>
      <tns:Path>/Finance</tns:Path>
    </tns:GetFolders1>
  </soap:Body>
</soap:Envelope>

Notes¶

Returns only direct subfolders (one level deep), not recursive.
No limit on the number of returned folders. For large folder trees, consider using GetFolders2 which applies the configured display count limit.
Use GetFolders if you need full properties (rules, property sets, security, owner).

GetFolders - Get subfolders with full properties
GetFolders2 - Get subfolders with UI display count limit applied
GetFoldersByPage - Get paged subfolders with filter
GetFoldersAndDocuments - Get both folders and documents

Error Codes¶

Error	Description
`[900] Authentication failed`	Invalid or missing authentication ticket.
`[901] Session expired or Invalid ticket`	The ticket has expired or does not exist.
Folder not found	The specified path does not resolve to an existing folder.
Access denied	The user does not have read permission on the folder.
`SystemError:...`	An unexpected server-side error occurred.

For detailed documentation visit: https://support.inforouter.com/api-docs/GetFolders1