Create a download link

curl https://api.tapace.lk/v1/passes/pass_7hGk2LmQ9xVt4RnB8cYe/download-links \
  -H "Authorization: Bearer $TAPACE_API_KEY" \
  -H "Idempotency-Key: 3e7a1c9b-2d4f-4a6e-b8c1-7f5d2e9a4b10" \
  -H "Content-Type: application/json" \
  -d '{ "expiresInSeconds": 3600 }'

{
  "object": "download_link",
  "id": "dlink_Vb3Nq8Lm2Xr7Tk4Pz9Wc",
  "passId": "pass_7hGk2LmQ9xVt4RnB8cYe",
  "url": "https://pass.tapace.lk/dl/kX2r9QvL7mT4nB8cYe3WpZ",
  "expiresAt": "2026-10-13T11:00:00.000Z",
  "createdAt": "2026-10-13T10:00:00.000Z"
}

POST

passes

{id}

download-links

curl https://api.tapace.lk/v1/passes/pass_7hGk2LmQ9xVt4RnB8cYe/download-links \
  -H "Authorization: Bearer $TAPACE_API_KEY" \
  -H "Idempotency-Key: 3e7a1c9b-2d4f-4a6e-b8c1-7f5d2e9a4b10" \
  -H "Content-Type: application/json" \
  -d '{ "expiresInSeconds": 3600 }'

{
  "object": "download_link",
  "id": "dlink_Vb3Nq8Lm2Xr7Tk4Pz9Wc",
  "passId": "pass_7hGk2LmQ9xVt4RnB8cYe",
  "url": "https://pass.tapace.lk/dl/kX2r9QvL7mT4nB8cYe3WpZ",
  "expiresAt": "2026-10-13T11:00:00.000Z",
  "createdAt": "2026-10-13T10:00:00.000Z"
}

Use this instead of the permanent distributionUrl when a link should stop working after a while. See Deliver passes.

string

required

The pass ID.

string

required

A unique value for this request.

integer

default:"3600"

How long the link works, in seconds.

Response

string

Unique ID, starting with dlink_. Use it to revoke the link.

string

The pass the link opens.

string

The link to send to the holder. It’s returned only once.

string

When the link stops working.

string

When the link was created.

curl https://api.tapace.lk/v1/passes/pass_7hGk2LmQ9xVt4RnB8cYe/download-links \
  -H "Authorization: Bearer $TAPACE_API_KEY" \
  -H "Idempotency-Key: 3e7a1c9b-2d4f-4a6e-b8c1-7f5d2e9a4b10" \
  -H "Content-Type: application/json" \
  -d '{ "expiresInSeconds": 3600 }'

{
  "object": "download_link",
  "id": "dlink_Vb3Nq8Lm2Xr7Tk4Pz9Wc",
  "passId": "pass_7hGk2LmQ9xVt4RnB8cYe",
  "url": "https://pass.tapace.lk/dl/kX2r9QvL7mT4nB8cYe3WpZ",
  "expiresAt": "2026-10-13T11:00:00.000Z",
  "createdAt": "2026-10-13T10:00:00.000Z"
}

Getting started

Basics

Guides

API keys

Passes

Templates

Assets

Create a download link

Response

​Response

Response