Skip to main content
GET
https://app.pixy.art
/
api
/
v1
/
templates
cURL
curl --request GET \
  --url https://app.pixy.art/api/v1/templates \
  --header 'Authorization: Bearer <token>'
{
  "data": [
    {
      "id": "cmmtpl123",
      "name": "Sporty Flash Sale Social Media Post",
      "thumbnail": "https://assets.example.com/templates/flash-sale.png",
      "category": "Social media",
      "size": {
        "width": 1600,
        "height": 900
      },
      "orientation": "Landscape",
      "fonts": [
        "Anton",
        "Plus Jakarta Sans"
      ],
      "formats": [
        "jpeg",
        "png",
        "pdf"
      ]
    }
  ],
  "total": 125,
  "page": 0,
  "perPage": 24,
  "search": "social"
}

Authorizations

​
Authorization
string
header
required

Organization API key passed as a bearer token.

Query Parameters

​
search
string

Search public templates by name or keyword.

​
page
integer
default:0

Zero-based page index.

Required range: x >= 0
​
perPage
integer
default:24

Number of templates to return per page.

Required range: 1 <= x <= 100
​
promoted
boolean

Optional filter for promoted templates.

​
orderBy
enum<string>
default:latest

Sort templates. latest returns recently updated templates first. oldest returns oldest created templates first.

Available options:
latest,
oldest

Response

Successfully returned public templates.

​
data
object[]
required
​
total
integer
required

Total matching templates.

​
page
integer
required

Zero-based page index.

​
perPage
integer
required

Page size used for the response.

​
search
string
required

Normalized search text.