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

# candidate_profile_read

> 按 ID 读取候选人完整结构化档案。

`candidate_profile_read` 返回单个候选人的全字段档案，包含基础信息 / 联系方式 / 教育 / 工作 / 标签 / 备注等。

通常和 `candidate_search` 配合使用：先用 search 拿到 `candidate_id` 列表，再用本 skill 读详细档案。

## 参数

| 字段             | 类型   | 必填 | 说明     |
| -------------- | ---- | -- | ------ |
| `candidate_id` | uuid | 是  | 候选人 ID |

## 返回

```json theme={null}
{
  "id": "uuid",
  "full_name": "张三",
  "phone": "138...",
  "email": "zhang@...",
  "current_title": "高级后端工程师",
  "current_company": "字节跳动",
  "current_city": "北京",
  "current_status": "在职-看机会",
  "highest_education": "硕士",
  "school_name": "清华大学",
  "major": "计算机科学",
  "years_of_experience": 8,
  "skills": ["Python", "Go", "PostgreSQL"],
  "industries": ["互联网"],
  "functions": ["后端开发"],
  "ai_summary": "...",
  "concerns": "...",
  "motivation": "...",
  "recommendation_notes": "...",
  "interview_notes": "...",
  "personality_notes": "...",
  "profile_status": "confirmed"
}
```

完整字段列表见 `GET /api/external/v1/skills/candidate_profile_read` 的 schema 元数据。

## 示例

```bash theme={null}
curl -X POST https://api.dropcv.work/api/external/v1/skills/candidate_profile_read/invoke \
  -H "Authorization: Bearer $DROPCV_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"params": {"candidate_id": "..."}}'
```

## 错误

`404 not found`：候选人不存在 **或** 不属于你的账号。两种情况都返回 404，不暴露存在性。

## 权限

不需要 write 权限。