---
updatedAt: 2026-04-22T09:48:12.000Z
agentTools:
  projectIndex: https://developers.modusign.co.kr/llms.txt
---

# 사용량 조회

특정 기간의 사용량을 조회합니다.

* 시간 정보는 별도의 타임존 정보를 포함하지 않을 시 [UTC](https://ko.wikipedia.org/wiki/%ED%98%91%EC%A0%95_%EC%84%B8%EA%B3%84%EC%8B%9C) 기준으로, 한국 시간(KST)과 9시간 차이가 납니다. 시간 형식에 관한 자세한 정보는 [RFC3339: Date and Time on the Internet](https://tools.ietf.org/html/rfc3339)를 참고해 주세요.</a>

# OpenAPI definition

```json
{
  "openapi": "3.0.0",
  "paths": {
    "/usages": {
      "get": {
        "description": "특정 기간의 사용량을 조회합니다.\n\n* 시간 정보는 별도의 타임존 정보를 포함하지 않을 시 [UTC](https://ko.wikipedia.org/wiki/%ED%98%91%EC%A0%95_%EC%84%B8%EA%B3%84%EC%8B%9C) 기준으로, 한국 시간(KST)과 9시간 차이가 납니다. 시간 형식에 관한 자세한 정보는 [RFC3339: Date and Time on the Internet](https://tools.ietf.org/html/rfc3339)를 참고해 주세요.</a>",
        "operationId": "SubscriptionController_getUsages",
        "parameters": [
          {
            "name": "from",
            "required": true,
            "in": "query",
            "description": "사용량 조회 시작 시각, UTC*",
            "schema": {
              "format": "date-time",
              "example": [
                "2021-09-01T00:00:00.000%2B0900",
                "2021-08-31T15:00:00.000Z"
              ],
              "type": "string"
            }
          },
          {
            "name": "to",
            "required": true,
            "in": "query",
            "description": "사용량 조회 종료 시각, UTC*",
            "schema": {
              "format": "date-time",
              "example": [
                "2021-09-30T23:59:59.999%2B0900",
                "2021-09-30T23:59:59.999Z"
              ],
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/GetUsagesResponseDto"
                }
              }
            }
          }
        },
        "security": [
          {
            "Basic": []
          },
          {
            "Bearer": []
          }
        ],
        "summary": "사용량 조회",
        "tags": [
          "USER API"
        ]
      }
    }
  },
  "info": {
    "title": "MODUSIGN API",
    "description": "",
    "version": "1.0.0",
    "contact": {}
  },
  "servers": [
    {
      "url": "https://api.modusign.co.kr",
      "description": "production"
    }
  ],
  "components": {
    "securitySchemes": {
      "Bearer": {
        "type": "http",
        "scheme": "bearer",
        "bearerFormat": "JWT"
      },
      "Basic": {
        "type": "http",
        "scheme": "basic"
      }
    },
    "schemas": {
      "UsagesItem": {
        "type": "object",
        "properties": {
          "feature": {
            "type": "string",
            "description": "사용 종류"
          },
          "count": {
            "type": "number",
            "description": "사용량"
          }
        },
        "required": [
          "feature",
          "count"
        ]
      },
      "GetUsagesResponseDto": {
        "type": "object",
        "properties": {
          "usages": {
            "description": "사용량 정보",
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/UsagesItem"
            }
          }
        },
        "required": [
          "usages"
        ]
      }
    }
  }
}
```