Get Vault Lock

curl --request GET \
  --url https://api.dfns.io/vaults/{vaultId}/locks/{lockId} \
  --header 'Authorization: Bearer <token>'

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

fetch('https://api.dfns.io/vaults/{vaultId}/locks/{lockId}', 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.dfns.io/vaults/{vaultId}/locks/{lockId}",
  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.dfns.io/vaults/{vaultId}/locks/{lockId}"

	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))

}

require 'uri'
require 'net/http'

url = URI("https://api.dfns.io/vaults/{vaultId}/locks/{lockId}")

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

{
  "id": "vlt-lck-0lf1e-8a8ag-2ak7vrvusrj3so0j",
  "vaultId": "<string>",
  "network": "<string>",
  "tid": "<string>",
  "amount": "<string>",
  "owner": "<string>",
  "dateCreated": "2023-11-07T05:31:56Z",
  "externalId": "<string>",
  "reason": "<string>",
  "replacesLockId": "vlt-lck-0lf1e-8a8ag-2ak7vrvusrj3so0j",
  "replacedByLockId": "vlt-lck-0lf1e-8a8ag-2ak7vrvusrj3so0j",
  "dateDeleted": "2023-11-07T05:31:56Z"
}

GET

vaults

{vaultId}

locks

{lockId}

Get Vault Lock

curl --request GET \
  --url https://api.dfns.io/vaults/{vaultId}/locks/{lockId} \
  --header 'Authorization: Bearer <token>'

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

fetch('https://api.dfns.io/vaults/{vaultId}/locks/{lockId}', 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.dfns.io/vaults/{vaultId}/locks/{lockId}",
  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.dfns.io/vaults/{vaultId}/locks/{lockId}"

	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))

}

require 'uri'
require 'net/http'

url = URI("https://api.dfns.io/vaults/{vaultId}/locks/{lockId}")

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

{
  "id": "vlt-lck-0lf1e-8a8ag-2ak7vrvusrj3so0j",
  "vaultId": "<string>",
  "network": "<string>",
  "tid": "<string>",
  "amount": "<string>",
  "owner": "<string>",
  "dateCreated": "2023-11-07T05:31:56Z",
  "externalId": "<string>",
  "reason": "<string>",
  "replacesLockId": "vlt-lck-0lf1e-8a8ag-2ak7vrvusrj3so0j",
  "replacedByLockId": "vlt-lck-0lf1e-8a8ag-2ak7vrvusrj3so0j",
  "dateDeleted": "2023-11-07T05:31:56Z"
}

Authentication

✅ Organization User (CustomerEmployee)
❌ Delegated User (EndUser)
✅ Service Account

Required Permissions

Vaults:Read: Always required.

Authorizations

Authorization

string

header

required

Bearer Token: Used to authenticate API requests. More details how to generate the token: Authentication flows

Path Parameters

vaultId

string

required

Vault id.

Required string length: 1 - 64

Pattern: ^vlt-[a-z0-9]{5}-[a-z0-9]{5}-[a-z0-9]{14,16}$

lockId

string

required

The lock to retrieve.

Required string length: 1 - 64

Pattern: ^vlt-lck-[a-z0-9]{5}-[a-z0-9]{5}-[a-z0-9]{14,16}$

Response

200 - application/json

Success

Vault lock object: funds manually locked for off-chain settlement or escrow.

string

required

Vault lock id.

Required string length: 1 - 64

Pattern: ^vlt-lck-[a-z0-9]{5}-[a-z0-9]{5}-[a-z0-9]{14,16}$

Example:

"vlt-lck-0lf1e-8a8ag-2ak7vrvusrj3so0j"

vaultId

string

required

network

string

required

tid

string

required

amount

string

required

owner

string

required

The user that created the lock. Only this user can update or delete it.

dateCreated

string<date-time>

required

externalId

string

reason

string

The reason or note the lock was created with.

replacesLockId

string

Set when this lock was created by an update: the lock it replaces.

Required string length: 1 - 64

Pattern: ^vlt-lck-[a-z0-9]{5}-[a-z0-9]{5}-[a-z0-9]{14,16}$

Example:

"vlt-lck-0lf1e-8a8ag-2ak7vrvusrj3so0j"

replacedByLockId

string

Set when this lock was released by an update: the lock that replaced it.

Required string length: 1 - 64

Pattern: ^vlt-lck-[a-z0-9]{5}-[a-z0-9]{5}-[a-z0-9]{14,16}$

Example:

"vlt-lck-0lf1e-8a8ag-2ak7vrvusrj3so0j"

dateDeleted

string<date-time>

Last modified on September 11, 2026

API Authorization

Identity & Access Management

Wallets & Transactions

Management

Webhooks

Get Vault Lock

Authentication

Required Permissions

Authorizations

Path Parameters

Response

​Authentication

​Required Permissions

Authorizations

Path Parameters

Response

Authentication

Required Permissions