The API represents each verification attempt as a verification record. A verification record is the API resource you create, retrieve, list, and complete. It confirms address control for the requested Paxos use case; it does not determine custody, title, or legal rights.
How Verification Works
Paxos supports two API verification methods and an off-platform manual review path. Choose based on what the address holder can do, then follow the Verify an Address guide.| Method | When to use | How it works |
|---|---|---|
SIGNATURE | The address holder can sign a message directly or through a wallet integration | Create a verification record, collect the signed message, then submit the signature via Submit Signature |
SMALL_DEPOSIT | The address holder can send a transaction from the address but cannot sign a message | Send the exact amount specified in the response from the address under verification to a Paxos-controlled address |
MANUAL | Additional verification requirements have not yet been automated | Contact Support for requirements. Manual review is handled off-platform and is not created through the public API. |
Verification Lifecycle
| Status | Meaning | Next step |
|---|---|---|
PENDING | In progress | Poll Get Address Verification with the returned id. For SIGNATURE, submit the collected signature via Submit Signature. For SMALL_DEPOSIT, wait for on-chain confirmation or send again from the same address. |
APPROVED | Address control confirmed | Done |
EXPIRED | Verification window elapsed | Create a new verification and retry |
API-created
SIGNATURE and SMALL_DEPOSIT verifications expire after 48 hours. Check expires_at in the response and create a new verification if the window elapses. Manual review is handled off-platform and does not expire through the public API.Supported Networks
All networks support bothSIGNATURE and SMALL_DEPOSIT. The signing standard only applies when using SIGNATURE.
| Network | Signing standard (SIGNATURE) |
|---|---|
ARBITRUM_ONE | EIP-191 (personal_sign) |
ETHEREUM | EIP-191 (personal_sign) |
INK | EIP-191 (personal_sign) |
ROBINHOOD | EIP-191 (personal_sign) |
SOLANA | ed25519 |
XLAYER | EIP-191 (personal_sign) |
Required OAuth Scopes
| Scope | Access |
|---|---|
address_ownership:read_verification | Read and list verifications |
address_ownership:write_verification | Create and complete verifications |
API Reference
| Endpoint | Description |
|---|---|
| Create Address Verification | Initiate a new verification |
| Submit Signature | Submit a signature to complete a SIGNATURE verification |
| Get Address Verification | Retrieve a single verification by ID |
| List Address Verifications | List verifications with optional filters |
Next Steps
Verify an Address
End-to-end walkthrough for signature and small deposit methods
Verification Statuses
Status transitions and what triggers each one
FAQ
Troubleshooting and common questions
Questions? Contact Support.