---
updatedAt: 2026-08-28T15:24:38.000Z
agentTools:
  projectIndex: https://docs.caliza.com/llms.txt
---

# Search the VASP directory

Searches the directory of Virtual Asset Service Providers (crypto exchanges and custodial wallet providers) available for crypto recipient creation. Returns a paginated list of VASPs matching the optional search query. Use the returned VASP id as the vaspId in the crypto recipient's details object when the destination wallet is hosted by that provider.

# OpenAPI definition

```json
{
  "openapi": "3.0.1",
  "info": {
    "title": "Caliza API documentation reference",
    "description": "The Caliza API enables seamless integration of financial services including payments, payouts, currency conversions, and compliance workflows. \n\n## Key Features\n- **Transaction Management**: Create, simulate, and track financial transactions across multiple currencies and payment rails\n- **Beneficiary Management**: Onboard and manage individuals and businesses with built-in KYC/KYB verification\n- **Multi-Currency Support**: Handle USD, BRL, MXN, EUR, and cryptocurrencies (USDT, USDC) with real-time exchange rates\n- **Payment Rails**: Support for ACH, Wire, PIX, SPEI, SWIFT, and blockchain networks (Ethereum, Polygon, Tron, Stellar, Base, Solana)\n- **Compliance**: Automated KYX workflows, document verification, and regulatory compliance features\n- **Webhooks**: Real-time event notifications for transaction status updates and system events\n\n## Getting Started\n1. Obtain your API credentials from the Caliza dashboard\n2. Authenticate using Bearer token (JWT)\n3. Create a simulation to preview transaction costs\n4. Execute transactions using the simulation ID\n5. Track status via webhooks or polling\n\n## Base URLs\n- **Sandbox**: `https://api.sandbox.caliza.com` - For testing and integration development\n- **Production**: `https://api.caliza.com` - For live transactions\n\n## Rate Limits\nAPI requests are rate-limited to ensure system stability. Contact support for rate limit increases.\n\n## Support\nFor technical support, integration questions, or API issues, contact our developer support team.\n",
    "version": "v1",
    "contact": {
      "name": "Caliza API Support",
      "email": "api-support@caliza.com",
      "url": "https://docs.caliza.com"
    },
    "termsOfService": "https://caliza.com/terms"
  },
  "security": [
    {
      "bearerAuth": []
    }
  ],
  "servers": [
    {
      "url": "https://api.sandbox.com",
      "description": "Sandbox Environment"
    },
    {
      "url": "https://api.caliza.com",
      "description": "Production Environment"
    },
    {
      "url": "https://api.sandbox.caliza.com",
      "description": "Sandbox Environment (backoffice)"
    }
  ],
  "tags": [
    {
      "name": "Recipient V1",
      "description": "Manage saved payment recipients used as payout destinations. Create, retrieve, update, list and delete recipient profiles including bank/crypto details and verification metadata."
    }
  ],
  "paths": {
    "/v1/recipients/vasps/search": {
      "get": {
        "tags": [
          "Recipient V1"
        ],
        "summary": "Search the VASP directory",
        "description": "Searches the directory of Virtual Asset Service Providers (crypto exchanges and custodial wallet providers) available for crypto recipient creation. Returns a paginated list of VASPs matching the optional search query. Use the returned VASP `id` as the `vaspId` in the crypto recipient's `details` object when the destination wallet is hosted by that provider.",
        "operationId": "searchVasps",
        "parameters": [
          {
            "name": "pageable",
            "in": "query",
            "description": "Pagination parameters including page number, size, and sorting options.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/Pageable"
            }
          },
          {
            "name": "searchQuery",
            "in": "query",
            "description": "Free-text search over the VASP directory (for example a provider name). When omitted, returns the full directory page by page.",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PageVaspResponse"
                }
              }
            }
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "PageableObject": {
        "type": "object",
        "description": "Pagination information object including page number, size, offset, and sorting configuration.",
        "properties": {
          "offset": {
            "type": "integer",
            "format": "int64",
            "description": "Number of elements to skip from the beginning of the result set.",
            "example": 20
          },
          "sort": {
            "$ref": "#/components/schemas/Sort"
          },
          "pageNumber": {
            "type": "integer",
            "format": "int32",
            "description": "Zero-based page number (0 = first page).",
            "example": 0
          },
          "pageSize": {
            "type": "integer",
            "format": "int32",
            "description": "Number of elements per page.",
            "example": 10
          },
          "paged": {
            "type": "boolean",
            "description": "Indicates if pagination is enabled.",
            "example": true
          },
          "unpaged": {
            "type": "boolean",
            "description": "Indicates if pagination is disabled.",
            "example": false
          }
        }
      },
      "Sort": {
        "type": "object",
        "description": "Sorting configuration for paginated results including order direction and property to sort by.",
        "properties": {
          "empty": {
            "type": "boolean",
            "description": "Indicates if no sorting is applied.",
            "example": false
          },
          "sorted": {
            "type": "boolean",
            "description": "Indicates if results are sorted.",
            "example": true
          },
          "unsorted": {
            "type": "boolean",
            "description": "Indicates if results are not sorted.",
            "example": false
          }
        }
      },
      "Pageable": {
        "type": "object",
        "description": "Pagination parameters for list requests including page number, size, and sort order.",
        "properties": {
          "page": {
            "minimum": 0,
            "type": "integer",
            "format": "int32",
            "description": "Zero-based page number to retrieve (0 = first page).",
            "example": 0
          },
          "size": {
            "minimum": 1,
            "type": "integer",
            "format": "int32",
            "description": "Number of items per page (minimum 1).",
            "example": 20
          },
          "sort": {
            "type": "array",
            "description": "Array of sort criteria in format 'property,direction' (e.g., 'createdDate,desc').",
            "example": [
              "createdDate,desc",
              "id,asc"
            ],
            "items": {
              "type": "string"
            }
          }
        }
      },
      "VaspResponse": {
        "type": "object",
        "description": "A Virtual Asset Service Provider (crypto exchange or custodial wallet provider) from the VASP directory.",
        "properties": {
          "id": {
            "type": "string",
            "description": "Directory identifier of the VASP. Use it as the `vaspId` in a crypto recipient's `details` object."
          },
          "name": {
            "type": "string",
            "description": "Display name of the VASP."
          }
        }
      },
      "PageVaspResponse": {
        "type": "object",
        "description": "Paginated list of VASPs from the directory, including pagination metadata.",
        "properties": {
          "totalElements": {
            "type": "integer",
            "format": "int64"
          },
          "totalPages": {
            "type": "integer",
            "format": "int32"
          },
          "first": {
            "type": "boolean"
          },
          "last": {
            "type": "boolean"
          },
          "size": {
            "type": "integer",
            "format": "int32"
          },
          "content": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/VaspResponse"
            }
          },
          "number": {
            "type": "integer",
            "format": "int32"
          },
          "sort": {
            "$ref": "#/components/schemas/Sort"
          },
          "numberOfElements": {
            "type": "integer",
            "format": "int32"
          },
          "pageable": {
            "$ref": "#/components/schemas/PageableObject"
          },
          "empty": {
            "type": "boolean"
          }
        }
      }
    },
    "securitySchemes": {
      "bearerAuth": {
        "type": "http",
        "description": "JWT Bearer token authentication. Include your access token in the Authorization header:\n\n`Authorization: Bearer YOUR_ACCESS_TOKEN`\n\nTokens are obtained through the Caliza authentication flow and typically expire after 24 hours.\nRefresh your token before expiration to maintain uninterrupted access.\n",
        "scheme": "bearer",
        "bearerFormat": "JWT"
      }
    }
  }
}
```