# Retrieve a month’s bill

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

###### Warning

This endpoint requires your Auth Key to have the `billing:read` scope.

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](/docs/api/authentication.md).
* Passing `params` is required. It should contain a JSON encoded object with the keys as shown in the table below.

## Supported keys inside the `params` field

* ### `auth` — **required**

`object`\
Contains at least your Transloadit Auth Key in the `key` property.\
If you enable Signature Authentication, you must also set an expiry date for the request in the expires property:\
![](/_next/static/media/copy.8f7d2926.svg?dpl=dpl_2g7R5sPX3QtASTjewm5UnZagfZHZ)

```jsonc
{  
  "key": "23c96d084c744219a2ce156772ec3211",  
  "expires": "2009-08-28T01:02:03.000Z"  
}  
```

We strongly recommend including the `nonce` property — a randomly generated, unique value per request that prevents duplicate processing upon retries, can aid in debugging, and avoids attack vectors such as signature key reuse:\
![](/_next/static/media/copy.8f7d2926.svg?dpl=dpl_2g7R5sPX3QtASTjewm5UnZagfZHZ)

```jsonc
{  
  // …  
  "nonce": "04ac6cb6-df43-41fb-a7fd-e5dd711a64e1"  
}  
```

The `referer` property is a regular expression to match against the HTTP referer of this upload, such as `"example\.org"`. Specify this key to make sure that uploads only come from your domain.\
Uploads without a referer will always pass (as they are turned off for some browsers) making this useful in just a handful of use cases. For details about regular expressions, see [Mozilla's RegExp documentation](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global%5FObjects/RegExp).\
The `max_size` property can be used to set a maximum size that an upload can have in bytes, such as `1048576` (1 MB). Specify this to prevent users from uploading excessively large files.\
This can be set as part of the Assembly request or as part of the Template.\
The file size is checked as soon as the upload is started and if it exceeds the maximum size, the entire upload process is canceled and the Assembly will error out, even if it contains files that do not exceed the `max_size` limitation.\
If you want to just ignore the files that exceed a certain size, but process all others, then please use [🤖/file/filter](/docs/robots/file-filter.md).

## Response

Here’s an example response body:

![](/_next/static/media/copy.8f7d2926.svg?dpl=dpl_2g7R5sPX3QtASTjewm5UnZagfZHZ)

```
{
  "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.
