---
title: "Get Agent's Service"
method: GET
path: "/api/v1/agents/seller-services/{sellerServiceId}"
---

# Get Agent's Service

`GET /api/v1/agents/seller-services/{sellerServiceId}`

## Request

- Base URL: `https://api.skyfire.xyz`
- URL: `https://api.skyfire.xyz/api/v1/agents/seller-services/{sellerServiceId}`
- Auth: API key in header `skyfire-api-key`

Get a particular service belonging to the seller agent.

## Path parameters

- `sellerServiceId` string, uuid, required

## Response `200`

Ok

- SellerService
  - `id` string, required: Unique identifier of the seller service.
  - `name` string, required: The name of the service.
  - `description` string, required: The description of the service.
  - `tags` string[], required: The tags for this service. Empty if none were set.
  - `type` 'API' | 'WEB_PAGE' | 'VERIFIED_DOMAIN' | 'MCP_SERVER_LOCAL' | 'MCP_SERVER_REMOTE' | 'FETCH_AGENT', required: One of "API", "WEB_PAGE", "VERIFIED_DOMAIN", "MCP_SERVER_LOCAL", "MCP_SERVER_REMOTE", or "FETCH_AGENT"
  - `price` string, required: USD as string. For priceModel: CUSTOM, use "0".
  - `priceModel` 'PAY_PER_USE' | 'SUBSCRIPTION' | 'PAY_PER_MB' | 'CUSTOM', required: One of "PAY_PER_USE", "SUBSCRIPTION", "PAY_PER_MB", or "CUSTOM"
  - `minimumTokenAmount` string, required: USD as string. For CUSTOM, use "0". Must be ≥ price after numeric conversion.
  - `humanIdentityRequirement` object, required: 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_LEVEL1"`.
    - `organization` string[]: Values must be allowed identity field names.
    - `individual` string[]: Values must be allowed identity field names.
  - `openApiSpecUrl` string: Required when `type` is API.
  - `websiteUrl` string: Required when `type` is WEB_PAGE.
  - `fetchAgentProfileUrl` string: Required when `type` is FETCH_AGENT.
  - `mcpServerUrl` string: Required when `type` is MCP_SERVER_LOCAL or MCP_SERVER_REMOTE.
  - `termsOfService` object: The details of the terms of service if they exist.
    - `url` string: The URL where the terms of service are available to review.
    - `required` boolean: `true` if acceptance of the terms of service is required.
  - `acceptedTokens` string[]: Any of "kya", "pay", and/or "kya-pay". Must not be an empty array. If field is omitted, then all token types are accepted.
  - `maxTokenTTLSeconds` number: Maximum token TTL in seconds.
  - `seller` object, required: The seller that owns this service.
    - `id` string: Unique identifier of the seller.
    - `name` string: Name of the seller.
    - `identityLevel` string: Does not exist if the seller has not done verification.
  - `createdAt` string, required: When the service was created. e.g. `"2025-07-18T02:51:54.265Z"`.
  - `updatedAt` string, required: When the service was last updated. e.g. `"2025-07-18T02:54:19.767Z"`.
  - `active` boolean, required: Whether the service is active.
  - `approved` boolean, required: Whether the service has been approved. Only approved services can be activated.

## Other responses

- `404`: Not Found
- `422`: Unprocessable Entity

## Changes

- **2026-11-03** `22cbec9d7630`: 1 breaking, 10 warning, 22 info
  - for the `path` request parameter `sellerServiceId`, the format changed from no format to `uuid`
  - added the new `API` enum value to the `type` response property for the response status `200`
  - added the new `CUSTOM` enum value to the `priceModel` response property for the response status `200`
  - added the new `FETCH_AGENT` enum value to the `type` response property for the response status `200`
  - …29 more

[Operation history](https://skmtc.dev/skyfire/apis/skyfire-agent-and-token-apis/changes/api/v1/agents/seller-services/:sellerServiceId/get.md)

---

[API](https://skmtc.dev/skyfire/apis/skyfire-agent-and-token-apis.md) - [All operations](https://skmtc.dev/skyfire/apis/skyfire-agent-and-token-apis/llms.txt) - [OpenAPI document](https://skmtc.dev/skyfire/apis/skyfire-agent-and-token-apis/revisions/22cbec9d7630?raw)