Skip to main content
GET
/
v1
/
namespaces
/
{tenant_meta.namespace}
/
malware
/
{uuid}
GetMalware
curl --request GET \
  --url https://api.endorlabs.com/v1/namespaces/{tenant_meta.namespace}/malware/{uuid}
{
  "meta": {
    "name": "<string>",
    "annotations": {},
    "create_time": "2023-11-07T05:31:56Z",
    "created_by": "<string>",
    "description": "<string>",
    "index_data": {
      "data": [
        "<string>"
      ],
      "search_score": 123,
      "tenant": "<string>",
      "will_be_deleted_at": "2023-11-07T05:31:56Z"
    },
    "kind": "<string>",
    "parent_kind": "<string>",
    "parent_uuid": "<string>",
    "references": {},
    "tags": [
      "<string>"
    ],
    "update_time": "2023-11-07T05:31:56Z",
    "updated_by": "<string>",
    "upsert_time": "2023-11-07T05:31:56Z",
    "version": "<string>"
  },
  "spec": {
    "ecosystem": "ECOSYSTEM_UNSPECIFIED",
    "package_name": "<string>",
    "additional_notes": [
      "<string>"
    ],
    "advisory_last_updated": "2023-11-07T05:31:56Z",
    "advisory_published": "2023-11-07T05:31:56Z",
    "aliases": [
      "<string>"
    ],
    "contested": true,
    "contested_date": "2023-11-07T05:31:56Z",
    "contested_reason": "<string>",
    "contributing_feeds": [
      "MALWARE_SOURCE_UNSPECIFIED"
    ],
    "cwe_id": "<string>",
    "malware_detected_on": "2023-11-07T05:31:56Z",
    "package_version": {
      "context": {
        "id": "<string>",
        "type": "CONTEXT_TYPE_UNSPECIFIED",
        "tags": [
          "<string>"
        ],
        "will_be_deleted_at": "2023-11-07T05:31:56Z"
      },
      "meta": {
        "name": "<string>",
        "annotations": {},
        "create_time": "2023-11-07T05:31:56Z",
        "created_by": "<string>",
        "description": "<string>",
        "index_data": {
          "data": [
            "<string>"
          ],
          "search_score": 123,
          "tenant": "<string>",
          "will_be_deleted_at": "2023-11-07T05:31:56Z"
        },
        "kind": "<string>",
        "parent_kind": "<string>",
        "parent_uuid": "<string>",
        "references": {},
        "tags": [
          "<string>"
        ],
        "update_time": "2023-11-07T05:31:56Z",
        "updated_by": "<string>",
        "upsert_time": "2023-11-07T05:31:56Z",
        "version": "<string>"
      },
      "spec": {
        "project_uuid": "<string>",
        "bazel_metadata": {
          "build_path": "<string>"
        },
        "call_graph_available": true,
        "code_owners": {
          "labels": [
            "<string>"
          ],
          "owners": [
            "<string>"
          ]
        },
        "container_metadata": {
          "architecture": "CONTAINER_ARCHITECTURE_UNSPECIFIED",
          "base_image": {
            "chain_id": "<string>",
            "digest": "<string>",
            "name": "<string>"
          },
          "chain_id": "<string>",
          "command": [
            "<string>"
          ],
          "digest": "<string>",
          "distribution": "<string>",
          "entrypoint": [
            "<string>"
          ],
          "environment": [
            "<string>"
          ],
          "exposed_ports": [
            "<string>"
          ],
          "labels": {},
          "layers": [
            {
              "digest": "<string>",
              "base_layer": true,
              "command": "<string>"
            }
          ],
          "profile_details": {
            "application_type": "APPLICATION_TYPE_UNSPECIFIED",
            "detected_as_base_image": true,
            "duration_ms": "<string>",
            "entry_point_package_version_name": "<string>",
            "profile_type": "PROFILE_TYPE_UNSPECIFIED"
          },
          "profile_error": {
            "description": "<string>",
            "status": "CONTAINER_PROFILE_STATUS_UNSPECIFIED"
          },
          "profiled": true,
          "repo_digest": "<string>",
          "used_as_base": {
            "first_seen": "2023-11-07T05:31:56Z",
            "last_seen": "2023-11-07T05:31:56Z",
            "update_options": {
              "latest_version": {
                "chain_id": "<string>",
                "digest": "<string>",
                "name": "<string>"
              },
              "next_version": {
                "chain_id": "<string>",
                "digest": "<string>",
                "name": "<string>"
              },
              "refreshed": {
                "chain_id": "<string>",
                "digest": "<string>",
                "name": "<string>"
              },
              "update_time": "2023-11-07T05:31:56Z"
            },
            "use_count": "<string>",
            "used": true
          },
          "version": "<string>",
          "working_directory": "<string>"
        },
        "ecosystem": "ECOSYSTEM_UNSPECIFIED",
        "internal_reference_key": "<string>",
        "language": "LANGUAGE_UNSPECIFIED",
        "package_name": "<string>",
        "precomputed_call_graph_state": "PRECOMPUTED_STATE_UNSPECIFIED",
        "relative_path": "<string>",
        "release_timestamp": "2023-11-07T05:31:56Z",
        "resolution_errors": {
          "call_graph": {
            "description": "<string>",
            "error_analysis": [
              {
                "error_category": "ERROR_CATEGORY_UNSPECIFIED",
                "explanation": "<string>",
                "fixable": true,
                "fixable_notes": "<string>",
                "matching_rule": "<string>",
                "matching_snippet": "<string>"
              }
            ],
            "error_analysis_best_match": {
              "error_category": "ERROR_CATEGORY_UNSPECIFIED",
              "explanation": "<string>",
              "fixable": true,
              "fixable_notes": "<string>",
              "matching_rule": "<string>",
              "matching_snippet": "<string>"
            },
            "operation": "<string>",
            "status_error": "STATUS_ERROR_UNSPECIFIED",
            "target": "<string>",
            "target_files": {}
          },
          "resolved": {
            "description": "<string>",
            "error_analysis": [
              {
                "error_category": "ERROR_CATEGORY_UNSPECIFIED",
                "explanation": "<string>",
                "fixable": true,
                "fixable_notes": "<string>",
                "matching_rule": "<string>",
                "matching_snippet": "<string>"
              }
            ],
            "error_analysis_best_match": {
              "error_category": "ERROR_CATEGORY_UNSPECIFIED",
              "explanation": "<string>",
              "fixable": true,
              "fixable_notes": "<string>",
              "matching_rule": "<string>",
              "matching_snippet": "<string>"
            },
            "operation": "<string>",
            "status_error": "STATUS_ERROR_UNSPECIFIED",
            "target": "<string>",
            "target_files": {}
          },
          "unresolved": {
            "description": "<string>",
            "error_analysis": [
              {
                "error_category": "ERROR_CATEGORY_UNSPECIFIED",
                "explanation": "<string>",
                "fixable": true,
                "fixable_notes": "<string>",
                "matching_rule": "<string>",
                "matching_snippet": "<string>"
              }
            ],
            "error_analysis_best_match": {
              "error_category": "ERROR_CATEGORY_UNSPECIFIED",
              "explanation": "<string>",
              "fixable": true,
              "fixable_notes": "<string>",
              "matching_rule": "<string>",
              "matching_snippet": "<string>"
            },
            "operation": "<string>",
            "status_error": "STATUS_ERROR_UNSPECIFIED",
            "target": "<string>",
            "target_files": {}
          }
        },
        "resolved_dependencies": {
          "resolution_timestamp": "2023-11-07T05:31:56Z",
          "dependencies": [
            {
              "name": "<string>",
              "abstract": true,
              "cocoapod_dependency_scope": "DEPENDENCY_SCOPE_UNSPECIFIED",
              "composition_metadata": {
                "package_type": "CONTAINER_PACKAGE_TYPE_UNSPECIFIED"
              },
              "container_layers": [
                {
                  "digest": "<string>",
                  "file_locations": [
                    "<string>"
                  ]
                }
              ],
              "dependency_scope": "DEPENDENCY_SCOPE_UNSPECIFIED",
              "eol_timestamp": "2023-11-07T05:31:56Z",
              "file_locations": [
                "<string>"
              ],
              "gem_dependency_scope": "SCOPE_UNSPECIFIED",
              "github_action_kind": "SCOPE_UNSPECIFIED",
              "golang_dependency_scope": "SCOPE_UNSPECIFIED",
              "hugging_face_dependency_scope": "DEPENDENCY_SCOPE_UNSPECIFIED",
              "imported_type": "IMPORTED_TYPE_UNSPECIFIED",
              "js_dependency_scope": "SCOPE_UNSPECIFIED",
              "maven_dependency_scope": "SCOPE_UNSPECIFIED",
              "nuget_dependency_scope": "DEPENDENCY_SCOPE_UNSPECIFIED",
              "packagist_dependency_scope": "SCOPE_UNSPECIFIED",
              "patched": true,
              "pinned": true,
              "platform_source": "PLATFORM_SOURCE_UNSPECIFIED",
              "public": true,
              "purl": "<string>",
              "pypi_dependency_scope": "SCOPE_UNSPECIFIED",
              "release_date": "2023-11-07T05:31:56Z",
              "runtime_files": [
                {
                  "digests": [
                    {
                      "algorithm": "DIGEST_TYPE_UNSPECIFIED",
                      "value": "<string>"
                    }
                  ],
                  "file_type": "FILE_TYPE_UNSPECIFIED",
                  "path": "<string>",
                  "real_path": "<string>"
                }
              ],
              "rust_dependency_kind": "DEPENDENCY_KIND_UNSPECIFIED",
              "source_repository_http_clone_url": "<string>",
              "source_repository_ref": "<string>",
              "swift_dependency_scope": "DEPENDENCY_SCOPE_UNSPECIFIED",
              "targets": [
                {
                  "exclude": true,
                  "name": "<string>",
                  "type": "TARGET_TYPE_UNSPECIFIED",
                  "version": "<string>"
                }
              ],
              "user_app_dep": true,
              "vendored": true
            }
          ],
          "dependency_files": [
            {
              "path": "<string>"
            }
          ],
          "dependency_graph": {}
        },
        "source_code_reference": {
          "http_clone_url": "<string>",
          "platform_source": "PLATFORM_SOURCE_UNSPECIFIED",
          "version": {
            "ref": "<string>",
            "metadata": {},
            "sha": "<string>"
          }
        },
        "unresolved_dependencies": [
          {
            "c": {
              "name": "<string>",
              "scope": "DEPENDENCY_SCOPE_UNSPECIFIED",
              "targets": [
                {
                  "exclude": true,
                  "name": "<string>",
                  "type": "TARGET_TYPE_UNSPECIFIED",
                  "version": "<string>"
                }
              ],
              "version_constraints": "<string>"
            },
            "cargo": {
              "kind": "DEPENDENCY_KIND_UNSPECIFIED",
              "name": "<string>",
              "optional": true,
              "uses_default_features": true,
              "version_constraints": "<string>",
              "cfg": {
                "expr": {
                  "all": {
                    "expr": "<array>"
                  },
                  "any": {
                    "expr": "<array>"
                  },
                  "not": {
                    "expr": "<unknown>"
                  },
                  "value": {
                    "name": "<string>",
                    "pair": {
                      "key": "<string>",
                      "value": "<string>"
                    }
                  }
                }
              },
              "features": [
                "<string>"
              ],
              "named": {
                "name": "<string>"
              },
              "path": "<string>",
              "registry": "<string>",
              "rename": "<string>",
              "req": [
                {
                  "major": "<string>",
                  "op": "OP_UNSPECIFIED",
                  "minor": "<string>",
                  "patch": "<string>",
                  "pre": "<string>"
                }
              ],
              "source": "<string>",
              "targets": [
                {
                  "exclude": true,
                  "name": "<string>",
                  "type": "TARGET_TYPE_UNSPECIFIED",
                  "version": "<string>"
                }
              ]
            },
            "cocoapod": {
              "name": "<string>",
              "scope": "DEPENDENCY_SCOPE_UNSPECIFIED",
              "targets": [
                {
                  "exclude": true,
                  "name": "<string>",
                  "type": "TARGET_TYPE_UNSPECIFIED",
                  "version": "<string>"
                }
              ],
              "version_constraints": "<string>"
            },
            "gem": {
              "name": "<string>",
              "version_constraints": "<string>",
              "scope_type": "SCOPE_UNSPECIFIED",
              "targets": [
                {
                  "exclude": true,
                  "name": "<string>",
                  "type": "TARGET_TYPE_UNSPECIFIED",
                  "version": "<string>"
                }
              ]
            },
            "githubaction": {
              "name": "<string>",
              "action_type": "GH_ACTION_TYPE_UNSPECIFIED",
              "scope": "SCOPE_UNSPECIFIED",
              "version": "<string>"
            },
            "go": {
              "package": "<string>",
              "ref": "<string>",
              "scope_type": "SCOPE_UNSPECIFIED",
              "targets": [
                {
                  "exclude": true,
                  "name": "<string>",
                  "type": "TARGET_TYPE_UNSPECIFIED",
                  "version": "<string>"
                }
              ]
            },
            "hugging_face": {
              "name": "<string>",
              "version": "<string>"
            },
            "maven": {
              "artifact_id": "<string>",
              "group_id": "<string>",
              "version_constraints": "<string>",
              "classifier": "<string>",
              "exclusions": "<string>",
              "optional": true,
              "scope": "<string>",
              "scope_type": "SCOPE_UNSPECIFIED",
              "targets": [
                {
                  "exclude": true,
                  "name": "<string>",
                  "type": "TARGET_TYPE_UNSPECIFIED",
                  "version": "<string>"
                }
              ],
              "type": "<string>"
            },
            "npm": {
              "name": "<string>",
              "scope": "SCOPE_UNSPECIFIED",
              "targets": [
                {
                  "exclude": true,
                  "name": "<string>",
                  "type": "TARGET_TYPE_UNSPECIFIED",
                  "version": "<string>"
                }
              ],
              "version": "<string>",
              "version_constraint": "<string>"
            },
            "nuget": {
              "name": "<string>",
              "scope": "DEPENDENCY_SCOPE_UNSPECIFIED",
              "targets": [
                {
                  "exclude": true,
                  "name": "<string>",
                  "type": "TARGET_TYPE_UNSPECIFIED",
                  "version": "<string>"
                }
              ],
              "version_constraints": "<string>"
            },
            "packagist": {
              "name": "<string>",
              "version_constraints": "<string>",
              "scope_type": "SCOPE_UNSPECIFIED",
              "targets": [
                {
                  "exclude": true,
                  "name": "<string>",
                  "type": "TARGET_TYPE_UNSPECIFIED",
                  "version": "<string>"
                }
              ]
            },
            "pypi": {
              "name": "<string>",
              "version_constraints": "<string>",
              "package_manager_type": "PACKAGE_MANAGER_TYPE_UNSPECIFIED",
              "scope_type": "SCOPE_UNSPECIFIED",
              "targets": [
                {
                  "exclude": true,
                  "name": "<string>",
                  "type": "TARGET_TYPE_UNSPECIFIED",
                  "version": "<string>"
                }
              ]
            },
            "swift": {
              "branch": "<string>",
              "exact": "<string>",
              "name": "<string>",
              "range": {
                "lower_bound": "<string>",
                "upper_bound": "<string>"
              },
              "revision": "<string>",
              "scope": "DEPENDENCY_SCOPE_UNSPECIFIED",
              "targets": [
                {
                  "exclude": true,
                  "name": "<string>",
                  "type": "TARGET_TYPE_UNSPECIFIED",
                  "version": "<string>"
                }
              ]
            }
          }
        ]
      },
      "processing_status": {
        "analytic_time": "2023-11-07T05:31:56Z",
        "disable_automated_scan": true,
        "metadata": {
          "full_history_scan_time": "2023-11-07T05:31:56Z"
        },
        "queue_time": "2023-11-07T05:31:56Z",
        "scan_state": "SCAN_STATE_UNSPECIFIED",
        "scan_time": "2023-11-07T05:31:56Z"
      },
      "tenant_meta": {
        "namespace": "<string>"
      },
      "uuid": "<string>"
    },
    "pkg_release_date": "2023-11-07T05:31:56Z",
    "purl": "<string>",
    "ranges": {
      "ranges": [
        {
          "fixed": "<string>",
          "introduced": "<string>",
          "osv_id": "<string>",
          "repo": "<string>",
          "type": "MALWARE_RANGE_TYPE_UNSPECIFIED"
        }
      ]
    },
    "reasons": [
      "<string>"
    ],
    "references": [
      {
        "type": "REFERENCE_TYPE_UNSPECIFIED",
        "url": "<string>"
      }
    ],
    "source": "MALWARE_SOURCE_UNSPECIFIED",
    "status": "<string>",
    "summary": "<string>",
    "upsert_key": "<string>",
    "version": {
      "osv_id": "<string>",
      "version": "<string>"
    }
  },
  "tenant_meta": {
    "namespace": "<string>"
  },
  "uuid": "<string>"
}

Path Parameters

tenant_meta.namespace
string
required

Namespaces are a way to organize organizational units into virtual groupings of resources. Namespaces must be a fully qualified name, for example, the child namespace of namespace "endor.prod" called "app" is called "endor.prod.app".

uuid
string
required

The UUID of the requested resource.

Query Parameters

get_parameters.mask
string

List of fields to return (all fields are returned by default).

Response

A successful response.

meta
object
required

Common fields for all Endor Labs resources.

spec
object
required
tenant_meta
object

Tenant related data for the tenant containing the resource.

uuid
string

The UUID of a malware record.