Get Information about a known share¶
To get information about a share when the share ID is known, use the following.
Note: the share ID can be obtained from the output of any of the previous Share API calls or the creation of a new share.
| Syntax | <Base URL>/<share id> |
| Method | GET |
| Arguments | Share id (int) |
| Result | XML code with share information |
The following is a list of returned status codes:
| HTTP Status Code | Description |
| 100 | Successful |
| 404 | Share doesn’t exist |
Poster¶
This example shows the output of share information for share ID “7”
| Field | Value |
| URL | Base URL for the API of the ownCloud server/<share id> |
| User Auth | User ID of the file owner |
| Password | User’s Password |

Curl¶
$ curl http://<user>:<passowrd>@<ip>/ocs/v1.php/apps/files_sharing/api/v1/shares/<share_id>
Output¶
| <?xml version=”1.0”?> | |
| <ocs> | |
| <meta> | |
| <status>ok</status> | Status=100: successful |
| <statuscode>100</statuscode> | |
| <message/> | |
| </meta> | |
| <data> | |
| <element> | |
| <id>7</id> | Share ID = 7 |
| <item_type>file</item_type> | |
| <item_source>675</item_source> | |
| <parent/> | |
| <share_type>0</share_type> | Share type = 0: user |
| <share_with>ser72</share_with> | Share with user ser72 |
| <file_source>675</file_source> | |
| <path>/test share api/ieee.txt</path> | |
| <permissions>27</permissions> | |
| <stime>1386698116</stime> | |
| <expiration/> | |
| <token/> | |
| <storage>4</storage> | |
| <mail_send>0</mail_send> | |
| <share_with_displayname>ser72</share_with_displayname> | |
| </element> | |
| </data> | |
| </ocs> |