> ## Documentation Index
> Fetch the complete documentation index at: https://docs.paxos.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Address Verification

> Verify that a user or partner controls a blockchain address.

<Warning>Address verification is in **Developer Preview**. Endpoints and schemas are subject to change. To participate, contact [Paxos Support](https://support.paxos.com).</Warning>

Address verification confirms that a user or partner controls a blockchain address. Verified addresses can establish reward claim eligibility and support compliance workflows.

<Info>
  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.
</Info>

## 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](/guides/developer/address-verification/verify-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](/api-reference/endpoints/address-verification/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](https://support.paxos.com) 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](/api-reference/endpoints/address-verification/get-verification) with the returned `id`. For `SIGNATURE`, submit the collected signature via [Submit Signature](/api-reference/endpoints/address-verification/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                                                                                                                                                                                                                                                                                                                      |

<Info>
  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.
</Info>

## Supported Networks

All networks support both `SIGNATURE` 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](/api-reference/endpoints/address-verification/create-verification) | Initiate a new verification                               |
| [Submit Signature](/api-reference/endpoints/address-verification/submit-signature)               | Submit a signature to complete a `SIGNATURE` verification |
| [Get Address Verification](/api-reference/endpoints/address-verification/get-verification)       | Retrieve a single verification by ID                      |
| [List Address Verifications](/api-reference/endpoints/address-verification/list-verifications)   | List verifications with optional filters                  |

## Next Steps

<CardGroup cols={3}>
  <Card title="Verify an Address" icon="circle-check" href="/guides/developer/address-verification/verify-address">
    End-to-end walkthrough for signature and small deposit methods
  </Card>

  <Card title="Verification Statuses" icon="arrow-right-arrow-left" href="/guides/developer/address-verification/statuses">
    Status transitions and what triggers each one
  </Card>

  <Card title="FAQ" icon="circle-question" href="/guides/developer/address-verification/faq">
    Troubleshooting and common questions
  </Card>
</CardGroup>

> Questions? Contact [Support](https://support.paxos.com).