---
title: "Get Services by Tags"
method: GET
path: "/api/v1/directory/services/search"
---

# Get Services by Tags

`GET /api/v1/directory/services/search`

## Request

- Base URL: `https://api.skyfire.xyz`
- URL: `https://api.skyfire.xyz/api/v1/directory/services/search`
- Auth: none required

Get all of the services that match the given tags.

## Query parameters

- `commaDelimitedTags` string, required

## Response `200`

Ok

- object
  - `data` DirectoryService[]: The matching services.
    - `id` string, uuid: Unique identifier of the service.
    - `name` string: The name of the service.
    - `description` string: The description of the service.
    - `tags` string[]: The tags for this service. Empty if none were set.
    - `type` 'API' | 'WEB_PAGE' | 'VERIFIED_DOMAIN' | 'MCP_SERVER_LOCAL' | 'MCP_SERVER_REMOTE' | 'FETCH_AGENT': One of "API", "WEB_PAGE", "VERIFIED_DOMAIN", "MCP_SERVER_LOCAL", "MCP_SERVER_REMOTE", or "FETCH_AGENT"
    - `price` string: USD as string.
    - `priceModel` 'PAY_PER_USE' | 'SUBSCRIPTION' | 'PAY_PER_MB' | 'CUSTOM': One of "PAY_PER_USE", "SUBSCRIPTION", "PAY_PER_MB", or "CUSTOM"
    - `minimumTokenAmount` string: USD as string.
    - `humanIdentityRequirement` object: The identity verification requirements for individuals, organizations, or both. See https://docs.skyfire.xyz/reference/identity-fields for more info.
      - `identityLevels` string[]: Identity levels required from verified humans. e.g. `"INDIVIDUAL_LEVEL2"`.
      - `organization` string[]: Organization identity fields required.
      - `individual` string[]: Individual identity fields required.
    - `seller` object: The seller that owns this service.
      - `id` string, uuid: Unique identifier of the seller.
      - `name` string: The name of the seller.
      - `identityLevel` string: The seller's verified identity level, when available. e.g. `"BUSINESS_LEVEL1"`.
    - `openApiSpecUrl` string: Present when `type` is API.
    - `websiteUrl` string: Present when `type` is WEB_PAGE.
    - `fetchAgentProfileUrl` string: Present when `type` is FETCH_AGENT.
    - `mcpServerUrl` string: Present when `type` is MCP_SERVER_LOCAL or MCP_SERVER_REMOTE.
    - `acceptedTokens` string[]: Any of "kya", "pay", and/or "kya-pay".
    - `createdAt` string, date-time: When the service was created.
    - `updatedAt` string, date-time: When the service was last updated.

## Other responses

- `422`: Unprocessable Entity

---

[API](https://skmtc.dev/skyfire/apis/skyfire-service-directory-apis.md) - [All operations](https://skmtc.dev/skyfire/apis/skyfire-service-directory-apis/llms.txt) - [OpenAPI document](https://skmtc.dev/skyfire/apis/skyfire-service-directory-apis/revisions/916869a568cf?raw)