Skip to main content
GET
https://api.chariow.com/v1
/
products
curl -X GET "https://api.chariow.com/v1/products?per_page=20&type=course" \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY"

{
  "message": "success",
  "data": {
    "data": [
      {
        "id": "prd_abc123",
        "name": "Premium Course",
        "slug": "premium-course",
        "type": "course",
        "category": {
          "value": "education_and_learning",
          "label": "Education and Learning"
        },
        "status": "published",
        "is_free": false,
        "pictures": {
          "thumbnail": "https://cdn.chariow.com/products/abc123/thumb.jpg",
          "cover": "https://cdn.chariow.com/products/abc123/cover.jpg"
        },
        "pricing": {
          "type": "one_time",
          "current_price": {
            "amount": 99.00,
            "currency": "USD",
            "formatted": "$99.00"
          },
          "price": {
            "amount": 99.00,
            "currency": "USD",
            "formatted": "$99.00"
          }
        }
      },
      {
        "id": "prd_def456",
        "name": "Pro Software License",
        "slug": "pro-software",
        "type": "license",
        "category": {
          "value": "technology",
          "label": "Technology"
        },
        "status": "published",
        "is_free": false,
        "pictures": {
          "thumbnail": null,
          "cover": null
        },
        "pricing": {
          "type": "one_time",
          "current_price": {
            "amount": 49.00,
            "currency": "USD",
            "formatted": "$49.00"
          },
          "price": {
            "amount": 49.00,
            "currency": "USD",
            "formatted": "$49.00"
          }
        }
      }
    ],
    "pagination": {
      "next_cursor": "eyJpZCI6NTB9",
      "prev_cursor": null,
      "has_more": true
    }
  },
  "errors": []
}
Retrieves a cursor-paginated list of all published products in your store. Only products in published status are returned. Supports optional filtering by category, type, or search term.

​
Query Parameters

​
per_page
integer
default:"10"
Number of products to return per page (maximum 100)
​
cursor
string
Cursor for pagination. Use the next_cursor from the previous response to fetch the next page.
​
search
string
Search products by name or slug
​
category
string
Filter by product category. Available values: creative_arts, technology, business_and_finance, personal_development, education_and_learning, entertainment, health_and_wellness, literature_and_publishing, media_and_communication, miscellaneous
​
type
string
Filter by product type. Available values: downloadable, service, course, license, bundle

​
Response

​
message
string
Response status message
​
data
object
​
errors
array
Array of error messages (empty on success)
curl -X GET "https://api.chariow.com/v1/products?per_page=20&type=course" \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY"

{
  "message": "success",
  "data": {
    "data": [
      {
        "id": "prd_abc123",
        "name": "Premium Course",
        "slug": "premium-course",
        "type": "course",
        "category": {
          "value": "education_and_learning",
          "label": "Education and Learning"
        },
        "status": "published",
        "is_free": false,
        "pictures": {
          "thumbnail": "https://cdn.chariow.com/products/abc123/thumb.jpg",
          "cover": "https://cdn.chariow.com/products/abc123/cover.jpg"
        },
        "pricing": {
          "type": "one_time",
          "current_price": {
            "amount": 99.00,
            "currency": "USD",
            "formatted": "$99.00"
          },
          "price": {
            "amount": 99.00,
            "currency": "USD",
            "formatted": "$99.00"
          }
        }
      },
      {
        "id": "prd_def456",
        "name": "Pro Software License",
        "slug": "pro-software",
        "type": "license",
        "category": {
          "value": "technology",
          "label": "Technology"
        },
        "status": "published",
        "is_free": false,
        "pictures": {
          "thumbnail": null,
          "cover": null
        },
        "pricing": {
          "type": "one_time",
          "current_price": {
            "amount": 49.00,
            "currency": "USD",
            "formatted": "$49.00"
          },
          "price": {
            "amount": 49.00,
            "currency": "USD",
            "formatted": "$49.00"
          }
        }
      }
    ],
    "pagination": {
      "next_cursor": "eyJpZCI6NTB9",
      "prev_cursor": null,
      "has_more": true
    }
  },
  "errors": []
}