Skip to main content
GET
/
api
/
v1
/
proofs
/
check
Check proofs against public criteria
curl --request GET \
  --url https://api.neus.network/api/v1/proofs/check
{
  "success": true,
  "data": {},
  "timestamp": "2023-11-07T05:31:56Z"
}

Headers

​
x-wallet-address
string
​
x-signature
string
​
x-signed-timestamp
string
​
x-chain
string

CAIP-2 chain reference for non-EVM signature verification (e.g. solana:mainnet)

​
x-signature-method
string

Signature method hint for non-EVM signatures (e.g. ed25519)

Query Parameters

​
address
string
​
qHash
string
Pattern: ^0x[a-fA-F0-9]{64}$
​
verifierIds
string
​
verifierId
string
​
requireAll
boolean
​
minCount
integer
Required range: 1 <= x <= 1000
​
sinceDays
integer
Required range: 1 <= x <= 3650
​
since
integer
Required range: x >= 0
​
limit
integer
Required range: 1 <= x <= 1000
​
referenceType
string
​
referenceId
string
​
tag
string
​
tags
string
​
contentType
string
​
content
string
​
contentHash
string
​
contractAddress
string
​
tokenId
string
​
chainId
integer

EVM chain ID of the asset being checked (e.g. 1 for Ethereum Mainnet, 8453 for Base). Required for asset verifiers (nft-ownership, token-holding, contract-ownership). Not a hub or proof-storage filter.

Required range: x >= 1
​
domain
string
​
minBalance
string
​
provider
string
​
handle
string
​
namespace
string

When set, requires ownership-pseudonym proofs to include this namespace (matches verifier data.namespace; legacy proofs without namespace default to neus).

Required string length: 1 - 64
Pattern: ^[a-z0-9._-]+$
​
traitPath
string
​
traitGte
number
Required range: x >= 0
​
select
string
​
ownerAddress
string
​
riskLevel
string
​
sanctioned
boolean
​
poisoned
boolean
​
primaryWalletAddress
string
​
secondaryWalletAddress
string
​
controllerWallet
string

Approving account (delegation grantor) for agent-delegation checks; optional filter. Not the agent wallet.

​
agentWallet
string
​
delegationScope
string
​
agentId
string
​
verificationMethod
string
​
neusPersonhoodId
string
​
ageMin
integer
Required range: 0 <= x <= 150
​
sanctionsPassed
boolean
​
subject
enum<string>
Available options:
me
​
includePrivate
boolean

Response

OK

​
success
enum<boolean>
required
Available options:
true
​
data
object
required
​
timestamp