# `Stripe.Resources.File`
[🔗](https://github.com/jeffhuen/tiger_stripe/blob/main/lib/stripe/resources/file.ex#L2)

File

This object represents files hosted on Stripe's servers. You can upload
files with the [create file](https://api.stripe.com#create_file) request
(for example, when uploading dispute evidence). Stripe also
creates files independently (for example, the results of a [Sigma scheduled
query](#scheduled_queries)).

Related guide: [File upload guide](https://docs.stripe.com/file-upload)

# `t`

```elixir
@type t() :: %Stripe.Resources.File{
  created: integer(),
  expires_at: integer(),
  filename: String.t(),
  id: String.t(),
  links: Stripe.Resources.File.Links.t() | nil,
  object: String.t(),
  purpose: String.t(),
  size: integer(),
  title: String.t(),
  type: String.t(),
  url: String.t()
}
```

* `created` - Time at which the object was created. Measured in seconds since the Unix epoch. Format: Unix timestamp.
* `expires_at` - The file expires and isn't available at this time in epoch seconds. Format: Unix timestamp. Nullable.
* `filename` - The suitable name for saving the file to a filesystem. Max length: 5000. Nullable.
* `id` - Unique identifier for the object. Max length: 5000.
* `links` - A list of [file links](https://api.stripe.com#file_links) that point at this file. Nullable. Expandable.
* `object` - String representing the object's type. Objects of the same type share the same value. Possible values: `file`.
* `purpose` - The [purpose](https://docs.stripe.com/file-upload#uploading-a-file) of the uploaded file. Possible values: `account_requirement`, `additional_verification`, `business_icon`, `business_logo`, `customer_signature`, `dispute_evidence`, `document_provider_identity_document`, `finance_report_run`, `financial_account_statement`, `identity_document`, `identity_document_downloadable`, `issuing_regulatory_reporting`, `pci_document`, `platform_terms_of_service`, `selfie`, `sigma_scheduled_query`, `tax_document_user_upload`, `terminal_android_apk`, `terminal_reader_splashscreen`, `terminal_wifi_certificate`, `terminal_wifi_private_key`.
* `size` - The size of the file object in bytes.
* `title` - A suitable title for the document. Max length: 5000. Nullable.
* `type` - The returned file type (for example, `csv`, `pdf`, `jpg`, or `png`). Max length: 5000. Nullable.
* `url` - Use your live secret API key to download the file from this URL. Max length: 5000. Nullable.

# `expandable_fields`

# `object_name`

---

*Consult [api-reference.md](api-reference.md) for complete listing*
