Billing and Payment List - iwinv IaaS(Infrastructure as a Service) API

Request

Query Params

start_date

string

optional

Search Start Date(Y-m-d format)

Ex: 2024-01-01

end_date

string

optional

Search End Date(Y-m-d format)

Ex: 2024-01-01

min_price

string

optional

Minimum Price(excluding VAT)

max_price

string

optional

Maximum Price(excluding VAT)

page_no

string

optional

Page Number

Default:

1

page_size

string

optional

Page Size

Default:

10

Header Params

X-iwinv-Timestamp

integer

required

Refer to [API Request]

Example:

X-iwinv-Credential

string

required

Refer to [API Request]

Example:

X-iwinv-Signature

string

required

Refer to [API Request]

Example:

Request samples

Shell

JavaScript

Java

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

curl --location --request GET 'https://api-kr.iwinv.kr/v1/bill?start_date=&end_date=&min_price=&max_price=&page_no=&page_size=' \
--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 {15}]

required

Result

bill_id

string

required

Bill ID

usage_start

string

required

Usage start date

usage_end

string

required

Usage end date

bill_date

string

required

Billed date

type

string

required

Bill type

payment_status

string

required

Payment Status

name

string

required

Bill Name

price

integer

required

Price(VAT excluded)

vat

integer

required

VAT

payment_price

integer

required

Total price

currency

string

required

Currency

date_paid

string

required

Date paid

payment_info

string

required

Card name

invoice

array[string]

required

Invoice URL

tax

array[string]

required

Tax(세금계산서) URL

count

integer

required

Number of bills returned

page_no

string

required

Page number

page_size

string

required

Page size

Example

{
  "code": "0x00",
  "error_code": "SUCCESS",
  "message": "",
  "result": [
    {
      "bill_id": "BILL-69I9aGAK1qIvxkBHMBb3o9",
      "usage_start": "2024-01-01",
      "usage_end": "2024-01-23",
      "bill_date": "2024-01-23",
      "type": "prepaid",
      "payment_status": "paid",
      "name": "메시지 S 요금제",
      "price": 20000,
      "vat": 2000,
      "payment_price": 22000,
      "currency": "KRW",
      "date_paid": "2024-02-23",
      "payment_info": "현대 아멕스",
      "invoice": [
        "https://dashboard.tosspayments.com/receipt/redirection?transactionId=******************"
      ],
      "tax": []
    },
    {
      "bill_id": "BILL-2maQCjuLeNFdjdtIybEMqf",
      "usage_start": "2023-12-01",
      "usage_end": "2023-12-31",
      "bill_date": "2023-12-31",
      "type": "regular",
      "payment_status": "paid",
      "name": "2023년 12월 정기 청구",
      "price": 59100,
      "vat": 5910,
      "payment_price": 65010,
      "currency": "KRW",
      "date_paid": "2024-01-01",
      "payment_info": "현대 아멕스",
      "invoice": [
        "http://pgweb.dacom.net/pg/wmp/etc/jsp/Receipt_Link.jsp?********************"
      ],
      "tax": [
        "https://*******.iwinv.kr/finance/*********?no=****************"
      ]
    }
  ],
  "count": 2,
  "page_no": "1",
  "page_size": "10"
}