SKskyfire

Get Agent's Service

Changed on

Get a particular service belonging to the seller agent.

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

Path parameters

sellerServiceIdstring uuid required

Unique identifier of the seller service. e.g. "c8ed8e2c-c32c-4f6d-8b64-144a7b11e8ff"

Response

Ok

idstring required

Unique identifier of the seller service.

namestring required

The name of the service.

descriptionstring required

The description of the service.

tagsstring[] 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"

pricestring 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"

minimumTokenAmountstring required

USD as string. For CUSTOM, use "0". Must be ≥ price after numeric conversion.

openApiSpecUrlstring

Required when type is API.

websiteUrlstring

Required when type is WEB_PAGE.

fetchAgentProfileUrlstring

Required when type is FETCH_AGENT.

mcpServerUrlstring

Required when type is MCP_SERVER_LOCAL or MCP_SERVER_REMOTE.

acceptedTokensstring[]

Any of "kya", "pay", and/or "kya-pay". Must not be an empty array. If field is omitted, then all token types are accepted.

maxTokenTTLSecondsnumber

Maximum token TTL in seconds.

createdAtstring required

When the service was created. e.g. "2025-07-18T02:51:54.265Z".

updatedAtstring required

When the service was last updated. e.g. "2025-07-18T02:54:19.767Z".

activeboolean required

Whether the service is active.

approvedboolean required

Whether the service has been approved. Only approved services can be activated.

Changes

  • 22cbec9d7630Revision changes
    • breaking

      for the path request parameter sellerServiceId, the format changed from no format to uuid

    • warning

      added the new API enum value to the response property for the response status

    • warning

      added the new CUSTOM enum value to the response property for the response status

    • warning

      added the new FETCH_AGENT enum value to the response property for the response status

    • warning

      added the new MCP_SERVER_LOCAL enum value to the response property for the response status

    • warning

      added the new MCP_SERVER_REMOTE enum value to the response property for the response status

    • warning

      added the new PAY_PER_MB enum value to the response property for the response status

    • warning

      added the new PAY_PER_USE enum value to the response property for the response status

    • warning

      added the new SUBSCRIPTION enum value to the response property for the response status

    • warning

      added the new VERIFIED_DOMAIN enum value to the response property for the response status

    • warning

      added the new WEB_PAGE enum value to the response property for the response status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      the response property became required for the status

    • info

      the response property became required for the status

    • info

      the response property became required for the status

    • info

      the response property became required for the status

    • info

      the response property became required for the status

    • info

      the response property became required for the status

    • info

      the response property became required for the status

    • info

      the response property became required for the status

    • info

      the response property became required for the status

    • info

      the response property became required for the status

    • info

      the response property became required for the status

    • info

      the response property became required for the status

    • info

      the response property became required for the status

    • info

      the response property became required for the status

    • info

      the response's property default value true was removed for the status

    • info

      the response's property default value true was removed for the status

    • info

      the response's property default value true was removed for the status