> ## Documentation Index
> Fetch the complete documentation index at: https://docs.omocaptcha.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Lấy danh sách dịch vụ

> Lấy danh sách các dịch vụ có sẵn

Lấy danh sách tất cả loại captcha đang hỗ trợ kèm giá bán lẻ tính theo lượt.

> [!NOTE]
>
> Endpoint này dùng chung URL `/v2/getServicePrice` với [Lấy thông tin gói dịch vụ](https://docs.omocaptcha.com/vi/api/lay-thong-tin-goi-dich-vu.md). Truyền `"type": "service"` để lấy captcha bán lẻ; truyền `"type": "package"` để lấy gói combo.

## Request

```http theme={null}
POST https://api.omocaptcha.com/v2/getServicePrice
Content-Type: application/json
```

### Body Parameters

| Tham số | Kiểu | Bắt buộc | Mô tả |
| - | - | :-: | - |
| `type` | `String` | ❌ | Mặc định `"service"`. Truyền `"package"` để lấy danh sách gói combo. |

```json theme={null}
{
  "type": "service"
}
```

> [!TIP]
>
> Hoặc body rỗng `{}` cũng được — mặc định trả về `services`.

## Response

```json Thành công theme={null}
{
  "errorId": 0,
  "errorCode": "",
  "errorDescription": "",
  "services": [
    {
      "type": "RecaptchaV2ImageTask",
      "name": "reCAPTCHA v2 image",
      "price": "0.00027",
      "avgSuccess": "99%",
      "avgTime": "1s",
      "image": "recaptcha.svg",
      "description": "Google Inc",
      "requireFields": ["imageBase64"]
    },
    {
      "type": "FuncaptchaImageTask",
      "name": "FunCaptcha Image",
      "price": "0.00027",
      "avgSuccess": "99%",
      "avgTime": "1s",
      "image": "funcaptcha.svg",
      "description": "Arkose Labs",
      "requireFields": ["imageBase64", "other"]
    }
  ]
}
```

### Giải thích các trường

| Trường | Kiểu | Mô tả |
| - | - | - |
| `type` | `String` | Tên kỹ thuật — dùng trong `createTask.task.type` |
| `name` | `String` | Tên hiển thị cho UI |
| `price` | `String` | Giá tính theo lượt (USD, kiểu chuỗi để giữ độ chính xác thập phân) |
| `avgSuccess` | `String` | Tỷ lệ thành công trung bình |
| `avgTime` | `String` | Thời gian giải trung bình |
| `image` | `String` | Tên file icon (đường dẫn đầy đủ: `https://omocaptcha.com/storage/captcha-types/{filename}`) |
| `description` | `String` | Mô tả ngắn |
| `requireFields` | `Array` | Các trường bắt buộc phải truyền trong `task` khi gọi `createTask` |

## Endpoint public

> [!NOTE]
>
> Endpoint này **không yêu cầu xác thực**.

## Cache

> [!WARNING]
>
> Response được **cache 60 giây** phía máy chủ — nếu cần dữ liệu mới nhất, hãy đợi qua chu kỳ cache.

## Ví dụ sử dụng

```bash cURL theme={null}
curl -X POST https://api.omocaptcha.com/v2/getServicePrice \
  -H "Content-Type: application/json" \
  -d '{"type": "service"}'
```

```javascript Node.js theme={null}
const res = await fetch("https://api.omocaptcha.com/v2/getServicePrice", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({ type: "service" })
});
console.log(await res.json());
```

```python Python theme={null}
import requests

res = requests.post(
    "https://api.omocaptcha.com/v2/getServicePrice",
    json={"type": "service"}
)
print(res.json())
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.