iwinv IaaS(Infrastructure as a Service) API
HomeMain PageConsoleDocsError CodeFieldsAPI TEST
HomeMain PageConsoleDocsError CodeFieldsAPI TEST
  1. Bill
  • Introduction
  • API Request
  • API Response
  • Zones
    • Zone List
      GET
  • Flavors
    • Flavor List
      GET
    • Flavor Detail
      GET
  • Images
    • Image List
      GET
    • Image Detail
      GET
  • Instances
    • Instance List
      GET
    • Instance Detail
      GET
    • Create Instance
      POST
    • Edit Instance Info
      PUT
    • Delete Instance
      DELETE
    • Start(ON) Instance
      POST
    • Shutdown(OFF) Instance
      POST
    • Reboot Instance
      POST
    • Rebuild(Image) Instance
      POST
    • Resize(Flavor) Instance
      POST
    • Remote Console
      GET
    • User Script List
      GET
  • Block Storages
    • Block Storage Types
      GET
    • Block Storage List
      GET
    • Block Storage Detail
      GET
    • Create Block Storage
      POST
    • Delete Block Storage
      DELETE
    • Attach Block Storage
      POST
    • Detach Block Storage
      POST
  • Bill
    • Live Bill
      GET
    • Billing and Payment List
      GET
    • Billing and Payment Detail
      GET
  • Authentication
    • SSH Key List
  • Usage Example
    • Zone List
  • Firewall
    • Firewall List
    • Firewall Detail
    • Create Firewall
    • Edit Firewall
    • Delete Firewall
    • Attach Firewall
    • Detach Firewall
  1. Bill

Billing and Payment Detail

GET
https://api-kr.iwinv.kr/v1/bill/{bill_id}

Request

Path Params
bill_id
string 
required
Bill ID of Bill
Header Params
X-iwinv-Timestamp
integer 
required
Refer to [API Request]
Example:
{{timestamp}}
X-iwinv-Credential
string 
required
Refer to [API Request]
Example:
{{accesskey}}
X-iwinv-Signature
string 
required
Refer to [API Request]
Example:
{{signature}}

Request samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request GET 'https://api-kr.iwinv.kr/v1/bill/' \
--header 'X-iwinv-Timestamp: {{timestamp}}' \
--header 'X-iwinv-Credential: {{accesskey}}' \
--header 'X-iwinv-Signature: {{signature}}'

Responses

🟢200Success
application/json
Body
code
string 
required
Status code
error_code
string 
required
Error message
message
string 
required
Status message
result
array [object {14}] 
required
Result
bill_id
string 
optional
Bill ID
usage_start
string 
optional
Usage start date
usage_end
string 
optional
Usage end date
bill_date
string 
optional
Billed date
payment_status
string 
optional
Payment Status
name
string 
optional
Bill Name
price
integer 
optional
Price(not including VAT)
vat
integer 
optional
VAT
payment_price
integer 
optional
Total price
currency
string 
optional
Currency
date_paid
string 
optional
Date paid
invoice
array[string]
optional
Invoice URL
tax
array[string]
optional
Tax(세금계산서) URL
group
array [object {4}] 
optional
Items
count
integer 
required
Example
{
  "code": "0x00",
  "error_code": "SUCCESS",
  "message": "",
  "result": [
    {
      "bill_id": "BILL-2maQCjuLeNFdjdtIybEMqf",
      "usage_start": "2023-12-01",
      "usage_end": "2023-12-31",
      "bill_date": "2023-12-31",
      "payment_status": "paid",
      "name": "2023년 12월 정기 청구",
      "price": 59100,
      "vat": 5910,
      "payment_price": 65010,
      "currency": "KRW",
      "date_paid": "2024-01-01",
      "invoice": [],
      "tax": [
        "https://*******.iwinv.kr/finance/*************?no=*******************"
      ],
      "group": [
        {
          "type": "서버",
          "count": 1,
          "sub_total": 5910,
          "item": [
            {
              "service_id": "INSTANCE-7NzLIWdjNR4XmiihwKjPYi",
              "name": "********-main[중요](49.247.***.***)",
              "service": "INSTANCE",
              "total": 59100,
              "price": 59100,
              "statue": "active",
              "item": [
                {
                  "branch": "서비스",
                  "type": "BILL",
                  "name": "********-main(49.247.***.***)",
                  "price": 54600,
                  "vat": 5460,
                  "sub_total": 60060,
                  "date_start": "2023-12-18",
                  "date_end": "2023-12-31",
                  "other": "이용 기간: 14일간"
                },
                {
                  "branch": "트래픽",
                  "type": "BILL",
                  "name": "트래픽 사용료(0GB)",
                  "price": 0,
                  "vat": 0,
                  "sub_total": 0,
                  "date_start": "2023-12-18",
                  "date_end": "2023-12-31",
                  "other": "기본 제공: 280 GB, 사용량: 0 GB"
                },
                {
                  "branch": "고객 알림",
                  "type": "BILL",
                  "name": "포트 모니터링",
                  "price": 4500,
                  "vat": 450,
                  "sub_total": 4950,
                  "date_start": "2023-12-18",
                  "date_end": "2023-12-31",
                  "other": "알림 횟수: 9 건"
                }
              ]
            }
          ]
        }
      ]
    }
  ],
  "count": 1
}
Previous
Billing and Payment List
Next
SSH Key List
Built with