첫만남 이용권·바우처 적용 대상 조회 API API

#바우처#첫만남#자격

업데이트 : 2026-05-12

출산 가구 대상 바우처·이용권 자격 요건 및 잔액 조회를 위한 연계 API입니다. 본인인증·동의 절차는 별도 연동 가이드를 따릅니다.

Endpoint

데모 버전	https://development.fitples.example/v1/welfare/preg-benefit-1
정식 버전	https://api.fitples.example/v1/welfare/preg-benefit-1

Timeout

300

입력부(Input)

Key	Name	Type	Required	Description
organization	기관코드	String	O	연계 기관 식별 코드 (목업: 0001)
apiKey	API Key	String	O	발급받은 Bearer 토큰 또는 쿼리 파라미터
regionCode	지역코드	String	△	시·도 또는 시·군·구 코드 (선택)
page	페이지	Number	△	페이지 번호 (기본 1)
size	페이지크기	Number	△	1회 조회 건수 (기본 20, 최대 100)

입력부

{
  "organization": "0001",
  "apiKey": "fp_test_****************",
  "regionCode": "11",
  "page": 1,
  "size": 20
}

입력부 특이사항

· 본 문서는 Fitples 카탈로그용 목업입니다. · 실제 인증·동의·암호화 방식은 정식 오픈 시 별도 가이드로 제공됩니다.

출력부(Output)

단건의 경우 객체형, 다건의 경우 리스트형으로 반환됩니다. (목업 예시)

Key	Name	Type	Required	Description
resultCode	결과코드	String	O	CF-0000 성공 기준 (목업)
data	응답 본문	Object	O	조회 결과 객체
res_preg-benefit-1_0	대상구분	String	O	[자격] 항목
res_preg-benefit-1_1	잔액	String	O	[자격] 항목
res_preg-benefit-1_2	유효기간	String	△	[자격] 항목
res_preg-benefit-1_3	사용처제한	String	△	[자격] 항목
res_preg-benefit-1_4	출산일	String	△	[가구] 항목
res_preg-benefit-1_5	주민번호앞자리(마스킹)	String	△	[가구] 항목
meta	메타	Object	O	요청 ID, 캐시 여부 등
requestId	요청 ID	String	O	추적용 UUID

출력부

{
  "resultCode": "CF-0000",
  "data": {
    "items": [
      {
        "id": "ROW-1",
        "label": "대상구분",
        "group": "자격",
        "value": "***"
      },
      {
        "id": "ROW-2",
        "label": "잔액",
        "group": "자격",
        "value": "***"
      },
      {
        "id": "ROW-3",
        "label": "유효기간",
        "group": "자격",
        "value": "***"
      },
      {
        "id": "ROW-4",
        "label": "사용처제한",
        "group": "자격",
        "value": "***"
      }
    ],
    "totalCount": 128
  },
  "meta": {
    "requestId": "req_mock_7c21",
    "cached": false
  }
}

출력부 특이사항

· 단건은 객체, 목록은 배열 형태로 반환되는 것을 가정한 예시입니다. · 필드명·타입은 실제 스키마와 다를 수 있습니다.