해외 송금 일괄 보고 배치 목록 조회

해외 송금 일괄 보고 배치의 목록을 페이지네이션과 상태 필터로 조회합니다.

해외 송금 일괄 보고 배치 목록 조회 API는 GET 메소드로 호출되며, 상세 스펙 및 호출 예제는 아래와 같습니다.

요청메시지 URL

요청메시지 URL 표
HTTP URL	/api/oris/v1/batches
HTTP Method	GET

요청 메시지 명세

요청 메시지 명세
HTTP	항목	TYPE(길이)	필수	값	설명
Header	Authorization	string	Y	Bearer <access_token>	로그인 시 ORIS로부터 전송받은 access_token을 HTTP Header에 추가 [scope = inquiry]
Parameter	[inquery] page	integer(int32)	N	0	페이지 번호 (0부터 시작)
	[inquery] size	integer(int32)	N	10	페이지 크기 (1-100)
	[inquery] status	string	N	completed	배치 상태 필터
	[inquery] sort	string	N	createdAt,DESC	정렬 기준 (field,direction)

응답 메시지 명세

요청 메시지 명세
HTTP	항목	TYPE(길이)	필수	값	설명
Body	content[]	array<object>	Y	-	배치 목록
	content[].id	string	Y	01K0S9JDCA41ZTTTTQT380KR13	배치 ID
	content[].name	string	Y	remittance_20251007.csv	배치명
	content[].status	string	Y	completed	배치 상태
	content[].totalCount	integer(int64)	Y	200	총 건수
	content[].successCount	integer(int64)	Y	198	성공 건수
	content[].failureCount	integer(int64)	Y	2	실패 건수
	content[].createdAt	string	Y	2025-10-07T11:20:00Z	생성 일시
	content[].completedAt	string	N	2025-10-07T11:45:30Z	완료 일시
	content[].createdBy	object	Y	-	생성자 정보
	content[].createdBy.id	string	Y	u-102	생성자 ID
	content[].createdBy.name	string	Y	홍길동	생성자명
	content[].source	object	Y	-	소스 정보
	content[].source.type	string	Y	file	소스 타입
	content[].source.fileName	string	N	remittance_20251007.csv	파일명
	content[].source.fileSize	integer(int64)	N	582344	파일 크기
	content[].notes	string	N	-	비고
	page	object	Y	-	페이지 정보
	page.number	integer(int32)	Y	0	현재 페이지 번호 (0부터 시작)
	page.size	integer(int32)	Y	10	페이지 크기
	page.totalElements	integer(int64)	Y	345	총 항목 수
	page.totalPages	integer(int32)	Y	35	총 페이지 수
	page.sort	string	Y	createdAt,DESC	정렬 정보

응답 메시지 형태

{
  "content": [
    {
      "id": "01K0S9JDCA41ZTTTTQT380KR13",
      "name": "remittance_20251007.csv",
      "status": "completed",
      "totalCount": 200,
      "successCount": 198,
      "failureCount": 2,
      "createdAt": "2025-10-07T11:20:00Z",
      "completedAt": "2025-10-07T11:45:30Z",
      "createdBy": {
        "id": "u-102",
        "name": "홍길동"
      },
      "source": {
        "type": "file",
        "fileName": "remittance_20251007.csv",
        "fileSize": 582344
      },
      "notes": "string"
    }
  ],
  "page": {
    "number": 1073741824,
    "size": 10,
    "totalElements": 345,
    "totalPages": 35,
    "sort": "createdAt,DESC"
  }
}

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

요청 메시지 명세
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",
  "message": "Invalid argument"
}

인증 정보가 없는 경우 응답 메시지 형태(401)

{
  "code": "ACCESS_TOKEN_REQUIRED",
  "message": "Access token is required for authentication."
}

토큰 유효하지 않은 경우 (서명 검증 실패) 응답 메시지 형태(401)

{
  "code": "ACCESS_TOKEN_INVALID",
  "message"