팀 및 차량 › 기술자 목록 조회
기술자 목록 조회 현장 인력 명단을 반환합니다: 상태, 배정 등급(lead, buddy, float), 기술 및 크루 관계를 포함한 페이지네이션된 기술자(현장 작업자/엔지니어) 목록 — 디스패치 엔진이 작업에 스케줄링하는 인력입니다. 고객 레코드에서 허용되는 `preferred_technician_id`를 여기서 확인하십시오. 증분 인력 동기화를 위한 `since` 커서를 지원합니다.
인수 page integer query 선택
페이지 번호 (기본값 1)
limit integer query 선택
페이지당 항목 수 (기본값 15, 최대 1000)
status string query 선택
상태로 필터링 (active, onboarding, deactive)
assignment_tier string query 선택
배정 등급으로 필터링 (lead, buddy, float)
keyword string query 선택
전체 이름, 이메일, 전화번호 또는 주소로 검색합니다
sort string query 선택
정렬: created_at_desc|created_at_asc|name_asc|name_desc (기본값: created_at_desc)
since string query 선택
짧은 주기 폴링(short-polling)용 RFC3339 커서입니다. 이전 응답의 next_since 값을 그대로 전달하십시오
GET /v1/technicians
cURL Node Python Go Ruby PHP Java .NET
⧉ 복사 curl -X GET "https://api.crisphive.com/v1/technicians" \
-H "Authorization: Bearer chsk_test_4eC8xQ9mZ2pL7Ka0rT" 응답 200 OK ▾
400 INVALID_REQUEST_BODY ▾
401 UNAUTHORIZED ▾
403 API_KEY_SCOPE_INSUFFICIENT — the key authenticated but is restricted and does not carry the permission this endpoint requires. data.required_scope names the missing permission code. Mint a key that carries it (a full-access key carries all of them); this is NOT the same as your user account lacking a permission.
PLAN_MODULE_NOT_INCLUDED — the business's subscription plan does not include the module this endpoint belongs to. data.module names it. This is a BILLING answer, not a credential one: no key, however broad, can reach a module the plan excludes — the business has to upgrade. Distinguish it from API_KEY_SCOPE_INSUFFICIENT by error_code, never by status. ▾
429 TOO_MANY_REQUESTS — per-key rate limit exceeded (240 requests/min, shared across /v1 and /mcp). Back off for the number of seconds in the Retry-After header; every response also carries X-RateLimit-Limit / X-RateLimit-Remaining / X-RateLimit-Reset. ▾
