Skip to main content
GET
/
api
/
v1
/
themes.json
List Themes
curl --request GET \
  --url https://api.launchmystore.io/api/v1/themes.json \
  --header 'Authorization: Bearer <token>'
{
  "success": true,
  "data.items": [
    {
      "id": "<string>",
      "name": "<string>",
      "role": "<string>",
      "theme_store_id": "<string>",
      "previewable": true,
      "processing": true,
      "created_at": "<string>",
      "updated_at": "<string>"
    }
  ]
}

​
List Themes

Returns a list of themes installed in the store.

​
Request

curl -X GET "https://api.launchmystore.io/api/v1/themes.json" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

​
Parameters

​
role
string
Filter by role: main (published), unpublished, development

​
Response

​
success
boolean
Whether the request succeeded
​
data.items
array
Array of theme objects

​
Example Response

{
  "success": true,
  "data": {
    "items": [
      {
        "id": "theme_abc123",
        "name": "Dawn",
        "role": "main",
        "theme_store_id": "dawn-2024",
        "previewable": true,
        "processing": false,
        "created_at": "2024-01-15T10:00:00Z",
        "updated_at": "2024-03-15T14:30:00Z"
      },
      {
        "id": "theme_def456",
        "name": "Dawn (Development Copy)",
        "role": "development",
        "theme_store_id": null,
        "previewable": true,
        "processing": false,
        "created_at": "2024-03-01T10:00:00Z",
        "updated_at": "2024-03-20T09:00:00Z"
      },
      {
        "id": "theme_ghi789",
        "name": "Custom Theme",
        "role": "unpublished",
        "theme_store_id": null,
        "previewable": true,
        "processing": false,
        "created_at": "2024-02-15T10:00:00Z",
        "updated_at": "2024-02-28T14:30:00Z"
      }
    ]
  }
}

​
Error Codes

CodeDescription
UNAUTHORIZEDInvalid or missing access token
FORBIDDENApp doesn’t have read_themes scope