> ## Documentation Index
> Fetch the complete documentation index at: https://developer.uphold.com/llms.txt
> Use this file to discover all available pages before exploring further.
# List requests for information
> List requests for information for a specific reference.
export const RestEndpointSubjects = ({subjects = []}) => {
const subjectToIconMap = {
'client': 'browser',
'user:individual': 'user',
'user:business': 'briefcase'
};
if (subjects.length === 0) {
return null;
}
return <>
{subjects.map(subject =>
{subject}
)}
;
};
**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.
## OpenAPI
````yaml _media/specs/core-openapi.mintlify.json get /core/requests-for-information
openapi: 3.1.0
info:
version: 0.1.0
title: Core API
description: >-
The Core API provides essential building blocks that empower businesses to
embed financial services into their applications.
contact:
name: Uphold API Team
email: developers@uphold.com
url: https://developer.uphold.com
servers:
- url: https://api.enterprise.sandbox.uphold.com
description: Sandbox
- url: https://api.enterprise.uphold.com
description: Production
security:
- OAuth2: []
tags:
- name: Authentication
description: Authentication.
- name: Countries
description: Countries.
- name: Users
description: Users.
- name: KYC
description: Individual User's KYC.
- name: KYB
description: Business User's KYB.
- name: Capabilities
description: User capabilities.
- name: Terms of service
description: User terms of service.
- name: Files
description: Files.
- name: Assets
description: Assets, networks and rails.
- name: Accounts
description: Accounts.
- name: External accounts
description: External accounts.
- name: Transactions
description: Transactions.
- name: Requests for information
description: Requests for information.
- name: Portfolio
description: Portfolio.
- name: Statements
description: Statements.
- name: Metadata
description: Metadata.
- name: Webhooks
description: Webhooks.
paths:
/core/requests-for-information:
get:
tags:
- Requests for information
summary: List requests for information
description: List requests for information for a specific reference.
operationId: core.list-requests-for-information
parameters:
- $ref: '#/components/parameters/reference'
responses:
'200':
$ref: '#/components/responses/list-requests-for-information-response'
security:
- OAuth2:
- core.requests-for-information:read
components:
parameters:
reference:
name: reference
description: >-
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.
in: query
required: true
schema:
allOf:
- $ref: '#/components/schemas/string-no-edge-spaces'
- type: string
maxLength: 256
examples:
Reference:
value: 3f6d0c1e-a1bf-4b25-9802-2a3ee492d3c8
Crypto Address Reference:
value: rfBtmHiLwwWH5maH2PT78GxubrSydRF9aY
responses:
list-requests-for-information-response:
description: Requests for information retrieved.
content:
application/json:
schema:
type: object
properties:
requestsForInformation:
type: array
items:
$ref: '#/components/schemas/request-for-information'
required:
- requestsForInformation
examples:
Requests for Information Retrieved:
value:
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
headers:
x-uphold-request-id:
description: >-
A unique identifier for the request that can be shared with Uphold
for troubleshooting purposes.
required: true
schema:
type: string
format: uuid
examples:
Request ID:
value: 9092ee4d-f0fb-42e9-8787-b668dbcec531
schemas:
string-no-edge-spaces:
type: string
pattern: ^\S.*\S$|^\S$
request-for-information:
discriminator:
propertyName: type
mapping:
travel-rule: '#/components/schemas/request-for-information-travel-rule'
crypto-address-travel-rule: >-
#/components/schemas/request-for-information-crypto-address-travel-rule
crypto-address-verification: >-
#/components/schemas/request-for-information-crypto-address-verification
oneOf:
- $ref: '#/components/schemas/request-for-information-travel-rule'
title: Travel rule
- $ref: >-
#/components/schemas/request-for-information-crypto-address-travel-rule
title: Crypto address travel rule
- $ref: >-
#/components/schemas/request-for-information-crypto-address-verification
title: Crypto address verification
request-for-information-travel-rule:
allOf:
- $ref: '#/components/schemas/request-for-information-base'
- type: object
description: >-
The request for information to obtain travel rule details when they
are missing or insufficient.
properties:
proof:
type: object
additionalProperties: true
description: The provided travel rule information.
properties:
originatorProof:
oneOf:
- $ref: >-
#/components/schemas/request-for-information-self-declaration-proof
- $ref: >-
#/components/schemas/request-for-information-message-signing-proof
- $ref: >-
#/components/schemas/request-for-information-satoshi-test-proof
beneficiaryProof:
oneOf:
- $ref: >-
#/components/schemas/request-for-information-self-declaration-proof
- $ref: >-
#/components/schemas/request-for-information-message-signing-proof
- $ref: >-
#/components/schemas/request-for-information-satoshi-test-proof
request-for-information-crypto-address-travel-rule:
allOf:
- $ref: '#/components/schemas/request-for-information-base'
- type: object
description: >-
The request for information to obtain basic self-declaration for an
external account's crypto address.
properties:
proof:
type: object
additionalProperties: true
description: The provided basic self-declaration.
properties:
isVASP:
type: boolean
isSelfHostedWallet:
type: boolean
isSelfOwnedCryptoAddress:
type: boolean
isBusiness:
type: boolean
name:
type: object
additionalProperties: true
required:
- isVASP
- isSelfHostedWallet
- isSelfOwnedCryptoAddress
request-for-information-crypto-address-verification:
allOf:
- $ref: '#/components/schemas/request-for-information-base'
- type: object
description: >-
The request for information to obtain proof of ownership for an
external account's crypto address.
properties:
proof:
oneOf:
- $ref: >-
#/components/schemas/request-for-information-message-signing-proof
- $ref: >-
#/components/schemas/request-for-information-satoshi-test-proof
request-for-information-base:
type: object
properties:
id:
type: string
description: The id of the RFI.
type:
description: The type of the RFI.
type: string
enum:
- travel-rule
- crypto-address-travel-rule
- crypto-address-verification
status:
description: The status of the RFI.
type: string
enum:
- ok
- pending
- expired
- failed
expiresAt:
description: The date and time when the RFI expires.
type: string
format: date-time
context:
type: object
description: The context of this RFI.
properties:
network:
type: string
addresses:
type: array
items:
type: string
required:
- network
- addresses
proofOptions:
type: object
description: The proof mechanisms available to resolve this RFI.
properties:
selfDeclaration:
type: object
description: The self-declaration proof requirements.
properties:
schema:
type: object
additionalProperties: true
description: The JSON Schema describing which fields are required.
messageSigning:
type: object
description: The message signing proof requirements.
properties:
schema:
type: object
additionalProperties: true
description: The JSON Schema describing which fields are required.
message:
type: string
description: The exact message to sign.
satoshiTest:
type: object
description: The Satoshi test proof requirements.
properties:
address:
type: string
description: The address to send the deposit to.
asset:
type: string
description: The asset to send.
amount:
type: string
description: >-
The exact amount to send, in the asset's standard
denomination.
amountSubunits:
type: string
description: The exact amount to send, in the asset's smallest subunit.
decimals:
type: integer
description: >-
The number of decimal places used to convert between
`amount` and `amountSubunits`.
reference:
type: string
description: An optional destination tag/memo required by some networks.
required:
- address
- asset
- amount
- amountSubunits
required:
- id
- type
- status
- context
- proofOptions
request-for-information-self-declaration-proof:
type: object
additionalProperties: true
description: The provided self-declaration proof.
properties:
type:
type: string
enum:
- self-declaration
attestation:
type: string
required:
- type
- attestation
request-for-information-message-signing-proof:
type: object
additionalProperties: true
description: The provided message signing proof.
properties:
type:
type: string
enum:
- message-signing
scheme:
type: string
description: The specific signing scheme used.
enum:
- bip-137
- bip-322
- cip-8
- concordium
- cosmos-ecdsa
- ed25519
- eip-1271
- eip-191
- eip-712
- siwe
- siwx
- sol-siwx
- sr25519
- tip-191
- xlm-ed25519
- xpub
- xrp-ed25519
address:
type: string
attestation:
type: string
proof:
type: string
required:
- type
- scheme
request-for-information-satoshi-test-proof:
type: object
additionalProperties: true
description: The provided Satoshi test proof.
properties:
type:
type: string
enum:
- satoshi-test
proof:
type: string
required:
- type
securitySchemes:
OAuth2:
type: oauth2
description: OAuth 2.0 authentication.
flows:
clientCredentials:
tokenUrl: /core/oauth2/token
scopes:
core.users:act-on-behalf-of: Grants access to act on behalf of a user
core.users:create: Grants access to create users
core.users:read: Grants access to view users
core.users:delete: Grants access to delete users
core.users.metadata:read: Grants access to view user metadata
core.users.metadata:write: Grants access to modify user metadata
core.kyc:read: Grants access to view KYC processes
core.kyc.profile:update: Grants access to update profile KYC process
core.kyc.address:update: Grants access to update address KYC process
core.kyc.email:update: Grants access to update email KYC process
core.kyc.phone:update: Grants access to update phone KYC process
core.kyc.identity:update: Grants access to update identity KYC process
core.kyc.proof-of-address:update: Grants access to update proof-of-address KYC process
core.kyc.customer-due-diligence:update: Grants access to update customer due diligence KYC process
core.kyc.enhanced-due-diligence:update: Grants access to update enhanced due diligence KYC process
core.kyc.crypto-risk-assessment:update: Grants access to update crypto risk assessment KYC process
core.kyc.self-categorization-statement:update: Grants access to update self-categorization statement KYC process
core.kyc.tax-details:update: Grants access to update tax details KYC process
core.kyb:read: Grants access to view KYB processes
core.kyb.profile:update: Grants access to update profile KYB process
core.kyb.documents:update: Grants access to update documents KYB process
core.kyb.financial-institution:update: Grants access to update financial institution KYB process
core.kyb.associated-persons:create: Grants access to create KYB associated persons
core.kyb.associated-persons:read: Grants access to view KYB associated persons
core.kyb.associated-persons:delete: Grants access to delete KYB associated persons
core.kyb.associated-persons.profile:update: Grants access to update profile KYB associated person process
core.kyb.associated-persons.identity:update: Grants access to update identity KYB associated person process
core.kyb.associated-persons.proof-of-address:update: >-
Grants access to update proof-of-address KYB associated person
process
core.kyb.attestation:trigger: Grants access to trigger the attestation process
core.capabilities:read: Grants access to view user capabilities
core.terms-of-service:read: Grants access to view terms of service
core.terms-of-service:accept: Grants access to accept terms of service
core.files:create: Grants access to create files
core.files:read: Grants access to view files
core.files.metadata:read: Grants access to view files metadata
core.files.metadata:write: Grants access to modify files metadata
core.accounts:create: Grants access to create accounts
core.accounts:read: Grants access to view accounts
core.accounts:update: Grants access to update accounts
core.accounts:archive: Grants access to archive accounts
core.accounts:deposit-method: >-
Grants access to deposit method needed for depositing into
accounts
core.accounts:use-test-helpers: Grants access to test helpers of accounts
core.accounts.metadata:read: Grants access to view accounts metadata
core.accounts.metadata:write: Grants access to modify accounts metadata
core.assets:use-test-helpers: Grants access to test helpers of assets
core.external-accounts:create: Grants access to create external accounts
core.external-accounts:read: Grants access to view external accounts
core.external-accounts:update: Grants access to update external accounts
core.external-accounts:delete: Grants access to delete external accounts
core.external-accounts.metadata:read: Grants access to view external accounts metadata
core.external-accounts.metadata:write: Grants access to modify external accounts metadata
core.transactions:create: Grants access to commit quotes
core.transactions:read: Grants access to view transactions
core.transactions.metadata:read: Grants access to view transactions metadata
core.transactions.metadata:write: Grants access to modify transactions metadata
core.transactions.requests-for-information:read: Grants access to view transactions requests for information
core.transactions.requests-for-information:update: Grants access to update transactions requests for information
core.requests-for-information:read: Grants access to view requests for information
core.requests-for-information:update: Grants access to update requests for information
core.portfolio:read: >-
Grants access to view portfolio overview, performance, and
historical balance
core.statements:read: Grants access to read statements
core.webhooks:management-link: Grants access to create webhook management links
````