> ## Documentation Index > Fetch the complete documentation index at: https://docs.useanima.sh/llms.txt > Use this file to discover all available pages before exploring further. # Get registryagentssearch ## OpenAPI ````yaml /openapi.json get /registry/agents/search openapi: 3.1.1 info: title: Anima API version: 0.1.0 description: >- The Anima API provides programmatic access to unified infrastructure for AI agents: create and manage agents; send and receive email; place phone calls and send/receive SMS and voice; store and retrieve vault credentials; manage agent identity; and configure webhooks for real-time events. Authenticate using a Bearer token or an API key passed via the X-API-Key header. contact: name: Anima Labs url: https://useanima.sh email: support@useanima.sh license: name: MIT url: https://opensource.org/licenses/MIT servers: - url: https://api.useanima.sh/v1 description: Production security: - BearerAuth: [] - ApiKeyAuth: [] paths: /registry/agents/search: get: operationId: registry.search parameters: - name: query in: query schema: type: string maxLength: 200 description: Free-text search across name and description allowEmptyValue: true allowReserved: true - name: capability in: query schema: type: string description: Filter by a specific capability allowEmptyValue: true allowReserved: true - name: kyaLevel in: query schema: type: string description: >- Reserved — accepted for backward compatibility but not used as a filter yet allowEmptyValue: true allowReserved: true - name: trustMin in: query schema: type: integer minimum: 0 maximum: 100 description: >- Reserved — accepted for backward compatibility but not used as a filter. `trustScore` is not computed yet, so filtering on it would silently return an empty directory rather than a trusted subset. allowEmptyValue: true allowReserved: true - name: tags in: query schema: type: array items: type: string maxItems: 50 description: >- Filter by tags (entries must match at least one). A single value (`?tags=support`) is accepted as well as the repeated and bracketed forms. style: deepObject explode: true allowEmptyValue: true allowReserved: true - name: cursor in: query schema: type: string pattern: ^[cC][^\s-]{8,}$ description: Cursor for pagination allowEmptyValue: true allowReserved: true - name: limit in: query schema: default: 20 type: integer minimum: 1 maximum: 100 description: Maximum items per page allowEmptyValue: true allowReserved: true responses: '200': description: OK content: application/json: schema: type: object properties: items: type: array items: type: object properties: id: type: string pattern: ^[cC][^\s-]{8,}$ description: Unique identifier of the registry entry did: type: string description: Decentralized identifier of the agent agentId: type: string pattern: ^[cC][^\s-]{8,}$ description: ID of the registered agent orgId: type: string pattern: ^[cC][^\s-]{8,}$ description: Organization that owns the agent public: type: boolean description: Whether the listing is publicly visible name: type: string description: Display name description: anyOf: - type: string - type: 'null' description: Agent description agentCard: type: object additionalProperties: {} description: Structured agent card with capabilities and metadata trustScore: type: integer description: >- Reserved — a fixed placeholder, not a ranking. Not computed from any signal; do not sort, filter, or gate on it. Verify an agent cryptographically instead: resolve its DID document and check the signatures on its verifiable credentials. kyaLevel: type: string description: >- KYA verification level (reserved — not yet populated) capabilities: type: array items: type: string description: List of agent capabilities tags: type: array items: type: string description: Searchable tags verified: type: boolean description: >- Whether the agent has been verified (reserved — not yet populated) verifiedAt: anyOf: - type: string format: date-time - type: 'null' description: >- Timestamp of verification (reserved — not yet populated) listedAt: type: string format: date-time description: Timestamp when the agent was listed updatedAt: type: string format: date-time description: Timestamp of last update required: - id - did - agentId - orgId - public - name - description - agentCard - trustScore - kyaLevel - capabilities - tags - verified - verifiedAt - listedAt - updatedAt description: Full registry entry representation description: Array of matching registry entries nextCursor: anyOf: - type: string pattern: ^[cC][^\s-]{8,}$ - type: 'null' description: Cursor for fetching the next page total: type: integer description: Total number of entries matching the query required: - items - nextCursor - total description: Paginated search results from the agent registry components: securitySchemes: BearerAuth: type: http scheme: bearer bearerFormat: JWT description: >- JWT Bearer token obtained from authentication. Pass as: Authorization: Bearer ApiKeyAuth: type: apiKey in: header name: X-API-Key description: 'API key for programmatic access. Pass as: X-API-Key: ' ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.