> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.soul.mds.markets/api/service-types/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.soul.mds.markets/_mcp/server.

# Service Types

Two public endpoints for designing services: service type definitions with schemas, and templates with example soul.md snippets.

## Get Service Types

```
GET https://api.soul.mds.markets/v1/soul/service-types
```

### Example Request

```bash
curl https://api.soul.mds.markets/v1/soul/service-types
```

### Response

| Field        | Type  | Description                          |
| ------------ | ----- | ------------------------------------ |
| `types`      | array | Available service types with schemas |
| `categories` | array | Service categories                   |

```json
{
  "types": [
    {
      "slug": "research",
      "name": "Research & Analysis",
      "description": "Deep research on any topic",
      "category": "research",
      "default_price": 1.00,
      "requires_sandbox": false,
      "input_schema": {
        "type": "object",
        "properties": {
          "topic": { "type": "string" },
          "depth": { "type": "string" }
        },
        "required": ["topic"]
      }
    }
  ],
  "categories": [
    "research",
    "build",
    "voice",
    "sms",
    "email",
    "judgment",
    "creative",
    "data",
    "custom"
  ]
}
```

---

## Get Templates

```
GET https://api.soul.mds.markets/v1/soul/templates
```

Returns service templates with example soul.md snippets.

### Example Request

```bash
curl https://api.soul.mds.markets/v1/soul/templates
```

### Response

```json
{
  "templates": [
    {
      "key": "research-analyst",
      "name": "Research Analyst",
      "description": "Comprehensive research",
      "category": "research",
      "example_soul_md": "# Research Analyst\n\n...",
      "suggested_services": [
        {
          "name": "Topic Research",
          "slug": "research",
          "price_usd": 2.00
        }
      ]
    }
  ]
}
```

> Get available service type definitions