Skip to main content
POST
/
data-shops
/
subscriptions
/
{subscription_id}
/
deliveries
/
download
Get a delivered file
curl --request POST \
  --url https://api-dev.narrative.io/data-shops/subscriptions/{subscription_id}/deliveries/download \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "transaction_batch_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "file": "<string>",
  "file_name_override": "<string>"
}
'
{
  "download_url": "<string>"
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

​
subscription_id
string<uuid>
required

Unique identifier for a subscription.

Body

application/json
​
transaction_batch_id
string<uuid>
required

Unique identifier for the subscription fulfillment event which produced the file.

​
file
string
required

The name of the delivered file to be downloaded.

​
file_name_override
string

If specified, when the delivery file is download it will have the name specified by file_name_override instead of the default name given by the file parameter.

Response

200 - application/json

OK

​
download_url
string
required

An AWS S3 presigned URL that can be used to download the file.

The presigned URL is valid for one hour meaning that the link must be used within an hour of receipt.