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

# Retrieve crypto dedicated wallet

> Retrieve one dedicated crypto wallet by its Pasteaza reference.

Retrieve the current details and status of one crypto dedicated wallet.

## Endpoint

```http theme={null}
GET /v1/crypto/dedicated-addresses/{reference}
```

## Headers

```http theme={null}
Authorization: Bearer sk_test_xxx
```

## Path parameters

| Field | Type | Required | Description |
| - | - | - | - |
| `reference` | string | Yes | The Pasteaza `PZCDA_...` reference returned during creation. |

## Example request

```bash theme={null}
curl https://api.oyapasteaza.com/v1/crypto/dedicated-addresses/PZCDA_4E40E9A3D6E8495C \
  -H "Authorization: Bearer sk_test_xxx"
```

## Successful response

```json theme={null}
{
  "status": true,
  "message": "Dedicated crypto address retrieved.",
  "data": {
    "reference": "PZCDA_4E40E9A3D6E8495C",
    "customerReference": "CUS_001",
    "asset": "USDC",
    "network": "SOLANA",
    "address": "7M9p...xQ2a",
    "status": "ACTIVE",
    "createdAt": "2026-08-15T09:00:00.000Z"
  }
}
```

## Errors

| Code | Meaning |
| - | - |
| `authentication_failed` | The API key is missing or invalid. |
| `validation_failed` | `reference` is missing. |
| `crypto_dedicated_address_not_found` | No wallet matched the reference in this merchant and environment. |

## Next step

<Card title="Disable crypto dedicated wallet" icon="ban" href="/collections/crypto-dedicated-accounts/disable-crypto-dedicated-account">
  Stop accepting the assignment as an active dedicated wallet.
</Card>


## OpenAPI

````yaml openapi.yaml GET /v1/crypto/dedicated-addresses/{reference}
openapi: 3.1.0
info:
  title: Pasteaza API
  version: 1.0.0
  description: Collect and disburse bank and crypto payments with Pasteaza.
servers:
  - url: https://api.oyapasteaza.com
    description: Pasteaza API — the API key selects test or live mode
security:
  - bearerAuth: []
tags:
  - name: Hosted Checkout
  - name: Virtual Accounts
  - name: Dedicated Bank Accounts
  - name: Temporary Crypto Wallets
  - name: Dedicated Crypto Wallets
  - name: Bank Transfers
  - name: Crypto Transfers
paths:
  /v1/crypto/dedicated-addresses/{reference}:
    get:
      tags:
        - Dedicated Crypto Wallets
      summary: Retrieve dedicated crypto wallet
      operationId: retrieveDedicatedCryptoWallet
      parameters:
        - $ref: '#/components/parameters/Reference'
      responses:
        '200':
          description: Dedicated crypto wallet retrieved.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SuccessResponse'
        default:
          $ref: '#/components/responses/Error'
components:
  parameters:
    Reference:
      name: reference
      in: path
      required: true
      description: Pasteaza reference or supported merchant reference.
      schema:
        type: string
  schemas:
    SuccessResponse:
      type: object
      required:
        - status
        - message
        - data
      properties:
        status:
          type: boolean
          const: true
        message:
          type: string
        data:
          type: object
          additionalProperties: true
    ErrorResponse:
      type: object
      required:
        - status
        - message
        - code
      properties:
        status:
          type: boolean
          const: false
        message:
          type: string
        code:
          type: string
  responses:
    Error:
      description: Request failed.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: Pasteaza secret key
      description: >-
        Use an `sk_test_...` key in the playground. Never enter a live key in
        shared environments.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.