# getArtifactsV2
Retrieves artifacts with enhanced filtering and pagination support using conditional filters.
### Examples
{% tabs %}
{% tab title="GraphQL" %}
```graphql
query GetArtifactsV2($input: GetArtifactsV2Input) {
getArtifactsV2(input: $input) {
artifacts {
vulnDepIssues
vulnDepBaseIssues
vulnDepInstructionIssues
secretIssues
sbomIssues
counts {
vulnDepIssues
vulnDepBaseIssues
vulnDepInstructionIssues
vulnDepPublicImageIssues
}
id
appDescription {
appName
appType
appId
businessPriority
}
artifactInfo {
type
name
version
hash
artifactIntegrity
registry
visibility
firstSeenDate
runtime
runtimeLastSeenDate
cloudDeployed
biVisibility
biName
biVersion
osName
osVersion
}
categories {
catId
severities {
info
low
medium
high
critical
appox
}
name
score
}
artifactCategories {
catId
severities {
info
low
medium
high
critical
appox
}
name
score
}
registryDescription {
type
name
project
link
hash
tags
username
userType
uploadTime
lastUpdate
buildTime
}
cloudData {
cloudIdentifier
link
lastExecutionTime
lastModifiedTime
account
zone
cluster
cloudDescription {
type
subType
cloudEntityAttributes {
... on ECS {
os
cpu
memory
containers
registeredAt
registeredBy
account
zone
}
}
}
}
totalIssuesBySeverity {
info
low
medium
high
critical
appox
}
packages {
appId
appName
repoName
link
type
}
issueSeverityBreakdown {
name
tab
severities {
info
low
medium
high
critical
appox
}
}
artifactContext {
name
icon
items {
name
trend
}
}
scaSeveritySummary {
info
low
medium
high
critical
appox
}
}
offset
total
totalFilteredArtifacts
}
}
```
**Variables**
This is an example input showing all available input fields. Only fields marked as required in the schema are mandatory.
```json
{
"input": {
"scanId": "c9da693d-8906-4a32-93c9-2ffdb1cebb99",
"conditionalFilters": [
{
"condition": "AND",
"fieldName": "digest",
"values": ["example"],
"greaterThan": 13.37,
"lessThan": 13.37
}
],
"search": "example",
"limit": 100,
"offset": 0,
"sort": {
"field": ["AppName"],
"order": ["ASC"]
},
"owners": ["example"],
"tagIds": ["example"]
}
}
```
{% endtab %}
{% tab title="cURL" %}
```shell
curl -X POST \
https://api.cloud.ox.security/api/apollo-gateway \
-H 'Content-Type: application/json' \
-H 'Authorization: YOUR_API_TOKEN' \
-d '{
"query": "query GetArtifactsV2($input: GetArtifactsV2Input) { getArtifactsV2(input: $input) { artifacts { vulnDepIssues vulnDepBaseIssues vulnDepInstructionIssues secretIssues sbomIssues counts { vulnDepIssues vulnDepBaseIssues vulnDepInstructionIssues vulnDepPublicImageIssues } id appDescription { appName appType appId businessPriority } artifactInfo { type name version hash artifactIntegrity registry visibility firstSeenDate runtime runtimeLastSeenDate cloudDeployed biVisibility biName biVersion osName osVersion } categories { catId severities { info low medium high critical appox } name score } artifactCategories { catId severities { info low medium high critical appox } name score } registryDescription { type name project link hash tags username userType uploadTime lastUpdate buildTime } cloudData { cloudIdentifier link lastExecutionTime lastModifiedTime account zone cluster cloudDescription { type subType cloudEntityAttributes { ... on ECS { os cpu memory containers registeredAt registeredBy account zone } } } } totalIssuesBySeverity { info low medium high critical appox } packages { appId appName repoName link type } issueSeverityBreakdown { name tab severities { info low medium high critical appox } } artifactContext { name icon items { name trend } } scaSeveritySummary { info low medium high critical appox } } offset total totalFilteredArtifacts } }",
"variables": {
"input": {
"scanId": "c9da693d-8906-4a32-93c9-2ffdb1cebb99",
"conditionalFilters": [
{
"condition": "AND",
"fieldName": "digest",
"values": ["example"],
"greaterThan": 13.37,
"lessThan": 13.37
}
],
"search": "example",
"limit": 100,
"offset": 0,
"sort": {
"field": ["AppName"],
"order": ["ASC"]
},
"owners": ["example"],
"tagIds": ["example"]
}
}
}'
```
{% endtab %}
{% tab title="Node.js" %}
```javascript
const query = 'query GetArtifactsV2($input: GetArtifactsV2Input) { getArtifactsV2(input: $input) { artifacts { vulnDepIssues vulnDepBaseIssues vulnDepInstructionIssues secretIssues sbomIssues counts { vulnDepIssues vulnDepBaseIssues vulnDepInstructionIssues vulnDepPublicImageIssues } id appDescription { appName appType appId businessPriority } artifactInfo { type name version hash artifactIntegrity registry visibility firstSeenDate runtime runtimeLastSeenDate cloudDeployed biVisibility biName biVersion osName osVersion } categories { catId severities { info low medium high critical appox } name score } artifactCategories { catId severities { info low medium high critical appox } name score } registryDescription { type name project link hash tags username userType uploadTime lastUpdate buildTime } cloudData { cloudIdentifier link lastExecutionTime lastModifiedTime account zone cluster cloudDescription { type subType cloudEntityAttributes { ... on ECS { os cpu memory containers registeredAt registeredBy account zone } } } } totalIssuesBySeverity { info low medium high critical appox } packages { appId appName repoName link type } issueSeverityBreakdown { name tab severities { info low medium high critical appox } } artifactContext { name icon items { name trend } } scaSeveritySummary { info low medium high critical appox } } offset total totalFilteredArtifacts } }';
fetch("https://api.cloud.ox.security/api/apollo-gateway", {
method: "POST",
headers: {
"Content-Type": "application/json",
"Authorization": "YOUR_API_TOKEN"
},
body: JSON.stringify({
query: query,
// This is an example input showing all available input fields. Only fields marked as required in the schema are mandatory.
variables: {
input: {
scanId: "c9da693d-8906-4a32-93c9-2ffdb1cebb99",
conditionalFilters: [
{
condition: "AND",
fieldName: "digest",
values: ["example"],
greaterThan: 13.37,
lessThan: 13.37
}
],
search: "example",
limit: 100,
offset: 0,
sort: {
field: ["AppName"],
order: ["ASC"]
},
owners: ["example"],
tagIds: ["example"]
}
}
})
})
.then(response => response.json())
.then(result => console.log(JSON.stringify(result, null, 2)))
.catch(error => console.error('Error:', error));
```
{% endtab %}
{% tab title="Python" %}
```python
import requests
query = 'query GetArtifactsV2($input: GetArtifactsV2Input) { getArtifactsV2(input: $input) { artifacts { vulnDepIssues vulnDepBaseIssues vulnDepInstructionIssues secretIssues sbomIssues counts { vulnDepIssues vulnDepBaseIssues vulnDepInstructionIssues vulnDepPublicImageIssues } id appDescription { appName appType appId businessPriority } artifactInfo { type name version hash artifactIntegrity registry visibility firstSeenDate runtime runtimeLastSeenDate cloudDeployed biVisibility biName biVersion osName osVersion } categories { catId severities { info low medium high critical appox } name score } artifactCategories { catId severities { info low medium high critical appox } name score } registryDescription { type name project link hash tags username userType uploadTime lastUpdate buildTime } cloudData { cloudIdentifier link lastExecutionTime lastModifiedTime account zone cluster cloudDescription { type subType cloudEntityAttributes { ... on ECS { os cpu memory containers registeredAt registeredBy account zone } } } } totalIssuesBySeverity { info low medium high critical appox } packages { appId appName repoName link type } issueSeverityBreakdown { name tab severities { info low medium high critical appox } } artifactContext { name icon items { name trend } } scaSeveritySummary { info low medium high critical appox } } offset total totalFilteredArtifacts } }'
response = requests.post(
"https://api.cloud.ox.security/api/apollo-gateway",
headers={
"Content-Type": "application/json",
"Authorization": "YOUR_API_TOKEN"
},
json={
"query": query,
# This is an example input showing all available input fields. Only fields marked as required in the schema are mandatory.
"variables": {
"input": {
"scanId": "c9da693d-8906-4a32-93c9-2ffdb1cebb99",
"conditionalFilters": [
{
"condition": "AND",
"fieldName": "digest",
"values": ["example"],
"greaterThan": 13.37,
"lessThan": 13.37
}
],
"search": "example",
"limit": 100,
"offset": 0,
"sort": {
"field": ["AppName"],
"order": ["ASC"]
},
"owners": ["example"],
"tagIds": ["example"]
}
}
}
)
if response.status_code == 200:
result = response.json()
print(result)
else:
print(f"Error: {response.status_code}")
print(response.text)
```
{% endtab %}
{% endtabs %}
### Arguments
You can use the following argument(s) to customize your `getArtifactsV2` query.
| Argument | Description | Supported fields |
| ------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| input [`GetArtifactsV2Input`](/api-documentation/api-reference/api--artifact/types/inputs/get-artifacts-v2input.md) | Input parameters for filtering, sorting, and pagination | scanId String
conditionalFilters \[ConditionalFilters]
search String
limit Int
offset Int
sort ArtifactsSort
owners \[String]
tagIds \[String]
|
### Fields
Return type: [`ArtifactsResponse`](/api-documentation/api-reference/api--artifact/types/objects/artifacts-response.md)
You can use the following field(s) to specify what information your `getArtifactsV2` query will return. Please note that some fields may have their own subfields.
| Field | Description | Supported fields |
| ----------------------------------------------------------------------------------------------------------- | ------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| artifacts [`[ArtifactInfo]`](/api-documentation/api-reference/api--artifact/types/objects/artifact-info.md) | List of artifact information items | vulnDepIssues \[String]
vulnDepBaseIssues \[String]
vulnDepInstructionIssues \[String]
secretIssues \[String]
sbomIssues \[String]
counts IssueCounts
id String
appDescription ArtifactApplication
artifactInfo IArtifactInfo
categories \[ArtifactCategories]
artifactCategories \[ArtifactCategories]
registryDescription \[ArtifactRegistryDescription]
cloudData \[CloudArtifactData]
totalIssuesBySeverity Severities
packages \[ArtifactPackage]
issueSeverityBreakdown \[IssueSeverityBreakdown]
artifactContext \[ArtifactContextCategory]
scaSeveritySummary Severities
|
| offset `Int` | Pagination offset value for virtualization | |
| total `Int` | Total number of artifacts available | |
| totalFilteredArtifacts `Int` | Total number of artifacts after applying filters | |
---
# Agent Instructions: Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://docs.ox.security/api-documentation/api-reference/api--artifact/queries/get-artifacts-v2.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.