List requests for information
curl --request GET \
--url https://api.enterprise.sandbox.uphold.com/core/requests-for-information \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.enterprise.sandbox.uphold.com/core/requests-for-information"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.enterprise.sandbox.uphold.com/core/requests-for-information', 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.enterprise.sandbox.uphold.com/core/requests-for-information",
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.enterprise.sandbox.uphold.com/core/requests-for-information"
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.enterprise.sandbox.uphold.com/core/requests-for-information")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.enterprise.sandbox.uphold.com/core/requests-for-information")
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{
"requestsForInformation": [
{
"id": "3f6d0c1e-a1bf-4b25-9802-2a3ee492d3c8",
"type": "travel-rule",
"status": "pending",
"expiresAt": "2024-08-08T10:00:00.000Z",
"context": {
"network": "xrp-ledger",
"addresses": [
"rN7n7otQDd6FczFgLdlqtyMVrn3WD6CJYy"
]
},
"proofOptions": {
"selfDeclaration": {},
"messageSigning": {}
}
},
{
"id": "19ca55fb-fc52-4209-b765-e3dbdc327231",
"type": "crypto-address-travel-rule",
"status": "ok",
"expiresAt": "2024-08-08T10:00:00.000Z",
"context": {
"network": "bitcoin",
"addresses": [
"mmLpwJCSnw3SEiN1un8GACvwx4f1ddB6SV"
]
},
"proofOptions": {
"selfDeclaration": {
"schema": {
"type": "object",
"required": [
"isVASP",
"isSelfHostedWallet",
"isSelfOwnedCryptoAddress"
],
"properties": {
"isVASP": {
"type": "boolean"
},
"isSelfHostedWallet": {
"type": "boolean"
},
"isSelfOwnedCryptoAddress": {
"type": "boolean"
},
"isBusiness": {
"type": "boolean"
},
"name": {
"type": "object"
}
}
}
}
},
"proof": {
"isVASP": false,
"isSelfHostedWallet": true,
"isSelfOwnedCryptoAddress": true,
"isBusiness": false,
"name": {
"primaryIdentifier": "Jane",
"secondaryIdentifier": "Doe"
}
}
},
{
"id": "ba6b76c1-30d8-4b0a-9720-9c9f6c8a5b1e",
"type": "crypto-address-verification",
"status": "ok",
"expiresAt": "2024-08-08T10:00:00.000Z",
"context": {
"network": "bitcoin",
"addresses": [
"mmLpwJCSnw3SEiN1un8GACvwx4f1ddB6SV"
]
},
"proofOptions": {
"messageSigning": {
"message": "I certify that the blockchain address mmLpwJCSnw3SEiN1un8GACvwx4f1ddB6SV belongs to e4ce04dc-67b7-4e9f-af91-482cb6f9fc4a on 2024-07-25T10:00:00.000Z"
},
"satoshiTest": {
"address": "mvGGPUZUf5NyLL7yQ5nZ1CvJ9zZ2Rq3xYo",
"asset": "BTC",
"amount": "1.08800000",
"amountSubunits": "108800000",
"decimals": 8
}
},
"proof": {
"type": "satoshi-test",
"proof": "0A54047F7D37029D5BDA9609D9CBE615B751218BE42A6EEA29347CA6F2447F7C"
}
}
]
}Requests for information
List requests for information
List requests for information for a specific reference.
GET
/
core
/
requests-for-information
List requests for information
curl --request GET \
--url https://api.enterprise.sandbox.uphold.com/core/requests-for-information \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.enterprise.sandbox.uphold.com/core/requests-for-information"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.enterprise.sandbox.uphold.com/core/requests-for-information', 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.enterprise.sandbox.uphold.com/core/requests-for-information",
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.enterprise.sandbox.uphold.com/core/requests-for-information"
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.enterprise.sandbox.uphold.com/core/requests-for-information")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.enterprise.sandbox.uphold.com/core/requests-for-information")
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{
"requestsForInformation": [
{
"id": "3f6d0c1e-a1bf-4b25-9802-2a3ee492d3c8",
"type": "travel-rule",
"status": "pending",
"expiresAt": "2024-08-08T10:00:00.000Z",
"context": {
"network": "xrp-ledger",
"addresses": [
"rN7n7otQDd6FczFgLdlqtyMVrn3WD6CJYy"
]
},
"proofOptions": {
"selfDeclaration": {},
"messageSigning": {}
}
},
{
"id": "19ca55fb-fc52-4209-b765-e3dbdc327231",
"type": "crypto-address-travel-rule",
"status": "ok",
"expiresAt": "2024-08-08T10:00:00.000Z",
"context": {
"network": "bitcoin",
"addresses": [
"mmLpwJCSnw3SEiN1un8GACvwx4f1ddB6SV"
]
},
"proofOptions": {
"selfDeclaration": {
"schema": {
"type": "object",
"required": [
"isVASP",
"isSelfHostedWallet",
"isSelfOwnedCryptoAddress"
],
"properties": {
"isVASP": {
"type": "boolean"
},
"isSelfHostedWallet": {
"type": "boolean"
},
"isSelfOwnedCryptoAddress": {
"type": "boolean"
},
"isBusiness": {
"type": "boolean"
},
"name": {
"type": "object"
}
}
}
}
},
"proof": {
"isVASP": false,
"isSelfHostedWallet": true,
"isSelfOwnedCryptoAddress": true,
"isBusiness": false,
"name": {
"primaryIdentifier": "Jane",
"secondaryIdentifier": "Doe"
}
}
},
{
"id": "ba6b76c1-30d8-4b0a-9720-9c9f6c8a5b1e",
"type": "crypto-address-verification",
"status": "ok",
"expiresAt": "2024-08-08T10:00:00.000Z",
"context": {
"network": "bitcoin",
"addresses": [
"mmLpwJCSnw3SEiN1un8GACvwx4f1ddB6SV"
]
},
"proofOptions": {
"messageSigning": {
"message": "I certify that the blockchain address mmLpwJCSnw3SEiN1un8GACvwx4f1ddB6SV belongs to e4ce04dc-67b7-4e9f-af91-482cb6f9fc4a on 2024-07-25T10:00:00.000Z"
},
"satoshiTest": {
"address": "mvGGPUZUf5NyLL7yQ5nZ1CvJ9zZ2Rq3xYo",
"asset": "BTC",
"amount": "1.08800000",
"amountSubunits": "108800000",
"decimals": 8
}
},
"proof": {
"type": "satoshi-test",
"proof": "0A54047F7D37029D5BDA9609D9CBE615B751218BE42A6EEA29347CA6F2447F7C"
}
}
]
}
List requests for information returns every RFI associated with a given
reference query parameter.
reference accepts a quote ID or a transaction ID for travel-rule RFIs, or a crypto address itself for crypto-address-travel-rule and crypto-address-verification RFIs — pass whichever the RFI is associated with.Authorizations
OAuth 2.0 authentication.
FlowClient Credentials
- Token URL
- /core/oauth2/token
Scopes1
core.requests-for-information:read
Grants access to view requests for information
Query Parameters
The reference value. This is typically a transaction or quote id (uuid), but for a crypto address travel rule request for information it is the crypto address itself.
Maximum string length:
256Pattern:
^\S.*\S$|^\S$Response
200 - application/json
Requests for information retrieved.
requestsForInformation
(Travel rule · object | Crypto address travel rule · object | Crypto address verification · object)[]
required
The request for information to obtain travel rule details when they are missing or insufficient.
- Travel rule
- Crypto address travel rule
- Crypto address verification
Show child attributes
Show child attributes
Was this page helpful?