Sample - Stripe API
GET/v1/file_links/{link}

Retrieve a file link

Retrieves a file link by its identifier. Use expand when you need selected response fields expanded rather than returned as identifiers. The response contains the link's associated file and publicly accessible download URL.

  • RetriesRetries up to 2×, 500ms backoff, 30s timeout.

2 parameters
linkstringrequired
The unique identifier of the file link to retrieve.
expandarray<string>optional
Specifies which fields in the response to expand; each field name can contain up to 5,000 characters.

2 status codes
200Returns the file link with its identifier, associated file, publicly accessible URL, creation time, expiration time, expiration state, livemode, metadata, and object type.
createdintegerrequired
Time at which the object was created. Measured in seconds since the Unix epoch.
expiredbooleanrequired
Returns if the link is already expired.
expires_atintegeroptional
Time that the link expires.
filestringrequired
The file object this link points to.
idstringrequired
Unique identifier for the object.
livemodebooleanrequired
If the object exists in live mode, the value is `true`. If the object exists in test mode, the value is `false`.
metadataobjectrequired
Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format.
objectstringrequired
String representing the object's type. Objects of the same type share the same value.
Allowed:file_link
urlstringoptional
The publicly accessible URL to download the file.
defaultError response.
errorobjectrequired

Error handling

link must identify an existing file link. Each expand value must not exceed 5,000 characters.