Skip to content
Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?
Go to file
Cannot retrieve contributors at this time


Assets are the visual elements of the pass.

Passworks supports 6 types of assets (icon, logo, strip, thumbnail, background and footer) each type of pass uses one or more types of assets.

You can reuse assets, meaning that you can assign the same asset to multiple passes, reducing the number of asset operations and also reducing the amount of bandwidth required to create a pass.

Types of assets

Each pass type (store card, event ticket, boarding pass, generic pass and coupons) use specific set of assets/images.

Asset Name Used in Size
icon All type of passes 118x118
logo All type of passes 320x100
strip Coupon, Event Ticket, Store Card 640x84 for Event Tickets or 640x246 for other types of passes
thumbnail Event ticket, Generic 180x180 The aspect ratio should be in the range of 2:3 to 3:2, otherwise the image is cropped.
background Event Ticket 360x440
footer Boarding Pass 286x30

Preferred image format is .png since it supports transparencies.

Maximum upload size is 1 Megabyte (1024 Kb)

Listing the assets

GET /v2/assets


    "id": "aab705bb-5bf0-4c14-93e0-f5fe01a4d3f5",
    "asset_type": "strip",
    "asset_url": "",
    "created_at": "2014-08-25T14:52:49Z"
    "id": "cecd7470-2ba8-4737-afe0-30d0cd4fd00c",
    "asset_type": "icon",
    "asset_url": "",
    "created_at": "2014-09-24T09:38:48Z"
    "id": "eb66127b-cbb7-41f4-b7ea-a6b8c106fead",
    "asset_type": "logo",
    "asset_url": "",
    "created_at": "2014-09-24T09:39:40Z"

Creating an asset

Passworks API allows you to upload images in the .jpg, .png and .gif format, note that all the uploads images will be reprocessed and converted to into png.

Images must be uploaded using multipart upload.

POST /v2/assets

Example body payload of the multipart request:

	asset[file]       = <multipart upload>
	asset[asset_type] = 'background'
Field Name Type Description
file string Required. The uploaded filename (eg: company-logo.png)
asset_type string Required. The type of asset being uploaded. Valid asset types are icon, logo, strip , thumbnail, background, footer


  "id": "32f85671-2e12-4a46-9fe2-05435cd5fc14",
  "asset_type": "background",
  "asset_url": "",
  "created_at": "2014-09-24T17:41:27Z"

Example of a multipart upload using curl:

curl -u <api username>:<api key> -v -H 'Content-Type: multipart/form-data' -H 'Accept: application/json' -F "asset[asset_type]=background" -F "asset[file]=@/images-folder/my-background.png"

Deleting an asset

You can also delete an asset:

DELETE /v2/assets/{asset_id}

You can only delete assets which are not being used by any templates.

Aditional routes

Get a specific asset:

GET /v2/assets/{asset_id}