API Documentation

tip

The Spectra Analyze API documentation is now also available as an Open API specification, accessible from the Help > API Docs item from the main menu. Authorizing the API docs using a valid appliance token makes it possible to send API requests directly from there.

The Spectra Analyze appliance provides a number of REST APIs that allow seamless integration with automated workflows.

In order to send requests and interact with the APIs, users need to authenticate to the appliance with their API tokens.

A prerequisite for receiving an API token is an existing, active user account on the appliance. Prior to using any of the APIs, users should request a token as described in the following section.

For additional workflows, such as scanning entire [directories](https://github.com/reversinglabs/reversinglabs-sdk-cookbook/blob/main/Scenarios and Workflows/directory_scanning.ipynb), see our SDK documentation and its cookbook.

📄️ How to Obtain a Token for API Authentication

Authentication tokens are mandatory for all interactions with the Spectra Analyze appliance APIs.

📄️ Licensing API

Generate a machine ID, upload a license file, check the license status.

📄️ Submissions API

Submit samples or URLs for analysis.

📄️ Processing Status API

Check the processing status of submitted files or URLs.

📄️ Download API

Download samples from the appliance to local storage.

📄️ Reanalyze Local Samples API V1

Reanalyze one or more samples with selected services (V1).

📄️ Reanalyze Local Samples API V2

Reanalyze one or more samples with selected services (V2).

📄️ Delete API

Delete one or more samples from the appliance.

📄️ Tags API

Create, delete or retrieve user tags for any sample on the appliance.

📄️ Extracted Files API

List and download files extracted from a local sample.

📄️ PDF Report API

Download a PDF report of the analysis results for any sample on the appliance.

📄️ Report Summary API

Retrieve a summary of the analysis report for local samples.

📄️ Full Report API

Retrieve a detailed analysis report for local samples.

📄️ Static Analysis Report API

Retrieve the Spectra Core (static) analysis results for a local sample.

📄️ Dynamic Analysis Report API

Create and download PDF or HTML reports for samples that have gone through dynamic analysis.

📄️ Classification Status API

Get classification results for a local sample.

📄️ Set Classification API

Override the classification of a sample, either locally or in the Spectra Intelligence cloud.

📄️ YARA API

Retrieve YARA ruleset lists or their contents, create new rulesets, delete or update existing rulesets.

📄️ YARA Retro API

Allows users to initiate or stop a local retro scan, manage cloud retro scans and check the YARA retro status on the appliance.

📄️ Advanced Search API

Search for samples available on the local Spectra Analyze instance and Spectra Intelligence using the Advanced Search capabilities.

📄️ Network Threat Intelligence API

Retrieve information about a URL, domain, or IP address

📄️ Containers API

Get a list of all top-level containers from which the requested sample has been extracted during analysis.

📄️ Redundant Status API

Check if the Spectra Analyze instance is a primary in the redundant cluster.

📄️ Deprecated Endpoints

Deprecated Spectra Analyze endpoints