Get resource by ID - Vanta Developer Hub

GET

/

integrations

/

{integrationId}

/

resource-kinds

/

{resourceKind}

/

resources

/

{resourceId}

Get resource by ID

curl --request GET \
  --url https://api.vanta.com/v1/integrations/{integrationId}/resource-kinds/{resourceKind}/resources/{resourceId} \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://api.vanta.com/v1/integrations/{integrationId}/resource-kinds/{resourceKind}/resources/{resourceId}"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.vanta.com/v1/integrations/{integrationId}/resource-kinds/{resourceKind}/resources/{resourceId}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.vanta.com/v1/integrations/{integrationId}/resource-kinds/{resourceKind}/resources/{resourceId}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.vanta.com/v1/integrations/{integrationId}/resource-kinds/{resourceKind}/resources/{resourceId}"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.get("https://api.vanta.com/v1/integrations/{integrationId}/resource-kinds/{resourceKind}/resources/{resourceId}")
  .header("Authorization", "Bearer <token>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.vanta.com/v1/integrations/{integrationId}/resource-kinds/{resourceKind}/resources/{resourceId}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "responseType": "Resource",
  "resourceKind": "AsanaTask",
  "resourceId": "5e7400d77a8e3731ab2d5c8e",
  "connectionId": "62ffd6793ef7978318baefa8",
  "displayName": "My Security Task",
  "owner": null,
  "inScope": true,
  "description": null,
  "creationDate": "2024-03-06T19:02:25.202Z"
}

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

integrationId

string

required

Unique identifier of the integration.

resourceKind

string

required

Unique identifier of the integration resource kind.

resourceId

string

required

Unique identifier of the resource.

Response

200 - application/json

Ok

responseType

enum<string>

required

Available options:

Account,

AutoScalingGroup,

ClusterDeployment,

ComputeInstance,

ContainerCluster,

ContainerRepository,

Database,

Device,

GitRepository,

KubernetesCluster,

LoadBalancer,

PaaS,

Resource,

Queue,

ServerlessFunction,

StorageBucket

resourceKind

string

required

The identifier for the resource type, unique within the scope of an Integration.

resourceId

string

required

The unique identifier for the Resource.

connectionId

string | null

required

The unique identifier for the Connection used to ingest the Resource if it exists.

displayName

string

required

The Resource's display name.

owner

string | null

required

The unique identifier for the owner of the resource in Vanta.

inScope

boolean

required

Whether the resource is in scope for audits.

description

string | null

required

The description of the resource in Vanta.

creationDate

string<date-time>

required

When Vanta first ingested the Resource.

deletedDate

string<date-time> | null

When the resource was deleted/removed from the integration, if applicable. This field is only present when the resource has been deleted.

⌘I

Get resource by ID

curl --request GET \
  --url https://api.vanta.com/v1/integrations/{integrationId}/resource-kinds/{resourceKind}/resources/{resourceId} \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://api.vanta.com/v1/integrations/{integrationId}/resource-kinds/{resourceKind}/resources/{resourceId}"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.vanta.com/v1/integrations/{integrationId}/resource-kinds/{resourceKind}/resources/{resourceId}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.vanta.com/v1/integrations/{integrationId}/resource-kinds/{resourceKind}/resources/{resourceId}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.vanta.com/v1/integrations/{integrationId}/resource-kinds/{resourceKind}/resources/{resourceId}"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.get("https://api.vanta.com/v1/integrations/{integrationId}/resource-kinds/{resourceKind}/resources/{resourceId}")
  .header("Authorization", "Bearer <token>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.vanta.com/v1/integrations/{integrationId}/resource-kinds/{resourceKind}/resources/{resourceId}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "responseType": "Resource",
  "resourceKind": "AsanaTask",
  "resourceId": "5e7400d77a8e3731ab2d5c8e",
  "connectionId": "62ffd6793ef7978318baefa8",
  "displayName": "My Security Task",
  "owner": null,
  "inScope": true,
  "description": null,
  "creationDate": "2024-03-06T19:02:25.202Z"
}