Retrieve a month's bill

GET https://api2.transloadit.com/bill/{DATE}?signature={SIGNATURE}

Retrieves the billing data for the given DATE.

The query component DATE is in YYYY-MM format. So for example, to retrieve your bill for March 2019 you would use 2019-03.

GET query components

Passing signature is required. For more information please check Signature Authentication.

Response

Here’s an example response body:

{
  "ok": "BILL_FOUND",
  "invoice_id": "0d04b65924da41d4b68c80f776d196d5",
  "to": "Test User",
  "email": "testuser@example.org",
  "month": "2014-06",
  "created": "2014-07-01T06:58:32.000Z",
  "plan": {
    "id": "3599821193a1f77baafb98e5f8fb17a6",
    "price_per_month": 99,
    "gb_included": 35,
    "price_per_gb": 2.85,
    "gb_limit": null,
    "has_lifetime_limit": false
  },
  "used_gb": 21.99,
  "additional_gb": 0,
  "additional_gb_fee": 0,
  "company": "Jimbo Jones GmbH",
  "address_1": "Jimbostreet 19",
  "address_2": "",
  "zip": "10117",
  "city": "Berlin",
  "state": null,
  "country": "Germany",
  "robots": {
    "/assemblies": {
      "rawGb": 0,
      "gb": 0,
      "freeGb": 0,
      "gbFactorApplied": 0,
      "factor": 0
    },
    "/s3/store": {
      "rawGb": 11.75,
      "gb": 0.6,
      "freeGb": 0.57,
      "gbFactorApplied": 1.17,
      "factor": 10
    },
    "/video/encode": {
      "rawGb": 21.05,
      "gb": 21.05,
      "freeGb": 0,
      "gbFactorApplied": 21.05,
      "factor": 1
    },
    "/video/thumbs": {
      "rawGb": 3.42,
      "gb": 0.34,
      "freeGb": 0,
      "gbFactorApplied": 0.34,
      "factor": 10
    }
  },
  "sub_total": 99,
  "reward_discount_percent": 2,
  "reward_discount": 1.98,
  "signup_discount_percent": 0,
  "signup_discount": 0,
  "credit": 0,
  "bill_limit": 0,
  "vat_rate": 0.19,
  "vat": 18.43,
  "vat_id": "",
  "reverse_charge_vat": false,
  "total": 115.45
}

On success this request returns a JSON response with the success code BILL_FOUND and the corresponding bill data. The invoice_id in the response will be null for the bill of the current month. On error it contains a JSON response including an error field that contains an error status code and a reason field that contains details on what went wrong.