Box Developer Documentation
Log in
 

    Find Item from Shared Link

    Guides Shared Links Find Item from Shared Link
    Edit this page

    Find Item from Shared Link

    The find item for shared link API is designed to accept a shared link as an input using a BoxApi header and return the file or folder object that the shared link is set for.

    To get the file or folder object associated with a shared link, supply the full shared link URL in the request.

    cURLTypeScript GenPython Gen.NET GenSwift Gen (Beta)Java Gen (Beta)JavaPythonNodeiOS
    cURL
    curl -i -X GET "https://api.box.com/2.0/shared_items" \
     -H "authorization: Bearer <ACCESS_TOKEN>" \
     -H "boxapi: shared_link=https://app.box.com/s/gjasdasjhasd&shared_link_password=letmein"
    TypeScript Gen
    Python Gen
    .NET Gen
    Swift Gen (Beta)
    Java Gen (Beta)
    Java
    Python
    Node
    iOS

    Please note that when the shared link is for a folder, the response of this API does not include the list of nested items within that folder.

    To further traverse the items in the folder, use the same BoxApi header to get a nested folder's information, list the items in those folders, get a nested file's information, or download a file