담당자 목록 조회 - ORIS API 문서

참가기관의 담당자 목록을 조회한다.

담당자 목록 조회 API는 GET 메소드로 호출되며, 상세 스펙 및 호출 예제는 아래와 같습니다.

요청메시지 URL

요청메시지 URL 표
HTTP URL	/api/oris/v1/agencies/{agencyId}/members
HTTP Method	GET

요청 메시지 명세

요청 메시지 명세
HTTP	항목	TYPE(길이)	필수	값	설명
Header	Authorization	string	Y	Bearer <access_token>	로그인 시 ORIS로부터 전송받은 access_token을 HTTP Header에 추가 [scope = inquiry]
Parameter	[inpath] agencyId	string(26)	Y	01JPPEG5B48T1JFNJ895GHJZRZ	참가기관ID
	[inquery] page	integer(int32)	N	0	페이지 번호[0~(전체 페이지 수-1)]
	[inquery] size	integer(int32)	N	10	페이지 크기[한 페이지에 조회되는 건수]

응답 메시지 명세

요청 메시지 명세
HTTP	항목	TYPE(길이)	필수	값	설명
Body	content[]	array<object>	Y	-	응답 데이터
	content[].id	string(26)	Y	01JR9GT44A2RPMWXTNEB56T0BP	참가기관 담당자 ID
	content[].name	string(100)	Y	윤조이	참가기관 담당자명
	content[].email	string(320)	Y	[email protected]	참가기관 담당자 이메일
	content[].phone	string(100)	Y	02-123-1234	참가기관 담당자 연락처
	content[].department	string(100)	Y	해외송금부서	참가기관 담당자 부서
	content[].group	object	Y	-	참가기관 담당자 권한그룹
	content[].group.id	string(26)	Y	01JPPEG5B48T1JFNJ895GHJZRZ	참가기관 담당자 권한 그룹ID
	content[].group.name	string(100)	Y	ADMIN	참가기관 담당자 권한 그룹명
	content[].description	string(1000)	N	개발 총괄	참가기관 담당자 메모
	content[].agency	object	Y	-	참가기관 담당자 참가기관
	content[].agency.agencyId	string(26)	Y	01JPPEG5B48T1JFNJ895GHJZRZ	참가기관ID
	content[].agency.agencyCode	string(4)	N	1004	참가기관코드
	content[].agency.agencyType	string("은행" \| "우정사업본부" \| "증권사" \| "카드사" \| "소액송금업체")	Y	은행	참가기관구분
	content[].agency.agencyConnectionType	string("직접" \| "간접")	Y	직접	참가기관연결방식
	content[].agency.agencyName	string(100)	Y	조이은행	참가기관명
	content[].status	string	Y	ACTIVE	참가기관 담당자 상태
	content[].createdBy	string<json>(1000)	Y		생성자
	content[].createdBy.name	string	Y	윤조이	-
	content[].createdBy.email	string	Y	[email protected]	-
	content[].createdAt	string(date-time)	Y	2025-06-30T18:02:56.303340+09:00	생성일시
	content[].modifiedAt	string(date-time)	Y	2025-06-30T18:02:56.303340+09:00	수정일시
	content[].modifiedBy	string<json>(1000)	Y		수정자
	content[].modifiedBy.name	string	Y	윤조이	-
	content[].modifiedBy.email	string	Y	[email protected]	-
	totalElements	integer(int64)	Y	4321	전체 데이터 수
	totalPages	integer(int32)	Y	433	전체 페이지 수
	currentPage	integer(int32)	Y	0	현재 페이지
	size	integer(int32)	Y	10	페이지 크기

응답 메시지 형태

{
  "content": [
    {
      "id": "01JR9GT44A2RPMWXTNEB56T0BP",
      "name": "윤조이",
      "email": "[email protected]",
      "phone": "02-123-1234",
      "department": "해외송금부서",
      "group": {
        "id": "01JPPEG5B48T1JFNJ895GHJZRZ",
        "name": "ADMIN"
      },
      "description": "개발 총괄",
      "agency": {
        "agencyId": "01JPPEG5B48T1JFNJ895GHJZRZ",
        "agencyCode": "1004",
        "agencyType": "은행",
        "agencyConnectionType": "직접",
        "agencyName": "조이은행"
      },
      "status": "ACTIVE",
      "createdBy": {
        "name": "윤조이",
        "email": "[email protected]"
      },
      "createdAt": "2025-06-30T18:02:56.303340+09:00",
      "modifiedAt": "2025-06-30T18:02:56.303340+09:00",
      "modifiedBy": {
        "name": "윤조이",
        "email": "[email protected]"
      }
    }
  ],
  "totalElements": 4321,
  "totalPages": 433,
  "currentPage": 1073741824,
  "size": 10
}

에러인 경우 응답 메시지 명세

요청 메시지 명세
HTTP	항목	TYPE(길이)	필수	값	설명
Body	message	string	N	요청에 실패했습니다.	오류 메시지
Body	code	string("ERROR" \| "BAD_REQUEST" \| "INVALID_REQUEST" \| "UNAUTHORIZED" \| "FORBIDDEN" \| "ACCESS_TOKEN_REQUIRED" \| "ACCESS_TOKEN_EXPIRED" \| "ACCESS_TOKEN_INVALID" \| "ACCESS_TOKEN_NOT_ENOUGH_PERMISSION" \| "AGENCY_NOT_FOUND" \| "AGENCY_NOT_ACTIVE" \| "AGENCY_NOT_APPROVED" \| "AGENCY_NOT_MATCH" \| "AGENCY_ACCESS_DENIED" \| "AGENCY_CODE_DUPLICATED" \| "MEMBER_NOT_FOUND" \| "MEMBER_NOT_ACTIVE" \| "MEMBER_NOT_MATCH" \| "MEMBER_PASSWORD_NOT_MATCH" \| "MEMBER_EMAIL_DUPLICATED" \| "MEMBER_PASSWORD_RESET" \| "MEMBER_PASSWORD_RESET_WITH_OLD" \| "MEMBER_PASSWORD_INVALID_FORMAT" \| "MEMBER_PASSWORD_FAIL_LIMIT_EXCEEDED" \| "MEMBER_PASSWORD_EXPIRED" \| "MEMBER_ACCOUNT_LOCKED" \| "MEMBER_PASSWORD_REUSED" \| "MEMBER_ACCESS_DENIED" \| "API_KEY_NOT_FOUND" \| "USER_NOT_FOUND" \| "USER_NOT_ACTIVE" \| "ACCOUNT_NOT_FOUND" \| "REMITTANCE_NOT_FOUND" \| "REMITTANCE_ALREADY_EXISTS" \| "REMITTANCE_ALREADY_CANCELED" \| "REMITTANCE_ACCOUNT_YEAR_MISMATCH" \| "THREAD_NOT_FOUND" \| "THREAD_ACCESS_DENIED" \| "POST_NOT_FOUND" \| "POST_ACCESS_DENIED" \| "COMMENT_NOT_FOUND" \| "COMMENT_ACCESS_DENIED" \| "FILE_NOT_FOUND" \| "FILE_ACCESS_DENIED" \| "FILE_ALREADY_ATTACHED" \| "FILE_DELETE_FAILED" \| "TERM_NOT_FOUND" \| "TERM_CANNOT_UPDATE" \| "TERM_CANNOT_DELETE" \| "TERM_CANNOT_SET_INITIATION_DATE" \| "TERM_CANNOT_WITHDRAW_INITIATION_DATE" \| "TERM_TYPE_NOT_FOUND" \| "CONSENT_REQUIRED" \| "CONSENT_NOT_FOUND" \| "CONSENT_NOT_MATCH" \| "GROUP_NOT_FOUND" \| "GROUP_UPDATE_FORBIDDEN" \| "GROUP_DELETE_FORBIDDEN" \| "BATCH_NOT_FOUND" \| "BATCH_CHUNK_NOT_FOUND")	N	ERROR	오류 코드

요청값이 제약 조건에 위반되는 경우 응답 메시지 형태(400)

{
  "code": "BAD_REQUEST",
  "message": "Failed to convert value of type 'java.lang.String' to required type 'java.lang.Boolean'"
}

메소드 인자 타입이 일치하지 않는 경우 응답 메시지 형태(400)

{
  "code": "BAD_REQUEST",
  "message": "Failed to convert value of type 'java.lang.String' to required type 'java.lang.Boolean'"
}

메소드 인자 검증 실패한 경우 응답 메시지 형태(400)

{
  "code": "BAD_REQUEST",
  "message": "Validation failed for argument at index 0 in method"
}

json 형식이 잘못된 경우 응답 메시지 형태(400)

{
  "code": "BAD_REQUEST",
  "message": "Malformed JSON request"
}

요청값이 잘못된 경우 응답 메시지 형태(400)

{
  "code": "BAD_REQUEST",