--- title: "Use the Lasernet Archive REST API" slug: "use-the-lasernet-archive-rest-api" description: "Describes how to construct Archive REST API URLs and how to locate documentation." tags: ["Lasernet Archive", "REST API"] updated: 2026-11-20T11:47:43Z published: 2026-11-20T11:47:43Z canonical: "kb.lasernetgroup.com/use-the-lasernet-archive-rest-api" --- > ## Documentation Index > Fetch the complete documentation index at: https://kb.lasernetgroup.com/llms.txt > Use this file to discover all available pages before exploring further. # Use the Lasernet Archive REST API Lasernet Archive provides a comprehensive REST-based API. This API enables third-party applications and API clients to programmatically utilize the full range of Archive functionality (over HTTP or HTTPS). This capability is particularly valuable to system integrators and bespoke application builders, but can also be useful for performing ad-hoc operations. The API consists of a set of “resources”, which are each focused around a particular area of the application. These resources enable you to use the API to interact with the system and get data in and out of it. For example, you can use the `/documents` resource to create and edit documents in the archive, or use the `/searches` resource to run searches. > [!NOTE] > Note > > In general, document access is restricted by configuring user accounts and groups and granting them access to searches. However, technically, internal users can also use the Archive REST API to view, update, and download any document, regardless of these restrictions. When [Document Sharing](/v1/docs/search-the-archive#share-documents-with-external-users) is enabled, they can also share any document they have access to with external users. To limit internal users’ access to only those documents returned by the searches they have been explicitly granted access to, enable Document Access Control in the [Lasernet Archive server settings](/v1/docs/lasernet-keep-server-settings#security-settings). To use a REST API endpoint, construct a URL that incorporates your Archive system's base URL and the API endpoint that you want to use. The Archive REST API is installed alongside the Archive server software. Documentation for each API resource and endpoint is provided as part of an interactive interface to the API. ## Construct REST API URLs To construct REST API request URLs, append the endpoint that you want to use to `<base-URL>/rest/v1`. Substitute `<base-URL>` for the base URL of the Archive installation. For example, if you want to retrieve data about a document definition named “invoice”, you can use the `/document-defs/{name}` (GET) endpoint. If the Archive installation's base URL is `https://Archiveserver`, the complete URL for this example request is `https://Archiveserver/rest/v1/document-defs/invoice`. > [!NOTE] > Note > > To make a REST API request, a client must successfully authenticate. For more information, see [REST API Authentication](/v1/docs/rest-api-authentication-1). ## Documentation The Archive REST API is accompanied by a web page that provides general and endpoint-specific documentation. The page is also an interactive interface that you can use to make REST API requests. Each endpoint has a **Try it out** button. ![Lasernet Archive REST API documentation page](https://cdn.document360.io/c831ef63-c6b3-48ee-b443-3e33644e4e2e/Images/Documentation/REST API documentation.png) ### General Documentation The **REST API Documentation** area at the top of the page describes several important aspects of the REST API (such as authentication methods and error codes) and provides other essential information. ### Resource and Endpoint Documentation The resource-specific sections further down the page (such as **document-defs** and **key-defs**) provide documentation for individual API endpoints and their methods. For example, the **document-defs** section includes documentation for the `/document-defs/{name}` (GET) and `/document-defs/{name}` (PUT) endpoints. To access the documentation and interactive interface page, use one of the following methods. #### Use the Link in the Lasernet Archive Account Info Pane 1. Log in to the Archive web application, then click **Account** in the toolbar (see 1 in the image below). ![The position of the Account button and the View REST API documentation button in Lasernet Archive.](https://cdn.document360.io/c831ef63-c6b3-48ee-b443-3e33644e4e2e/Images/Documentation/account information.png) 2. In the **Account Info** pane, click **View REST API documentation** (2). #### Go Directly to the Documentation Page URL Go to `<base-URL>/rest/v1`. Substitute `<base-URL>` for the base URL of the Archive system. For example, if the Archive installation's base URL is `https://Archiveserver`, go to `https://Archiveserver/rest/v1`. ## Asynchronous System Operations Archive can asynchronously process some types of administrative REST API request. For more information, see [Asynchronous Processing of Lasernet Archive System Operations](/v1/docs/asynchronous-processing-of-keep-system-operations).