List（リスト）オブジェクト

いくつかのAPIリクエストはオブジェクトのリストを返し、大量の結果セットをページングできるようにします。リストはデフォルトで古い順に配信されます。

Attributes

Name	Type	Description
object	string	固定値 `list`。
location	string	現在の`list`オブジェクトを取得するためのAPIパス。
data	array	返されたオブジェクトの配列（課金、カード等）。
from	string	ISO 8601 形式(`YYYY-MM-DDThh:mm:ssZ`)で返されたレコードの最新のUTC日時。
limit	integer	返されるレコードの数。
offset	integer	返される最初のレコードのオフセット(先頭からスキップするレコードの数)。
order	string	listのオーダーが`chronological` (古い順) or `reverse_chronological` (新しい順)で返されます。エントリがない場合は `null`となります。
to	string	ISO 8601形式 (`YYYY-MM-DDThh:mm:ssZ`)で返されたレコードの最新のUTC日付と時刻。
total	integer	`from`と`to`の間のレコードの合計量。

Example

JSON Response

{
  "object": "list",
  "from": "1970-01-01T00:00:00Z",
  "to": "2019-07-23T01:15:06Z",
  "offset": 0,
  "limit": 20,
  "total": 0,
  "order": "chronological",
  "location": "/customers/cust_test_no1t4tnemucod0e51mo/cards",
  "data": [
    {
      "object": "card",
      "id": "card_test_5fvsnqqo6mzom2mf2t8",
      "livemode": false,
      "location": "/customers/cust_test_5fvsns5fkf8z52tiyt0/cards/card_test_5fvsnqqo6mzom2mf2t8",
      "street1": null,
      "street2": null,
      "city": "Bangkok",
      "state": null,
      "postal_code": "10320",
      "country": "gb",
      "phone_number": null,
      "financing": "credit",
      "bank": "Bank of the Unbanked",
      "last_digits": "4242",
      "brand": "Visa",
      "expiration_month": 12,
      "expiration_year": 2022,
      "fingerprint": "XjOdjaoHRvUGRfmZacMPcJtm0U3SEIIfkA7534dQeVw=",
      "name": "Somchai Prasert",
      "security_code_check": true,
      "created": "2019-05-13T04:35:55Z"
    }
  ]
}