Skip to main content
GET
/
cards
List active cards
curl --request GET \
  --url https://www.postable.com/api/v1/cards \
  --header 'Authorization: Bearer <token>'
{
  "data": [
    {
      "id": 123,
      "name": "<string>",
      "slug": "<string>",
      "description": "<string>",
      "price": "<string>",
      "is_vertical": true,
      "artist": {
        "id": 123,
        "name": "<string>",
        "slug": "<string>"
      },
      "categories": [
        {
          "id": 123,
          "name": "<string>",
          "slug": "<string>"
        }
      ],
      "occasions": [
        {
          "id": 123,
          "name": "<string>",
          "slug": "<string>"
        }
      ],
      "tags": [
        "<string>"
      ],
      "images": [
        {
          "type": "<string>",
          "url": "<string>"
        }
      ],
      "customization_type": {
        "id": 123,
        "name": "<string>"
      }
    }
  ],
  "next_cursor": "<string>"
}

Authorizations

Authorization
string
header
required

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

Query Parameters

occasion_id
integer

Filter by occasion ID

category_id
integer

Filter by category ID

per_page
integer
default:20

Number of results per page

cursor
string

Cursor for pagination

Response

200 - application/json

A cursor-paginated list of cards

data
object[]
next_cursor
string | null
I