API 레퍼런스
직원
매장에 소속된 직원과 고용 정보를 조회한다. 개인정보 보호를 위해 제공 항목을 엄격히 제한한다.
직원 목록
GET
/stores/{store_id}/staff staff:read매장의 직원 목록과 고용 정보를 조회한다.
×
제공하지 않는 항목
주민등록번호·외국인등록번호, 계좌번호, 은행코드, 상세주소, 생년월일, 연락처는 어떤 스코프로도 제공하지 않는다.
경로 파라미터
| 이름 | 타입 | 설명 |
|---|---|---|
| store_id 필수 | string | 매장 식별자 |
쿼리 파라미터
| 이름 | 타입 | 설명 |
|---|---|---|
| include_left | bool | 퇴사자 포함 여부. 기본 false |
| limit | int | 페이지 크기 |
| cursor | string | 다음 페이지 커서 |
응답 필드
| 이름 | 타입 | 설명 |
|---|---|---|
| staff_id | string | 불투명 식별자. 매장이 다르면 같은 사람도 값이 다르다 |
| employment_type | enum | none(없음) | full_time(정규직) | daily(일용직) | freelance(프리랜서) | other_income(기타소득자) |
| weekly_contract_hours | int | null | 주당 계약 근무시간 |
알아둘 것
- "아르바이트"라는 고용형태 값은 존재하지 않는다. 기그의 실제 값은 없음·정규직·일용직·프리랜서·기타소득자 다섯 가지다.
- weekly_contract_hours 는 정규직에만 원천 데이터가 존재한다. 그 외 고용형태는 null 이다.
- 직원 식별자는 회원별·매장별로 다른 가명 값이다. 다른 매장의 staff_id 와 대조해 동일인을 판별할 수 없다.
cURL
curl -sS "https://developer.openapi.giig.app/api/v1/stores//staff" \
-H "Authorization: Bearer $GIG_ACCESS_TOKEN"200 OK · application/json
{
"data": [
{
"staff_id": "",
"name": "김근무",
"employment_type": "full_time",
"joined_on": "2026-03-02",
"left_on": null,
"status": "active",
"weekly_contract_hours": null,
"position": "홀"
}
],
"next_cursor": null,
"has_more": false
}에러 · application/json
{
"error": {
"code": "store_not_found",
"message": "...",
"request_id": "req_01J8XQ4M2N7P"
}
}