{
"code": "validation_error",
"message": "서버 내부 오류입니다",
"errors": [
{
"field": "event_type",
"message": "공백일 수 없습니다"
}
]
}
{
"code": "validation_error",
"message": "서버 내부 오류입니다",
"errors": [
{
"field": "event_type",
"message": "공백일 수 없습니다"
}
]
}
{
"code": "validation_error",
"message": "서버 내부 오류입니다",
"errors": [
{
"field": "event_type",
"message": "공백일 수 없습니다"
}
]
}
{
"code": "validation_error",
"message": "서버 내부 오류입니다",
"errors": [
{
"field": "event_type",
"message": "공백일 수 없습니다"
}
]
}
{
"code": "validation_error",
"message": "서버 내부 오류입니다",
"errors": [
{
"field": "event_type",
"message": "공백일 수 없습니다"
}
]
}
요금제
요금제 이력 조회
customer_id를 주면 그 고객의 요금제만, 생략하면 도입사 공통 요금제만 돌려준다. 고객 요금제는 customer_id로 따로 조회한다.
month를 주면 시작 월부터 종료 월 전까지에 그 달이 드는 버전만, 생략하면 기간과 상관없이 버전 이력을 돌려준다. 보관 여부는 month와 상관없이 status로 고른다. 시작 월 내림차순이다.
청구는 보관 효력(archived_from)까지 따져 버전을 고르므로, 그 달 청구에 쓰이는 요금제는 status=all 목록에서 시작 월이 가장 늦은 버전을 보고 고른다. 그 버전이 archived_from부터 멈췄으면 이전 버전으로 돌아가지 않는다.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"MeterEngine","description":"MeterEngine 도입사를 위한 연동 가이드와 API 참조","colors":{"primary":"#5746ad"},"api":{"playground":{"display":"interactive","proxy":true},"examples":{"languages":["bash","node"]}},"navbar":{"primary":{"type":"button","label":"콘솔 열기","href":"https://meterengine.com"}},"search":{"prompt":"가이드와 API 검색"},"seo":{"metatags":{"canonical":"https://docs.meterengine.com"}},"styling":{"latex":false},"navigation":{"languages":[{"language":"ko","default":true,"href":""}]}},"deployment":{"deploymentMetadataValue":{"subdomain":"meterengine","hasAudioNarration":false,"actualSubdomain":"meterengine","customDomains":[],"gitSource":{"type":"github","owner":"asm17-ms2","repo":"meterengine","deployBranch":"main","contentDirectory":"guide","isPrivate":false,"mountPath":"","label":"","_id":"6af407799a58d6755c1f99cb"},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6af41107e02ab65c314d17b4","clientVersion":"0.0.4102","searchFilterCounts":[{"language":"ko","tag":"API 참조","count":84},{"language":"ko","tag":"엔드포인트","count":83},{"language":"ko","tag":"가이드","count":44},{"language":"ko","tag":"검색과 내보내기","count":15},{"language":"ko","tag":"웹훅","count":13},{"language":"ko","tag":"결제 연동","count":9},{"language":"ko","tag":"미터","count":7},{"language":"ko","tag":"고객","count":7},{"language":"ko","tag":"가격 설계","count":6},{"language":"ko","tag":"이벤트","count":5}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":true,"hasWebMcpPermissions":true,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api-reference/price-plan-controller/요금제-이력-조회","slug":"/api-reference/price-plan-controller/요금제-이력-조회","pageMetadata":{"title":"요금제 이력 조회","description":"customer_id를 주면 그 고객의 요금제만, 생략하면 도입사 공통 요금제만 돌려준다. 고객 요금제는 customer_id로 따로 조회한다.\nmonth를 주면 시작 월부터 종료 월 전까지에 그 달이 드는 버전만, 생략하면 기간과 상관없이 버전 이력을 돌려준다. 보관 여부는 month와 상관없이 status로 고른다. 시작 월 내림차순이다.\n청구는 보관 효력(archived_from)까지 따져 버전을 고르므로, 그 달 청구에 쓰이는 요금제는 status=all 목록에서 시작 월이 가장 늦은 버전을 보고 고른다. 그 버전이 archived_from부터 멈췄으면 이전 버전으로 돌아가지 않는다.\n","deprecated":null,"version":null,"openapi":"https://raw.githubusercontent.com/asm17-ms2/meterengine/main/backend/openapi.yaml get /v1/price-plans","href":"/api-reference/price-plan-controller/요금제-이력-조회","autogeneratedByOpenApi":true},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"customer_id를 주면 그 고객의 요금제만, 생략하면 도입사 공통 요금제만 돌려준다. 고객 요금제는 customer_id로 따로 조회한다.\\nmonth를 주면 시작 월부터 종료 월 전까지에 그 달이 드는 버전만, 생략하면 기간과 상관없이 버전 이력을 돌려준다. 보관 여부는 month와 상관없이 status로 고른다. 시작 월 내림차순이다.\\n청구는 보관 효력(archived_from)까지 따져 버전을 고르므로, 그 달 청구에 쓰이는 요금제는 status=all 목록에서 시작 월이 가장 늦은 버전을 보고 고른다. 그 버전이 archived_from부터 멈췄으면 이전 버전으로 돌아가지 않는다.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"요금제 이력 조회","description":"customer_id를 주면 그 고객의 요금제만, 생략하면 도입사 공통 요금제만 돌려준다. 고객 요금제는 customer_id로 따로 조회한다.\nmonth를 주면 시작 월부터 종료 월 전까지에 그 달이 드는 버전만, 생략하면 기간과 상관없이 버전 이력을 돌려준다. 보관 여부는 month와 상관없이 status로 고른다. 시작 월 내림차순이다.\n청구는 보관 효력(archived_from)까지 따져 버전을 고르므로, 그 달 청구에 쓰이는 요금제는 status=all 목록에서 시작 월이 가장 늦은 버전을 보고 고른다. 그 버전이 archived_from부터 멈췄으면 이전 버전으로 돌아가지 않는다.\n","deprecated":null,"version":null,"openapi":"https://raw.githubusercontent.com/asm17-ms2/meterengine/main/backend/openapi.yaml get /v1/price-plans","href":"/api-reference/price-plan-controller/요금제-이력-조회","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"description":"customer_id를 주면 그 고객의 요금제만, 생략하면 도입사 공통 요금제만 돌려준다. 고객 요금제는 customer_id로 따로 조회한다.\nmonth를 주면 시작 월부터 종료 월 전까지에 그 달이 드는 버전만, 생략하면 기간과 상관없이 버전 이력을 돌려준다. 보관 여부는 month와 상관없이 status로 고른다. 시작 월 내림차순이다.\n청구는 보관 효력(archived_from)까지 따져 버전을 고르므로, 그 달 청구에 쓰이는 요금제는 status=all 목록에서 시작 월이 가장 늦은 버전을 보고 고른다. 그 버전이 archived_from부터 멈췄으면 이전 버전으로 돌아가지 않는다.\n","operationId":"listPricePlans","parameters":["abc257c3-438b-4d8a-87ad-805a8a385a5b","52721686-32be-4950-b116-e612d42403f1","afe0bb23-1f51-403a-876f-213679a4c167"],"responses":{"200":"7e35ecee-e45f-45d6-9b2a-afc8ee3a86d9","400":"7d225903-6aa7-42bc-bc4e-482c765b7336","401":"6ab96ec0-e543-4567-95a7-5547c431dd9c","403":"4f8af720-993d-4fb3-8b47-67954d869dd3","404":"1562fe44-bea9-447c-bb1f-8b45ce544829","429":"2e0904dc-bd9a-4b74-a052-62b689bf387d"},"summary":"요금제 이력 조회","tags":["price-plan-controller"],"method":"get","type":"path","servers":["0cef6632-74ea-4650-a4d5-583aade483b9"],"security":["3fd7dd2d-a237-4414-93a2-e2f7671b6e98"],"path":"/v1/price-plans","baseUrlOptions":["https://meterengine.com"],"title":"요금제 이력 조회","codeSamples":[],"requestExampleLanguages":["bash","node"],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"abc257c3-438b-4d8a-87ad-805a8a385a5b":{"description":"이 달(yyyy-MM, KST)이 시작 월부터 종료 월 전까지에 드는 버전만 고른다. 보관 여부는 이 값과 상관없이 status로 고른다. 생략하면 기간으로 거르지 않는다.","example":"2026-08","in":"query","name":"month","required":false,"schema":{"type":"string","isRequired":false,"description":"이 달(yyyy-MM, KST)이 시작 월부터 종료 월 전까지에 드는 버전만 고른다. 보관 여부는 이 값과 상관없이 status로 고른다. 생략하면 기간으로 거르지 않는다.","uniqueKey":"","typeLabel":"string"}},"52721686-32be-4950-b116-e612d42403f1":{"description":"이 고객의 요금제만 고른다. 생략하면 도입사 공통 요금제만 나온다.","in":"query","name":"customer_id","required":false,"schema":{"type":"string","format":"uuid","isRequired":false,"description":"이 고객의 요금제만 고른다. 생략하면 도입사 공통 요금제만 나온다.","uniqueKey":"","typeLabel":"string\u003cuuid>"}},"afe0bb23-1f51-403a-876f-213679a4c167":{"description":"보관 상태로 고른다. 생략하면 active로 보관하지 않은 버전만 나온다. archived는 보관한 버전, all은 둘 다다.","in":"query","name":"status","required":false,"schema":{"type":"string","default":"active","enum":["active","archived","all"],"isRequired":false,"description":"보관 상태로 고른다. 생략하면 active로 보관하지 않은 버전만 나온다. archived는 보관한 버전, all은 둘 다다.","uniqueKey":"","typeLabel":"enum\u003cstring>"}}},"responses":{"7e35ecee-e45f-45d6-9b2a-afc8ee3a86d9":{"content":{"*/*":{"schema":{"type":"object","properties":{"price_plans":{"type":"array","items":{"type":"object","properties":{"archived_at":{"type":"string","format":"date-time","uniqueKey":"price_plans.items.[INDEX].archived_at","typeLabel":"string\u003cdate-time>"},"archived_from":{"type":"string","uniqueKey":"price_plans.items.[INDEX].archived_from","typeLabel":"string"},"base_fee":{"type":"integer","format":"int64","uniqueKey":"price_plans.items.[INDEX].base_fee","typeLabel":"integer\u003cint64>"},"customer_id":{"type":"string","format":"uuid","uniqueKey":"price_plans.items.[INDEX].customer_id","typeLabel":"string\u003cuuid>"},"effective_from":{"type":"string","uniqueKey":"price_plans.items.[INDEX].effective_from","typeLabel":"string"},"effective_until":{"type":"string","uniqueKey":"price_plans.items.[INDEX].effective_until","typeLabel":"string"},"id":{"type":"string","format":"uuid","uniqueKey":"price_plans.items.[INDEX].id","typeLabel":"string\u003cuuid>"},"minimum_amount":{"type":"integer","format":"int64","uniqueKey":"price_plans.items.[INDEX].minimum_amount","typeLabel":"integer\u003cint64>"}},"uniqueKey":"price_plans.items.[INDEX]","typeLabel":"object"},"uniqueKey":"price_plans","typeLabel":"object[]"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"price_plans":[{"archived_at":"2023-11-07T05:31:56Z","archived_from":"\u003cstring>","base_fee":123,"customer_id":"3c90c3cc-0d44-4b50-8888-8dd25736052a","effective_from":"\u003cstring>","effective_until":"\u003cstring>","id":"3c90c3cc-0d44-4b50-8888-8dd25736052a","minimum_amount":123}]}}},"exampleType":"generated"}},"description":"요금제 버전 목록. 조건에 맞는 것이 없으면 price_plans가 빈 배열이다","exampleType":"generated"},"7d225903-6aa7-42bc-bc4e-482c765b7336":{"content":{"application/json":{"schema":{"type":"object","description":"오류 응답. code로 오류 종류를 구분하고, message는 code마다 하나인 한국어 문구다.","properties":{"code":{"type":"string","description":"오류 종류. 오류별 처리는 이 값으로 분기한다.","enum":["validation_error","malformed_request_body","invalid_billable_metric","invalid_price_rate","event_too_old","invalid_toss_payments_credential","payment_method_rejected","toss_payments_test_code_in_live_mode","invalid_webhook_url","invalid_webhook_event_type","authentication_required","invalid_credentials","permission_denied","organization_not_active","environment_mismatch","consent_required","customer_not_found","event_not_found","billable_metric_not_found","price_rate_not_found","invoice_not_found","invoice_view_link_not_found","endpoint_not_found","api_key_not_found","organization_not_found","user_account_not_found","payment_method_not_found","payment_method_registration_not_found","payment_attempt_not_found","toss_payments_credential_not_found","price_plan_not_found","webhook_endpoint_not_found","webhook_delivery_not_found","invitation_not_found","method_not_allowed","response_type_not_acceptable","resource_version_conflict","idempotency_conflict","customer_archived","resource_archived","environment_not_ready","archive_restoration_conflict","customer_has_events","customer_has_payment_attempts","billable_metric_has_events","billable_metric_has_price_rate","billable_metric_already_exists","billable_metric_event_type_target_property_already_exists","invoice_already_paid","payment_result_unconfirmed","payment_retry_unavailable","payment_retry_stale","invoice_amount_zero","email_already_exists","organization_status_transition_invalid","organization_member_already_exists","toss_payments_credential_missing","payment_method_missing","payment_mode_mismatch","payment_attempt_not_cancelable","payment_attempt_fully_canceled","payment_cancellation_amount_exceeded","payment_cancellation_in_progress","payment_cancellation_idempotency_conflict","webhook_delivery_not_retryable","price_rate_history_immutable","price_plan_history_immutable","webhook_endpoint_disabled","webhook_endpoint_limit_exceeded","invitation_unavailable","last_owner_required","owner_scopes_required","last_operator_required","api_key_unavailable","upload_size_exceeded","request_type_not_supported","rate_limit_exceeded","internal_server_error","request_timed_out","toss_payments_unavailable"],"isRequired":true,"uniqueKey":"code","typeLabel":"enum\u003cstring>"},"message":{"type":"string","description":"code마다 하나인 한국어 문구. 예고 없이 바뀔 수 있으니 분기에 쓰지 않는다.","example":"서버 내부 오류입니다","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"errors":{"type":"array","description":"틀린 필드 목록. 400 응답에만 실린다.","items":{"type":"object","description":"틀린 필드 하나","properties":{"field":{"type":"string","description":"틀린 값을 보낸 자리의 이름. 요청에 쓴 이름과 같다.","example":"event_type","uniqueKey":"errors.items.[INDEX].field","typeLabel":"string"},"message":{"type":"string","description":"이 자리의 값이 거절된 이유.","example":"공백일 수 없습니다","uniqueKey":"errors.items.[INDEX].message","typeLabel":"string"}},"uniqueKey":"errors.items.[INDEX]","typeLabel":"object"},"uniqueKey":"errors","typeLabel":"object[]"}},"required":["code","message"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"code":"validation_error","message":"서버 내부 오류입니다","errors":[{"field":"event_type","message":"공백일 수 없습니다"}]}}},"exampleType":"generated"}},"description":"code=validation_error: customer_id가 UUID가 아니거나, month가 yyyy-MM이 아니거나 0001-01부터 9999-12까지의 범위 밖이거나, status가 active, archived, all 중 하나가 아니다","exampleType":"generated"},"6ab96ec0-e543-4567-95a7-5547c431dd9c":{"content":{"application/json":{"schema":{"type":"object","description":"오류 응답. code로 오류 종류를 구분하고, message는 code마다 하나인 한국어 문구다.","properties":{"code":{"type":"string","description":"오류 종류. 오류별 처리는 이 값으로 분기한다.","enum":["validation_error","malformed_request_body","invalid_billable_metric","invalid_price_rate","event_too_old","invalid_toss_payments_credential","payment_method_rejected","toss_payments_test_code_in_live_mode","invalid_webhook_url","invalid_webhook_event_type","authentication_required","invalid_credentials","permission_denied","organization_not_active","environment_mismatch","consent_required","customer_not_found","event_not_found","billable_metric_not_found","price_rate_not_found","invoice_not_found","invoice_view_link_not_found","endpoint_not_found","api_key_not_found","organization_not_found","user_account_not_found","payment_method_not_found","payment_method_registration_not_found","payment_attempt_not_found","toss_payments_credential_not_found","price_plan_not_found","webhook_endpoint_not_found","webhook_delivery_not_found","invitation_not_found","method_not_allowed","response_type_not_acceptable","resource_version_conflict","idempotency_conflict","customer_archived","resource_archived","environment_not_ready","archive_restoration_conflict","customer_has_events","customer_has_payment_attempts","billable_metric_has_events","billable_metric_has_price_rate","billable_metric_already_exists","billable_metric_event_type_target_property_already_exists","invoice_already_paid","payment_result_unconfirmed","payment_retry_unavailable","payment_retry_stale","invoice_amount_zero","email_already_exists","organization_status_transition_invalid","organization_member_already_exists","toss_payments_credential_missing","payment_method_missing","payment_mode_mismatch","payment_attempt_not_cancelable","payment_attempt_fully_canceled","payment_cancellation_amount_exceeded","payment_cancellation_in_progress","payment_cancellation_idempotency_conflict","webhook_delivery_not_retryable","price_rate_history_immutable","price_plan_history_immutable","webhook_endpoint_disabled","webhook_endpoint_limit_exceeded","invitation_unavailable","last_owner_required","owner_scopes_required","last_operator_required","api_key_unavailable","upload_size_exceeded","request_type_not_supported","rate_limit_exceeded","internal_server_error","request_timed_out","toss_payments_unavailable"],"isRequired":true,"uniqueKey":"code","typeLabel":"enum\u003cstring>"},"message":{"type":"string","description":"code마다 하나인 한국어 문구. 예고 없이 바뀔 수 있으니 분기에 쓰지 않는다.","example":"서버 내부 오류입니다","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"errors":{"type":"array","description":"틀린 필드 목록. 400 응답에만 실린다.","items":{"type":"object","description":"틀린 필드 하나","properties":{"field":{"type":"string","description":"틀린 값을 보낸 자리의 이름. 요청에 쓴 이름과 같다.","example":"event_type","uniqueKey":"errors.items.[INDEX].field","typeLabel":"string"},"message":{"type":"string","description":"이 자리의 값이 거절된 이유.","example":"공백일 수 없습니다","uniqueKey":"errors.items.[INDEX].message","typeLabel":"string"}},"uniqueKey":"errors.items.[INDEX]","typeLabel":"object"},"uniqueKey":"errors","typeLabel":"object[]"}},"required":["code","message"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"code":"validation_error","message":"서버 내부 오류입니다","errors":[{"field":"event_type","message":"공백일 수 없습니다"}]}}},"exampleType":"generated"}},"description":"code=authentication_required: Authorization 헤더가 없다.\ncode=invalid_credentials: 키나 토큰의 형식이 틀렸거나, 모르는 값이거나, 폐기 또는 만료됐다.\n","exampleType":"generated"},"4f8af720-993d-4fb3-8b47-67954d869dd3":{"content":{"application/json":{"schema":{"type":"object","description":"오류 응답. code로 오류 종류를 구분하고, message는 code마다 하나인 한국어 문구다.","properties":{"code":{"type":"string","description":"오류 종류. 오류별 처리는 이 값으로 분기한다.","enum":["validation_error","malformed_request_body","invalid_billable_metric","invalid_price_rate","event_too_old","invalid_toss_payments_credential","payment_method_rejected","toss_payments_test_code_in_live_mode","invalid_webhook_url","invalid_webhook_event_type","authentication_required","invalid_credentials","permission_denied","organization_not_active","environment_mismatch","consent_required","customer_not_found","event_not_found","billable_metric_not_found","price_rate_not_found","invoice_not_found","invoice_view_link_not_found","endpoint_not_found","api_key_not_found","organization_not_found","user_account_not_found","payment_method_not_found","payment_method_registration_not_found","payment_attempt_not_found","toss_payments_credential_not_found","price_plan_not_found","webhook_endpoint_not_found","webhook_delivery_not_found","invitation_not_found","method_not_allowed","response_type_not_acceptable","resource_version_conflict","idempotency_conflict","customer_archived","resource_archived","environment_not_ready","archive_restoration_conflict","customer_has_events","customer_has_payment_attempts","billable_metric_has_events","billable_metric_has_price_rate","billable_metric_already_exists","billable_metric_event_type_target_property_already_exists","invoice_already_paid","payment_result_unconfirmed","payment_retry_unavailable","payment_retry_stale","invoice_amount_zero","email_already_exists","organization_status_transition_invalid","organization_member_already_exists","toss_payments_credential_missing","payment_method_missing","payment_mode_mismatch","payment_attempt_not_cancelable","payment_attempt_fully_canceled","payment_cancellation_amount_exceeded","payment_cancellation_in_progress","payment_cancellation_idempotency_conflict","webhook_delivery_not_retryable","price_rate_history_immutable","price_plan_history_immutable","webhook_endpoint_disabled","webhook_endpoint_limit_exceeded","invitation_unavailable","last_owner_required","owner_scopes_required","last_operator_required","api_key_unavailable","upload_size_exceeded","request_type_not_supported","rate_limit_exceeded","internal_server_error","request_timed_out","toss_payments_unavailable"],"isRequired":true,"uniqueKey":"code","typeLabel":"enum\u003cstring>"},"message":{"type":"string","description":"code마다 하나인 한국어 문구. 예고 없이 바뀔 수 있으니 분기에 쓰지 않는다.","example":"서버 내부 오류입니다","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"errors":{"type":"array","description":"틀린 필드 목록. 400 응답에만 실린다.","items":{"type":"object","description":"틀린 필드 하나","properties":{"field":{"type":"string","description":"틀린 값을 보낸 자리의 이름. 요청에 쓴 이름과 같다.","example":"event_type","uniqueKey":"errors.items.[INDEX].field","typeLabel":"string"},"message":{"type":"string","description":"이 자리의 값이 거절된 이유.","example":"공백일 수 없습니다","uniqueKey":"errors.items.[INDEX].message","typeLabel":"string"}},"uniqueKey":"errors.items.[INDEX]","typeLabel":"object"},"uniqueKey":"errors","typeLabel":"object[]"}},"required":["code","message"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"code":"validation_error","message":"서버 내부 오류입니다","errors":[{"field":"event_type","message":"공백일 수 없습니다"}]}}},"exampleType":"generated"}},"description":"code=permission_denied: 키의 스코프나 계정의 역할로는 할 수 없는 요청이거나, 도입사가 정해지지 않은 로그인 세션이다.\ncode=organization_not_active: 도입사가 활성 상태가 아니다.\ncode=consent_required: 로그인 세션의 사용자가 필수 안내에 아직 동의하지 않았다. POST /v1/sessions/current/consents로 동의한다.\n","exampleType":"generated"},"1562fe44-bea9-447c-bb1f-8b45ce544829":{"content":{"application/json":{"schema":{"type":"object","description":"오류 응답. code로 오류 종류를 구분하고, message는 code마다 하나인 한국어 문구다.","properties":{"code":{"type":"string","description":"오류 종류. 오류별 처리는 이 값으로 분기한다.","enum":["validation_error","malformed_request_body","invalid_billable_metric","invalid_price_rate","event_too_old","invalid_toss_payments_credential","payment_method_rejected","toss_payments_test_code_in_live_mode","invalid_webhook_url","invalid_webhook_event_type","authentication_required","invalid_credentials","permission_denied","organization_not_active","environment_mismatch","consent_required","customer_not_found","event_not_found","billable_metric_not_found","price_rate_not_found","invoice_not_found","invoice_view_link_not_found","endpoint_not_found","api_key_not_found","organization_not_found","user_account_not_found","payment_method_not_found","payment_method_registration_not_found","payment_attempt_not_found","toss_payments_credential_not_found","price_plan_not_found","webhook_endpoint_not_found","webhook_delivery_not_found","invitation_not_found","method_not_allowed","response_type_not_acceptable","resource_version_conflict","idempotency_conflict","customer_archived","resource_archived","environment_not_ready","archive_restoration_conflict","customer_has_events","customer_has_payment_attempts","billable_metric_has_events","billable_metric_has_price_rate","billable_metric_already_exists","billable_metric_event_type_target_property_already_exists","invoice_already_paid","payment_result_unconfirmed","payment_retry_unavailable","payment_retry_stale","invoice_amount_zero","email_already_exists","organization_status_transition_invalid","organization_member_already_exists","toss_payments_credential_missing","payment_method_missing","payment_mode_mismatch","payment_attempt_not_cancelable","payment_attempt_fully_canceled","payment_cancellation_amount_exceeded","payment_cancellation_in_progress","payment_cancellation_idempotency_conflict","webhook_delivery_not_retryable","price_rate_history_immutable","price_plan_history_immutable","webhook_endpoint_disabled","webhook_endpoint_limit_exceeded","invitation_unavailable","last_owner_required","owner_scopes_required","last_operator_required","api_key_unavailable","upload_size_exceeded","request_type_not_supported","rate_limit_exceeded","internal_server_error","request_timed_out","toss_payments_unavailable"],"isRequired":true,"uniqueKey":"code","typeLabel":"enum\u003cstring>"},"message":{"type":"string","description":"code마다 하나인 한국어 문구. 예고 없이 바뀔 수 있으니 분기에 쓰지 않는다.","example":"서버 내부 오류입니다","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"errors":{"type":"array","description":"틀린 필드 목록. 400 응답에만 실린다.","items":{"type":"object","description":"틀린 필드 하나","properties":{"field":{"type":"string","description":"틀린 값을 보낸 자리의 이름. 요청에 쓴 이름과 같다.","example":"event_type","uniqueKey":"errors.items.[INDEX].field","typeLabel":"string"},"message":{"type":"string","description":"이 자리의 값이 거절된 이유.","example":"공백일 수 없습니다","uniqueKey":"errors.items.[INDEX].message","typeLabel":"string"}},"uniqueKey":"errors.items.[INDEX]","typeLabel":"object"},"uniqueKey":"errors","typeLabel":"object[]"}},"required":["code","message"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"code":"validation_error","message":"서버 내부 오류입니다","errors":[{"field":"event_type","message":"공백일 수 없습니다"}]}}},"exampleType":"generated"}},"description":"code=customer_not_found: customer_id가 가리키는 고객이 이 도입사에 없다","exampleType":"generated"},"2e0904dc-bd9a-4b74-a052-62b689bf387d":{"content":{"application/json":{"schema":{"type":"object","description":"오류 응답. code로 오류 종류를 구분하고, message는 code마다 하나인 한국어 문구다.","properties":{"code":{"type":"string","description":"오류 종류. 오류별 처리는 이 값으로 분기한다.","enum":["validation_error","malformed_request_body","invalid_billable_metric","invalid_price_rate","event_too_old","invalid_toss_payments_credential","payment_method_rejected","toss_payments_test_code_in_live_mode","invalid_webhook_url","invalid_webhook_event_type","authentication_required","invalid_credentials","permission_denied","organization_not_active","environment_mismatch","consent_required","customer_not_found","event_not_found","billable_metric_not_found","price_rate_not_found","invoice_not_found","invoice_view_link_not_found","endpoint_not_found","api_key_not_found","organization_not_found","user_account_not_found","payment_method_not_found","payment_method_registration_not_found","payment_attempt_not_found","toss_payments_credential_not_found","price_plan_not_found","webhook_endpoint_not_found","webhook_delivery_not_found","invitation_not_found","method_not_allowed","response_type_not_acceptable","resource_version_conflict","idempotency_conflict","customer_archived","resource_archived","environment_not_ready","archive_restoration_conflict","customer_has_events","customer_has_payment_attempts","billable_metric_has_events","billable_metric_has_price_rate","billable_metric_already_exists","billable_metric_event_type_target_property_already_exists","invoice_already_paid","payment_result_unconfirmed","payment_retry_unavailable","payment_retry_stale","invoice_amount_zero","email_already_exists","organization_status_transition_invalid","organization_member_already_exists","toss_payments_credential_missing","payment_method_missing","payment_mode_mismatch","payment_attempt_not_cancelable","payment_attempt_fully_canceled","payment_cancellation_amount_exceeded","payment_cancellation_in_progress","payment_cancellation_idempotency_conflict","webhook_delivery_not_retryable","price_rate_history_immutable","price_plan_history_immutable","webhook_endpoint_disabled","webhook_endpoint_limit_exceeded","invitation_unavailable","last_owner_required","owner_scopes_required","last_operator_required","api_key_unavailable","upload_size_exceeded","request_type_not_supported","rate_limit_exceeded","internal_server_error","request_timed_out","toss_payments_unavailable"],"isRequired":true,"uniqueKey":"code","typeLabel":"enum\u003cstring>"},"message":{"type":"string","description":"code마다 하나인 한국어 문구. 예고 없이 바뀔 수 있으니 분기에 쓰지 않는다.","example":"서버 내부 오류입니다","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"errors":{"type":"array","description":"틀린 필드 목록. 400 응답에만 실린다.","items":{"type":"object","description":"틀린 필드 하나","properties":{"field":{"type":"string","description":"틀린 값을 보낸 자리의 이름. 요청에 쓴 이름과 같다.","example":"event_type","uniqueKey":"errors.items.[INDEX].field","typeLabel":"string"},"message":{"type":"string","description":"이 자리의 값이 거절된 이유.","example":"공백일 수 없습니다","uniqueKey":"errors.items.[INDEX].message","typeLabel":"string"}},"uniqueKey":"errors.items.[INDEX]","typeLabel":"object"},"uniqueKey":"errors","typeLabel":"object[]"}},"required":["code","message"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"code":"validation_error","message":"서버 내부 오류입니다","errors":[{"field":"event_type","message":"공백일 수 없습니다"}]}}},"exampleType":"generated"}},"description":"code=rate_limit_exceeded: 키의 분당 요청 한도를 넘었다. Retry-After 헤더의 초만큼 기다린 뒤 다시 보낸다.","headers":{"Retry-After":{"description":"다시 보내기 전에 기다릴 초","required":true,"schema":{"type":"integer","format":"int32"}}},"exampleType":"generated"}},"security":{"3fd7dd2d-a237-4414-93a2-e2f7671b6e98":{"bearerAuth":{"scheme":"bearer","type":"http","scopes":[],"schemeName":"bearerAuth"}}},"servers":{"0cef6632-74ea-4650-a4d5-583aade483b9":{"description":"MeterEngine API","url":"https://meterengine.com"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"scheme":"bearer","type":"http","scopes":[],"schemeName":"bearerAuth"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"Bearer authentication header of the form `Bearer \u003ctoken>`, where `\u003ctoken>` is your auth token.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"bearerAuth","name":"Authorization"}],"title":"bearerAuth"}]},"originalFileLocation":"https://raw.githubusercontent.com/asm17-ms2/meterengine/main/backend/openapi.yaml"},"subdomain":"meterengine","siteName":"MeterEngine","title":"요금제 이력 조회 - MeterEngine","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{"ko":{"href":"/api-reference/price-plan-controller/요금제-이력-조회","matchLevel":0}}},"lastModified":"2026-11-11T06:13:35.277Z","originalFileLocation":"api-reference/price-plan-controller/요금제-이력-조회.mdx","locale":"ko"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"customer_id를 주면 그 고객의 요금제만, 생략하면 도입사 공통 요금제만 돌려준다. 고객 요금제는 customer_id로 따로 조회한다. month를 주면 시작 월부터 종료 월 전까지에 그 달이 드는 버전만, 생략하면 기간과 상관없이 버전 이력을 돌려준다. 보관 여부는 month와 상관없이 status로 고른다. 시작 월 내림차순이다. 청구는 보관 효력(archived_from)까지 따져 버전을 고르므로, 그 달 청구에 쓰이는 요금제는 status=all 목록에서 시작 월이 가장 늦은 버전을 보고 고른다. 그 버전이 archived_from부터 멈췄으면 이전 버전으로 돌아가지 않는다.\">\u003cmeta data-mint-head name=\"application-name\" content=\"MeterEngine\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"https://mintlify.s3.us-west-1.amazonaws.com/meterengine/_generated/favicon/apple-touch-icon.png?v=3\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"https://mintlify.s3.us-west-1.amazonaws.com/meterengine/_generated/favicon/favicon-32x32.png?v=3\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"https://mintlify.s3.us-west-1.amazonaws.com/meterengine/_generated/favicon/favicon-16x16.png?v=3\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"https://mintlify.s3.us-west-1.amazonaws.com/meterengine/_generated/favicon/favicon.ico?v=3\">\u003cmeta data-mint-head property=\"og:title\" content=\"요금제 이력 조회 - MeterEngine\">\u003cmeta data-mint-head property=\"og:description\" content=\"customer_id를 주면 그 고객의 요금제만, 생략하면 도입사 공통 요금제만 돌려준다. 고객 요금제는 customer_id로 따로 조회한다. month를 주면 시작 월부터 종료 월 전까지에 그 달이 드는 버전만, 생략하면 기간과 상관없이 버전 이력을 돌려준다. 보관 여부는 month와 상관없이 status로 고른다. 시작 월 내림차순이다. 청구는 보관 효력(archived_from)까지 따져 버전을 고르므로, 그 달 청구에 쓰이는 요금제는 status=all 목록에서 시작 월이 가장 늦은 버전을 보고 고른다. 그 버전이 archived_from부터 멈췄으면 이전 버전으로 돌아가지 않는다.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"MeterEngine\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.meterengine.com/api-reference/price-plan-controller/요금제-이력-조회\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://meterengine.mintlify.site/_mintlify/api/og/v2?division=%EC%9A%94%EA%B8%88%EC%A0%9C\u0026amp;title=%EC%9A%94%EA%B8%88%EC%A0%9C+%EC%9D%B4%EB%A0%A5+%EC%A1%B0%ED%9A%8C\u0026amp;description=customer_id%EB%A5%BC+%EC%A3%BC%EB%A9%B4+%EA%B7%B8+%EA%B3%A0%EA%B0%9D%EC%9D%98+%EC%9A%94%EA%B8%88%EC%A0%9C%EB%A7%8C%2C+%EC%83%9D%EB%9E%B5%ED%95%98%EB%A9%B4+%EB%8F%84%EC%9E%85%EC%82%AC+%EA%B3%B5%ED%86%B5+%EC%9A%94%EA%B8%88%EC%A0%9C%EB%A7%8C+%EB%8F%8C%EB%A0%A4%EC%A4%80%EB%8B%A4.+%EA%B3%A0%EA%B0%9D+%EC%9A%94%EA%B8%88%EC%A0%9C%EB%8A%94+customer_id%EB%A1%9C+%EB%94%B0%EB%A1%9C+%EC%A1%B0%ED%9A%8C%ED%95%9C%EB%8B%A4.%0Amonth%EB%A5%BC+%EC%A3%BC%EB%A9%B4+%EC%8B%9C%EC%9E%91+%EC%9B%94%EB%B6%80%ED%84%B0+%EC%A2%85%EB%A3%8C+%EC%9B%94+%EC%A0%84%EA%B9%8C%EC%A7%80%EC%97%90+%EA%B7%B8+%EB%8B%AC%EC%9D%B4+%EB%93%9C%EB%8A%94+%EB%B2%84%EC%A0%84%EB%A7%8C%2C+%EC%83%9D%EB%9E%B5%ED%95%98%EB%A9%B4+%EA%B8%B0%EA%B0%84%EA%B3%BC+%EC%83%81%EA%B4%80%EC%97%86%EC%9D%B4+%EB%B2%84%EC%A0%84+%EC%9D%B4%EB%A0%A5%EC%9D%84+%EB%8F%8C%EB%A0%A4%EC%A4%80%EB%8B%A4.+%EB%B3%B4%EA%B4%80+%EC%97%AC%EB%B6%80%EB%8A%94+month\u0026amp;theme=23a62b0b000949226daf3b66\u0026amp;signature=1b5c606c1d2047ec855c857cbec1894cd28b3a4c7cbafd9a09e6cf61a95ea6c9\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"요금제 이력 조회 - MeterEngine\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"customer_id를 주면 그 고객의 요금제만, 생략하면 도입사 공통 요금제만 돌려준다. 고객 요금제는 customer_id로 따로 조회한다. month를 주면 시작 월부터 종료 월 전까지에 그 달이 드는 버전만, 생략하면 기간과 상관없이 버전 이력을 돌려준다. 보관 여부는 month와 상관없이 status로 고른다. 시작 월 내림차순이다. 청구는 보관 효력(archived_from)까지 따져 버전을 고르므로, 그 달 청구에 쓰이는 요금제는 status=all 목록에서 시작 월이 가장 늦은 버전을 보고 고른다. 그 버전이 archived_from부터 멈췄으면 이전 버전으로 돌아가지 않는다.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://meterengine.mintlify.site/_mintlify/api/og/v2?division=%EC%9A%94%EA%B8%88%EC%A0%9C\u0026amp;title=%EC%9A%94%EA%B8%88%EC%A0%9C+%EC%9D%B4%EB%A0%A5+%EC%A1%B0%ED%9A%8C\u0026amp;description=customer_id%EB%A5%BC+%EC%A3%BC%EB%A9%B4+%EA%B7%B8+%EA%B3%A0%EA%B0%9D%EC%9D%98+%EC%9A%94%EA%B8%88%EC%A0%9C%EB%A7%8C%2C+%EC%83%9D%EB%9E%B5%ED%95%98%EB%A9%B4+%EB%8F%84%EC%9E%85%EC%82%AC+%EA%B3%B5%ED%86%B5+%EC%9A%94%EA%B8%88%EC%A0%9C%EB%A7%8C+%EB%8F%8C%EB%A0%A4%EC%A4%80%EB%8B%A4.+%EA%B3%A0%EA%B0%9D+%EC%9A%94%EA%B8%88%EC%A0%9C%EB%8A%94+customer_id%EB%A1%9C+%EB%94%B0%EB%A1%9C+%EC%A1%B0%ED%9A%8C%ED%95%9C%EB%8B%A4.%0Amonth%EB%A5%BC+%EC%A3%BC%EB%A9%B4+%EC%8B%9C%EC%9E%91+%EC%9B%94%EB%B6%80%ED%84%B0+%EC%A2%85%EB%A3%8C+%EC%9B%94+%EC%A0%84%EA%B9%8C%EC%A7%80%EC%97%90+%EA%B7%B8+%EB%8B%AC%EC%9D%B4+%EB%93%9C%EB%8A%94+%EB%B2%84%EC%A0%84%EB%A7%8C%2C+%EC%83%9D%EB%9E%B5%ED%95%98%EB%A9%B4+%EA%B8%B0%EA%B0%84%EA%B3%BC+%EC%83%81%EA%B4%80%EC%97%86%EC%9D%B4+%EB%B2%84%EC%A0%84+%EC%9D%B4%EB%A0%A5%EC%9D%84+%EB%8F%8C%EB%A0%A4%EC%A4%80%EB%8B%A4.+%EB%B3%B4%EA%B4%80+%EC%97%AC%EB%B6%80%EB%8A%94+month\u0026amp;theme=23a62b0b000949226daf3b66\u0026amp;signature=1b5c606c1d2047ec855c857cbec1894cd28b3a4c7cbafd9a09e6cf61a95ea6c9\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"https://mintlify.s3.us-west-1.amazonaws.com/meterengine/_generated/favicon/browserconfig.xml?v=3\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"MeterEngine\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#5746ad\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.meterengine.com/api-reference/price-plan-controller/요금제-이력-조회\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/price-plan-controller/%EC%9A%94%EA%B8%88%EC%A0%9C-%EC%9D%B4%EB%A0%A5-%EC%A1%B0%ED%9A%8C.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.meterengine.com/#organization\",\"name\":\"MeterEngine\",\"url\":\"https://docs.meterengine.com\"},{\"@type\":\"WebSite\",\"@id\":\"https://docs.meterengine.com#website\",\"name\":\"MeterEngine\",\"url\":\"https://docs.meterengine.com\",\"publisher\":{\"@id\":\"https://docs.meterengine.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.meterengine.com/api-reference/price-plan-controller/%EC%9A%94%EA%B8%88%EC%A0%9C-%EC%9D%B4%EB%A0%A5-%EC%A1%B0%ED%9A%8C#webpage\",\"url\":\"https://docs.meterengine.com/api-reference/price-plan-controller/%EC%9A%94%EA%B8%88%EC%A0%9C-%EC%9D%B4%EB%A0%A5-%EC%A1%B0%ED%9A%8C\",\"name\":\"요금제 이력 조회\",\"description\":\"customer_id를 주면 그 고객의 요금제만, 생략하면 도입사 공통 요금제만 돌려준다. 고객 요금제는 customer_id로 따로 조회한다. month를 주면 시작 월부터 종료 월 전까지에 그 달이 드는 버전만, 생략하면 기간과 상관없이 버전 이력을 돌려준다. 보관 여부는 month와 상관없이 status로 고른다. 시작 월 내림차순이다. 청구는 보관 효력(archived_from)까지 따져 버전을 고르므로, 그 달 청구에 쓰이는 요금제는 status=all 목록에서 시작 월이 가장 늦은 버전을 보고 고른다. 그 버전이 archived_from부터 멈췄으면 이전 버전으로 돌아가지 않는다.\",\"dateModified\":\"2026-11-11T06:13:35.277Z\",\"isPartOf\":{\"@id\":\"https://docs.meterengine.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.meterengine.com/api-reference/price-plan-controller/%EC%9A%94%EA%B8%88%EC%A0%9C-%EC%9D%B4%EB%A0%A5-%EC%A1%B0%ED%9A%8C#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.meterengine.com/api-reference/price-plan-controller/%EC%9A%94%EA%B8%88%EC%A0%9C-%EC%9D%B4%EB%A0%A5-%EC%A1%B0%ED%9A%8C#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"엔드포인트\",\"item\":\"https://docs.meterengine.com\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"요금제 이력 조회\",\"item\":\"https://docs.meterengine.com/api-reference/price-plan-controller/%EC%9A%94%EA%B8%88%EC%A0%9C-%EC%9D%B4%EB%A0%A5-%EC%A1%B0%ED%9A%8C\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.meterengine.com/api-reference/price-plan-controller/%EC%9A%94%EA%B8%88%EC%A0%9C-%EC%9D%B4%EB%A0%A5-%EC%A1%B0%ED%9A%8C#apireference\",\"headline\":\"요금제 이력 조회\",\"name\":\"요금제 이력 조회\",\"description\":\"customer_id를 주면 그 고객의 요금제만, 생략하면 도입사 공통 요금제만 돌려준다. 고객 요금제는 customer_id로 따로 조회한다. month를 주면 시작 월부터 종료 월 전까지에 그 달이 드는 버전만, 생략하면 기간과 상관없이 버전 이력을 돌려준다. 보관 여부는 month와 상관없이 status로 고른다. 시작 월 내림차순이다. 청구는 보관 효력(archived_from)까지 따져 버전을 고르므로, 그 달 청구에 쓰이는 요금제는 status=all 목록에서 시작 월이 가장 늦은 버전을 보고 고른다. 그 버전이 archived_from부터 멈췄으면 이전 버전으로 돌아가지 않는다.\",\"url\":\"https://docs.meterengine.com/api-reference/price-plan-controller/%EC%9A%94%EA%B8%88%EC%A0%9C-%EC%9D%B4%EB%A0%A5-%EC%A1%B0%ED%9A%8C\",\"mainEntityOfPage\":{\"@id\":\"https://docs.meterengine.com/api-reference/price-plan-controller/%EC%9A%94%EA%B8%88%EC%A0%9C-%EC%9D%B4%EB%A0%A5-%EC%A1%B0%ED%9A%8C#webpage\"},\"dateModified\":\"2026-11-11T06:13:35.277Z\",\"publisher\":{\"@id\":\"https://docs.meterengine.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.meterengine.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"MeterEngine\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"MeterEngine\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/api-reference/price-plan-controller/%EC%9A%94%EA%B8%88%EC%A0%9C-%EC%9D%B4%EB%A0%A5-%EC%A1%B0%ED%9A%8C.md","siteName":"MeterEngine","nav":{"global":null,"languages":[{"language":"ko","default":true,"tabs":[{"tab":"가이드","pages":[{"title":"가이드","href":""}]},{"tab":"API 참조","groups":[{"group":"소개","pages":[{"title":"API 참조 읽는 법","href":"/api-reference/introduction"}]},{"group":"엔드포인트","pages":[{"group":"API 키 (콘솔 전용)","pages":[]},{"group":"감사 기록 (콘솔 전용)","pages":[]},{"group":"미터별 단가 조회","pages":[{"title":"미터별 가격 목록 조회","deprecated":null,"version":null,"openapi":"https://raw.githubusercontent.com/asm17-ms2/meterengine/main/backend/openapi.yaml get /v1/billable-metric-prices","href":"/api-reference/billable-metric-price-controller/미터별-가격-목록-조회"}]},{"group":"검색과 내보내기","pages":[{"title":"미터별 가격 검색 결과 CSV","deprecated":null,"version":null,"openapi":"https://raw.githubusercontent.com/asm17-ms2/meterengine/main/backend/openapi.yaml get /v1/billable-metric-prices/export","href":"/api-reference/workspace-query-controller/미터별-가격-검색-결과-csv"},{"title":"단가 버전이 시작된 월 목록","deprecated":null,"version":null,"openapi":"https://raw.githubusercontent.com/asm17-ms2/meterengine/main/backend/openapi.yaml get /v1/billable-metric-prices/months","href":"/api-reference/workspace-query-controller/단가-버전이-시작된-월-목록"},{"title":"월별 가격 검색과 서버 페이지 조회","deprecated":null,"version":null,"openapi":"https://raw.githubusercontent.com/asm17-ms2/meterengine/main/backend/openapi.yaml get /v1/billable-metric-prices/search","href":"/api-reference/workspace-query-controller/월별-가격-검색과-서버-페이지-조회"},{"title":"미터 검색 결과 CSV","deprecated":null,"version":null,"openapi":"https://raw.githubusercontent.com/asm17-ms2/meterengine/main/backend/openapi.yaml get /v1/billable-metrics/export","href":"/api-reference/workspace-query-controller/미터-검색-결과-csv"},{"title":"미터 검색과 서버 페이지 조회","deprecated":null,"version":null,"openapi":"https://raw.githubusercontent.com/asm17-ms2/meterengine/main/backend/openapi.yaml get /v1/billable-metrics/search","href":"/api-reference/workspace-query-controller/미터-검색과-서버-페이지-조회"},{"title":"고객 검색 결과 CSV","deprecated":null,"version":null,"openapi":"https://raw.githubusercontent.com/asm17-ms2/meterengine/main/backend/openapi.yaml get /v1/customers/export","href":"/api-reference/workspace-query-controller/고객-검색-결과-csv"},{"title":"고객 검색과 서버 페이지 조회","deprecated":null,"version":null,"openapi":"https://raw.githubusercontent.com/asm17-ms2/meterengine/main/backend/openapi.yaml get /v1/customers/search","href":"/api-reference/workspace-query-controller/고객-검색과-서버-페이지-조회"},{"title":"청구 예정액 검색 결과 CSV","deprecated":null,"version":null,"openapi":"https://raw.githubusercontent.com/asm17-ms2/meterengine/main/backend/openapi.yaml get /v1/invoices/draft/export","href":"/api-reference/workspace-query-controller/청구-예정액-검색-결과-csv"},{"title":"청구 예정액 검색과 페이지 독립 요약","deprecated":null,"version":null,"openapi":"https://raw.githubusercontent.com/asm17-ms2/meterengine/main/backend/openapi.yaml get /v1/invoices/draft/search","href":"/api-reference/workspace-query-controller/청구-예정액-검색과-페이지-독립-요약"},{"title":"인보이스 검색 결과 CSV","deprecated":null,"version":null,"openapi":"https://raw.githubusercontent.com/asm17-ms2/meterengine/main/backend/openapi.yaml get /v1/invoices/export","href":"/api-reference/workspace-query-controller/인보이스-검색-결과-csv"},{"title":"확정 인보이스가 있는 월 목록","deprecated":null,"version":null,"openapi":"https://raw.githubusercontent.com/asm17-ms2/meterengine/main/backend/openapi.yaml get /v1/invoices/months","href":"/api-reference/workspace-query-controller/확정-인보이스가-있는-월-목록"},{"title":"인보이스와 결제 상태 검색","deprecated":null,"version":null,"openapi":"https://raw.githubusercontent.com/asm17-ms2/meterengine/main/backend/openapi.yaml get /v1/invoices/search","href":"/api-reference/workspace-query-controller/인보이스와-결제-상태-검색"},{"title":"고객별 사용량 검색 결과 CSV","deprecated":null,"version":null,"openapi":"https://raw.githubusercontent.com/asm17-ms2/meterengine/main/backend/openapi.yaml get /v1/usage/export","href":"/api-reference/workspace-query-controller/고객별-사용량-검색-결과-csv"},{"title":"이벤트가 있는 월 목록","deprecated":null,"version":null,"openapi":"https://raw.githubusercontent.com/asm17-ms2/meterengine/main/backend/openapi.yaml get /v1/usage/months","href":"/api-reference/workspace-query-controller/이벤트가-있는-월-목록"},{"title":"고객 단위 사용량 검색과 서버 페이지 조회","deprecated":null,"version":null,"openapi":"https://raw.githubusercontent.com/asm17-ms2/meterengine/main/backend/openapi.yaml get /v1/usage/search","href":"/api-reference/workspace-query-controller/고객-단위-사용량-검색과-서버-페이지-조회"}]},{"group":"미터","pages":[{"title":"미터 목록 조회","deprecated":null,"version":null,"openapi":"https://raw.githubusercontent.com/asm17-ms2/meterengine/main/backend/openapi.yaml get /v1/billable-metrics","href":"/api-reference/billable-metric-controller/미터-목록-조회"},{"title":"집계 미터 등록","deprecated":null,"version":null,"openapi":"https://raw.githubusercontent.com/asm17-ms2/meterengine/main/backend/openapi.yaml post /v1/billable-metrics","href":"/api-reference/billable-metric-controller/집계-미터-등록"},{"title":"미터 상세 조회","deprecated":null,"version":null,"openapi":"https://raw.githubusercontent.com/asm17-ms2/meterengine/main/backend/openapi.yaml get /v1/billable-metrics/{code}","href":"/api-reference/billable-metric-controller/미터-상세-조회"},{"title":"집계 미터 수정","deprecated":null,"version":null,"openapi":"https://raw.githubusercontent.com/asm17-ms2/meterengine/main/backend/openapi.yaml put /v1/billable-metrics/{code}","href":"/api-reference/billable-metric-controller/집계-미터-수정"},{"title":"미터 보관","deprecated":null,"version":null,"openapi":"https://raw.githubusercontent.com/asm17-ms2/meterengine/main/backend/openapi.yaml delete /v1/billable-metrics/{code}","href":"/api-reference/billable-metric-controller/미터-보관"},{"title":"버전을 확인한 미터 수정","deprecated":null,"version":null,"openapi":"https://raw.githubusercontent.com/asm17-ms2/meterengine/main/backend/openapi.yaml patch /v1/billable-metrics/{code}","href":"/api-reference/billable-metric-controller/버전을-확인한-미터-수정"},{"title":"미터 복원","deprecated":null,"version":null,"openapi":"https://raw.githubusercontent.com/asm17-ms2/meterengine/main/backend/openapi.yaml post /v1/billable-metrics/{code}/restorations","href":"/api-reference/billable-metric-controller/미터-복원"}]},{"group":"단가","pages":[{"title":"미터 단가 이력 조회","deprecated":null,"version":null,"openapi":"https://raw.githubusercontent.com/asm17-ms2/meterengine/main/backend/openapi.yaml get /v1/billable-metrics/{code}/price-rates","href":"/api-reference/price-rate-controller/미터-단가-이력-조회"},{"title":"단가 등록","deprecated":null,"version":null,"openapi":"https://raw.githubusercontent.com/asm17-ms2/meterengine/main/backend/openapi.yaml post /v1/billable-metrics/{code}/price-rates","href":"/api-reference/price-rate-controller/단가-등록"},{"title":"단가 조합 보관","deprecated":null,"version":null,"openapi":"https://raw.githubusercontent.com/asm17-ms2/meterengine/main/backend/openapi.yaml delete /v1/billable-metrics/{code}/price-rates","href":"/api-reference/price-rate-controller/단가-조합-보관"},{"title":"단가 버전 보관","deprecated":null,"version":null,"openapi":"https://raw.githubusercontent.com/asm17-ms2/meterengine/main/backend/openapi.yaml delete /v1/billable-metrics/{code}/price-rates/{id}","href":"/api-reference/price-rate-controller/단가-버전-보관"},{"title":"단가 버전 복원","deprecated":null,"version":null,"openapi":"https://raw.githubusercontent.com/asm17-ms2/meterengine/main/backend/openapi.yaml post /v1/billable-metrics/{code}/price-rates/{id}/restorations","href":"/api-reference/price-rate-controller/단가-버전-복원"}]},{"group":"고객","pages":[{"title":"고객 목록 조회","deprecated":null,"version":null,"openapi":"https://raw.githubusercontent.com/asm17-ms2/meterengine/main/backend/openapi.yaml get /v1/customers","href":"/api-reference/customer-controller/고객-목록-조회"},{"title":"고객 등록","deprecated":null,"version":null,"openapi":"https://raw.githubusercontent.com/asm17-ms2/meterengine/main/backend/openapi.yaml post /v1/customers","href":"/api-reference/customer-controller/고객-등록"},{"title":"고객 조회","deprecated":null,"version":null,"openapi":"https://raw.githubusercontent.com/asm17-ms2/meterengine/main/backend/openapi.yaml get /v1/customers/{id}","href":"/api-reference/customer-controller/고객-조회"},{"title":"고객 수정","deprecated":null,"version":null,"openapi":"https://raw.githubusercontent.com/asm17-ms2/meterengine/main/backend/openapi.yaml put /v1/customers/{id}","href":"/api-reference/customer-controller/고객-수정"},{"title":"고객 보관","deprecated":null,"version":null,"openapi":"https://raw.githubusercontent.com/asm17-ms2/meterengine/main/backend/openapi.yaml delete /v1/customers/{id}","href":"/api-reference/customer-controller/고객-보관"},{"title":"버전을 확인한 고객 수정","deprecated":null,"version":null,"openapi":"https://raw.githubusercontent.com/asm17-ms2/meterengine/main/backend/openapi.yaml patch /v1/customers/{id}","href":"/api-reference/customer-controller/버전을-확인한-고객-수정"},{"title":"고객 복원","deprecated":null,"version":null,"openapi":"https://raw.githubusercontent.com/asm17-ms2/meterengine/main/backend/openapi.yaml post /v1/customers/{id}/restorations","href":"/api-reference/customer-controller/고객-복원"}]},{"group":"결제 수단","pages":[{"title":"고객 카드 조회","deprecated":null,"version":null,"openapi":"https://raw.githubusercontent.com/asm17-ms2/meterengine/main/backend/openapi.yaml get /v1/customers/{id}/payment-method","href":"/api-reference/payment-method-controller/고객-카드-조회"},{"title":"고객 카드 보관","deprecated":null,"version":null,"openapi":"https://raw.githubusercontent.com/asm17-ms2/meterengine/main/backend/openapi.yaml delete /v1/customers/{id}/payment-method","href":"/api-reference/payment-method-controller/고객-카드-보관"},{"title":"고객 카드 목록 조회","deprecated":null,"version":null,"openapi":"https://raw.githubusercontent.com/asm17-ms2/meterengine/main/backend/openapi.yaml get /v1/payment-methods","href":"/api-reference/payment-method-controller/고객-카드-목록-조회"}]},{"group":"카드 등록 링크","pages":[{"title":"카드 등록 링크 생성","deprecated":null,"version":null,"openapi":"https://raw.githubusercontent.com/asm17-ms2/meterengine/main/backend/openapi.yaml post /v1/customers/{id}/payment-method-registrations","href":"/api-reference/payment-method-registration-controller/카드-등록-링크-생성"}]},{"group":"개요","pages":[{"title":"월별 과금과 수납 현황 조회","deprecated":null,"version":null,"openapi":"https://raw.githubusercontent.com/asm17-ms2/meterengine/main/backend/openapi.yaml get /v1/dashboard","href":"/api-reference/dashboard-controller/월별-과금과-수납-현황-조회"}]},{"group":"이벤트 일괄 전송","pages":[{"title":"사용량 이벤트 일괄 수집","deprecated":null,"version":null,"openapi":"https://raw.githubusercontent.com/asm17-ms2/meterengine/main/backend/openapi.yaml post /v1/event-batches","href":"/api-reference/event-batch-controller/사용량-이벤트-일괄-수집"}]},{"group":"이벤트 매핑 진단","pages":[{"title":"수집된 이벤트의 매핑 문제 조회","deprecated":null,"version":null,"openapi":"https://raw.githubusercontent.com/asm17-ms2/meterengine/main/backend/openapi.yaml get /v1/event-issues/search","href":"/api-reference/event-issue-controller/수집된-이벤트의-매핑-문제-조회"}]},{"group":"수집 거절","pages":[{"title":"수집 업무 거절 메타데이터 조회","deprecated":null,"version":null,"openapi":"https://raw.githubusercontent.com/asm17-ms2/meterengine/main/backend/openapi.yaml get /v1/event-rejections/search","href":"/api-reference/event-rejection-controller/수집-업무-거절-메타데이터-조회"}]},{"group":"이벤트","pages":[{"title":"사용량 이벤트 조회","deprecated":null,"version":null,"openapi":"https://raw.githubusercontent.com/asm17-ms2/meterengine/main/backend/openapi.yaml get /v1/events","href":"/api-reference/event-controller/사용량-이벤트-조회"},{"title":"사용량 이벤트 수집","deprecated":null,"version":null,"openapi":"https://raw.githubusercontent.com/asm17-ms2/meterengine/main/backend/openapi.yaml post /v1/events","href":"/api-reference/event-controller/사용량-이벤트-수집"},{"title":"이벤트 단건 조회","deprecated":null,"version":null,"openapi":"https://raw.githubusercontent.com/asm17-ms2/meterengine/main/backend/openapi.yaml get /v1/events/lookup","href":"/api-reference/event-controller/이벤트-단건-조회"},{"title":"이벤트가 있는 월 조회","deprecated":null,"version":null,"openapi":"https://raw.githubusercontent.com/asm17-ms2/meterengine/main/backend/openapi.yaml get /v1/events/months","href":"/api-reference/event-controller/이벤트가-있는-월-조회"},{"title":"수집된 이벤트 유형 조회","deprecated":null,"version":null,"openapi":"https://raw.githubusercontent.com/asm17-ms2/meterengine/main/backend/openapi.yaml get /v1/events/types","href":"/api-reference/event-controller/수집된-이벤트-유형-조회"}]},{"group":"이벤트 내보내기","pages":[{"title":"사용량 이벤트 CSV 내보내기","deprecated":null,"version":null,"openapi":"https://raw.githubusercontent.com/asm17-ms2/meterengine/main/backend/openapi.yaml get /v1/events/export","href":"/api-reference/event-export-controller/사용량-이벤트-csv-내보내기"}]},{"group":"수납 상태","pages":[{"title":"인보이스별 결제 상태 목록","deprecated":null,"version":null,"openapi":"https://raw.githubusercontent.com/asm17-ms2/meterengine/main/backend/openapi.yaml get /v1/invoice-payments","href":"/api-reference/invoice-payment-controller/인보이스별-결제-상태-목록"}]},{"group":"인보이스","pages":[{"title":"인보이스 목록 조회","deprecated":null,"version":null,"openapi":"https://raw.githubusercontent.com/asm17-ms2/meterengine/main/backend/openapi.yaml get /v1/invoices","href":"/api-reference/invoice-controller/인보이스-목록-조회"},{"title":"인보이스 일괄 확정","deprecated":null,"version":null,"openapi":"https://raw.githubusercontent.com/asm17-ms2/meterengine/main/backend/openapi.yaml post /v1/invoices","href":"/api-reference/invoice-controller/인보이스-일괄-확정"},{"title":"인보이스 조회","deprecated":null,"version":null,"openapi":"https://raw.githubusercontent.com/asm17-ms2/meterengine/main/backend/openapi.yaml get /v1/invoices/{id}","href":"/api-reference/invoice-controller/인보이스-조회"}]},{"group":"청구 예정액","pages":[{"title":"청구 예정액 조회","deprecated":null,"version":null,"openapi":"https://raw.githubusercontent.com/asm17-ms2/meterengine/main/backend/openapi.yaml get /v1/invoices/draft","href":"/api-reference/draft-invoice-controller/청구-예정액-조회"}]},{"group":"결제 요청","pages":[{"title":"인보이스 결제 시도 목록","deprecated":null,"version":null,"openapi":"https://raw.githubusercontent.com/asm17-ms2/meterengine/main/backend/openapi.yaml get /v1/invoices/{id}/payment-attempts","href":"/api-reference/payment-attempt-controller/인보이스-결제-시도-목록"},{"title":"인보이스 결제 요청","deprecated":null,"version":null,"openapi":"https://raw.githubusercontent.com/asm17-ms2/meterengine/main/backend/openapi.yaml post /v1/invoices/{id}/payment-attempts","href":"/api-reference/payment-attempt-controller/인보이스-결제-요청"}]},{"group":"인보이스 조회 링크","pages":[{"title":"고객 인보이스 조회 링크 목록","deprecated":null,"version":null,"openapi":"https://raw.githubusercontent.com/asm17-ms2/meterengine/main/backend/openapi.yaml get /v1/invoices/{id}/view-links","href":"/api-reference/invoice-view-link-controller/고객-인보이스-조회-링크-목록"},{"title":"고객 인보이스 조회 링크 발급","deprecated":null,"version":null,"openapi":"https://raw.githubusercontent.com/asm17-ms2/meterengine/main/backend/openapi.yaml post /v1/invoices/{id}/view-links","href":"/api-reference/invoice-view-link-controller/고객-인보이스-조회-링크-발급"},{"title":"고객 인보이스 조회 링크 폐기","deprecated":null,"version":null,"openapi":"https://raw.githubusercontent.com/asm17-ms2/meterengine/main/backend/openapi.yaml post /v1/invoices/{id}/view-links/{view_link_id}/revoke","href":"/api-reference/invoice-view-link-controller/고객-인보이스-조회-링크-폐기"}]},{"group":"도입사 정보","pages":[{"title":"현재 도입사 조회","deprecated":null,"version":null,"openapi":"https://raw.githubusercontent.com/asm17-ms2/meterengine/main/backend/openapi.yaml get /v1/organization","href":"/api-reference/current-organization-controller/현재-도입사-조회"},{"title":"공급자 정보 조회","deprecated":null,"version":null,"openapi":"https://raw.githubusercontent.com/asm17-ms2/meterengine/main/backend/openapi.yaml get /v1/organization/supplier","href":"/api-reference/current-organization-controller/공급자-정보-조회"},{"title":"공급자 정보 수정","deprecated":null,"version":null,"openapi":"https://raw.githubusercontent.com/asm17-ms2/meterengine/main/backend/openapi.yaml put /v1/organization/supplier","href":"/api-reference/current-organization-controller/공급자-정보-수정"}]},{"group":"업무 환경","pages":[{"title":"도입사의 테스트와 실제 환경 조회","deprecated":null,"version":null,"openapi":"https://raw.githubusercontent.com/asm17-ms2/meterengine/main/backend/openapi.yaml get /v1/organization/environments","href":"/api-reference/organization-environment-controller/도입사의-테스트와-실제-환경-조회"}]},{"group":"구성원과 초대 (콘솔 전용)","pages":[]},{"group":"결제 취소","pages":[{"title":"결제 취소 목록","deprecated":null,"version":null,"openapi":"https://raw.githubusercontent.com/asm17-ms2/meterengine/main/backend/openapi.yaml get /v1/payment-attempts/{id}/cancellations","href":"/api-reference/payment-cancellation-controller/결제-취소-목록"},{"title":"결제 취소 요청","deprecated":null,"version":null,"openapi":"https://raw.githubusercontent.com/asm17-ms2/meterengine/main/backend/openapi.yaml post /v1/payment-attempts/{id}/cancellations","href":"/api-reference/payment-cancellation-controller/결제-취소-요청"}]},{"group":"대사 불일치","pages":[{"title":"결제 대사 불일치 목록","deprecated":null,"version":null,"openapi":"https://raw.githubusercontent.com/asm17-ms2/meterengine/main/backend/openapi.yaml get /v1/payment-reconciliation-mismatches","href":"/api-reference/payment-reconciliation-mismatch-controller/결제-대사-불일치-목록"}]},{"group":"결제 설정","pages":[{"title":"결제 모드 조회","description":"선택한 환경의 결제 모드를 돌려준다. test/live 환경의 모드는 고정이며 updated_at=null이다.\n기존 범위는 저장한 모드를 쓰고, 바꾼 적 없으면 mode=test다.\nupdated_at은 KST(+09:00)로 나온다.\n","deprecated":null,"version":null,"openapi":"https://raw.githubusercontent.com/asm17-ms2/meterengine/main/backend/openapi.yaml get /v1/payment-setting","href":"/api-reference/payment-setting-controller/결제-모드-조회"}]},{"group":"요금제","pages":[{"title":"요금제 이력 조회","deprecated":null,"version":null,"openapi":"https://raw.githubusercontent.com/asm17-ms2/meterengine/main/backend/openapi.yaml get /v1/price-plans","href":"/api-reference/price-plan-controller/요금제-이력-조회"},{"title":"기본료와 최소 과금 요금제 등록","description":"사용료에 최소 과금을 적용한 뒤 기본료를 더한다. 수량이 없는 고객에게는 적용하지 않는다. 청구할 때 기본료와 최소 사용료는 10원 미만을 버린 값을 쓰며, 버린 기본료가 0원이면 기본료 라인이 생기지 않는다.","deprecated":null,"version":null,"openapi":"https://raw.githubusercontent.com/asm17-ms2/meterengine/main/backend/openapi.yaml post /v1/price-plans","href":"/api-reference/price-plan-controller/기본료와-최소-과금-요금제-등록"},{"title":"요금제 버전 보관","deprecated":null,"version":null,"openapi":"https://raw.githubusercontent.com/asm17-ms2/meterengine/main/backend/openapi.yaml delete /v1/price-plans/{id}","href":"/api-reference/price-plan-controller/요금제-버전-보관"},{"title":"요금제 버전 복원","deprecated":null,"version":null,"openapi":"https://raw.githubusercontent.com/asm17-ms2/meterengine/main/backend/openapi.yaml post /v1/price-plans/{id}/restorations","href":"/api-reference/price-plan-controller/요금제-버전-복원"}]},{"group":"토스페이먼츠 키","pages":[{"title":"토스페이먼츠 키 목록 조회","deprecated":null,"version":null,"openapi":"https://raw.githubusercontent.com/asm17-ms2/meterengine/main/backend/openapi.yaml get /v1/toss-payments-credentials","href":"/api-reference/toss-payments-credential-controller/토스페이먼츠-키-목록-조회"}]},{"group":"토스페이먼츠 웹훅 수신","pages":[]},{"group":"청구 제외 사용량","pages":[{"title":"청구 제외와 정정 이벤트 조회","deprecated":null,"version":null,"openapi":"https://raw.githubusercontent.com/asm17-ms2/meterengine/main/backend/openapi.yaml get /v1/unbilled-events","href":"/api-reference/unbilled-event-controller/청구-제외와-정정-이벤트-조회"}]},{"group":"사용량 집계","pages":[{"title":"고객별 월 사용량 조회","deprecated":null,"version":null,"openapi":"https://raw.githubusercontent.com/asm17-ms2/meterengine/main/backend/openapi.yaml get /v1/usage","href":"/api-reference/billable-metric-usage-controller/고객별-월-사용량-조회"}]},{"group":"웹훅","pages":[{"title":"웹훅 엔드포인트 목록 조회","deprecated":null,"version":null,"openapi":"https://raw.githubusercontent.com/asm17-ms2/meterengine/main/backend/openapi.yaml get /v1/webhook-endpoints","href":"/api-reference/webhook-endpoint-controller/웹훅-엔드포인트-목록-조회"},{"title":"웹훅 엔드포인트 등록","deprecated":null,"version":null,"openapi":"https://raw.githubusercontent.com/asm17-ms2/meterengine/main/backend/openapi.yaml post /v1/webhook-endpoints","href":"/api-reference/webhook-endpoint-controller/웹훅-엔드포인트-등록"},{"title":"웹훅 엔드포인트 조회","deprecated":null,"version":null,"openapi":"https://raw.githubusercontent.com/asm17-ms2/meterengine/main/backend/openapi.yaml get /v1/webhook-endpoints/{id}","href":"/api-reference/webhook-endpoint-controller/웹훅-엔드포인트-조회"},{"title":"웹훅 엔드포인트 수정","deprecated":null,"version":null,"openapi":"https://raw.githubusercontent.com/asm17-ms2/meterengine/main/backend/openapi.yaml put /v1/webhook-endpoints/{id}","href":"/api-reference/webhook-endpoint-controller/웹훅-엔드포인트-수정"},{"title":"웹훅 엔드포인트 보관","deprecated":null,"version":null,"openapi":"https://raw.githubusercontent.com/asm17-ms2/meterengine/main/backend/openapi.yaml delete /v1/webhook-endpoints/{id}","href":"/api-reference/webhook-endpoint-controller/웹훅-엔드포인트-보관"},{"title":"웹훅 전송 기록 조회","deprecated":null,"version":null,"openapi":"https://raw.githubusercontent.com/asm17-ms2/meterengine/main/backend/openapi.yaml get /v1/webhook-endpoints/{id}/deliveries","href":"/api-reference/webhook-endpoint-controller/웹훅-전송-기록-조회"},{"title":"실패한 웹훅 전송 재시도","deprecated":null,"version":null,"openapi":"https://raw.githubusercontent.com/asm17-ms2/meterengine/main/backend/openapi.yaml post /v1/webhook-endpoints/{id}/deliveries/{delivery_id}/retries","href":"/api-reference/webhook-endpoint-controller/실패한-웹훅-전송-재시도"},{"title":"웹훅 엔드포인트 복원","deprecated":null,"version":null,"openapi":"https://raw.githubusercontent.com/asm17-ms2/meterengine/main/backend/openapi.yaml post /v1/webhook-endpoints/{id}/restorations","href":"/api-reference/webhook-endpoint-controller/웹훅-엔드포인트-복원"},{"title":"웹훅 시험 이벤트 발행","deprecated":null,"version":null,"openapi":"https://raw.githubusercontent.com/asm17-ms2/meterengine/main/backend/openapi.yaml post /v1/webhook-endpoints/{id}/test-events","href":"/api-reference/webhook-endpoint-controller/웹훅-시험-이벤트-발행"}]}]}]}]}]},"basePath":"","title":"요금제 이력 조회 - MeterEngine","buildId":"dpl_596ePT575z4qnAFksq1biRW97aLY","deploymentId":"dpl_596ePT575z4qnAFksq1biRW97aLY","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-C9Wu0MeN.js","utils-jWgu-6Qf.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-DBD8f9qn.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-BGuX1ui5.js","snippetPresets-Evy63nQB.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","ApiExamples-BQHO1lnV.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-B6C8m-t_.js","shallow-BG4cT0fH.js","getApiPlaygroundDisplay-CgEPrE-D.js","CodeSnippet-CU8JyZ9N.js","CodeSnippets-BnxHU32T.js","Page-D6S0Yh6q.js","getPastedJson-CwiYOonh.js","icon-DYDpWmDf.js","MethodPill-C-J-l7_c.js","DuplicateIcon-B6ARwg9w.js","createIcon-Dsv4MtDq.js","DynamicMarkdown-CtasenyM.js","SectionHeading-YNcgYwjB.js","axios-vUo_bRtp.js","Markdown-CwLx6PAg.js","clsx-C3kuh_dz.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-CmKHfscc.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-U3mI6Ljh.js"]}