Search courses

Supported filters are id, title, slug, visibility, and is_draft. Supported sort fields are id, title, slug, visibility, is_draft, created_at, and updated_at.

Authorization

AuthorizationBearer <token>

Provide your SellApp API key as a bearer token.

In: header

Query Parameters

limit?integer

Number of items to return per page.

Default15

Range1 <= value <= 100

page?integer

Page number to return.

Default1

Range1 <= value

pagination?boolean

Set to false to return at most 100 matching items in one data array without pagination links or metadata.

Defaulttrue

Header Parameters

X-STORE?string

Store slug. Required for OAuth access tokens. API keys may omit it to use their current store, or the first accessible store when no current store is selected.

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

filters?array<|>

sort?array<>

search?

includes?array<>

Response Body

`application/json`

curl -X POST "https://sell.app/api/v2/courses/search" \  -H "X-STORE: launch-lab" \  -H "Content-Type: application/json" \  -d '{    "filters": [      {        "field": "id",        "operator": "=",        "value": 1      }    ],    "sort": [      {        "field": "created_at",        "direction": "desc"      }    ]  }'

{
  "data": [
    {
      "id": 1,
      "title": "Design foundations",
      "slug": "design-foundations",
      "description": "Build your first design with reusable templates.",
      "visibility": "HIDDEN",
      "is_draft": false,
      "delivery_text": "Open your course to get started.",
      "category": "design",
      "level": "all_levels",
      "language": "en",
      "subtitle": null,
      "author": "Launch Lab",
      "subcategory": null,
      "what_you_learn": [
        "Customize a reusable template."
      ],
      "requirements": [
        "A web browser."
      ],
      "certificate_enabled": false,
      "access_type": "lifetime",
      "access_duration_days": null,
      "enrollment_limit": null,
      "promo_video": null,
      "sections": [
        {
          "id": 51,
          "title": "Getting started",
          "description": "Your first project.",
          "sort_order": 1,
          "lessons": [
            {
              "id": 52,
              "section_id": 51,
              "title": "Build your first design",
              "content": "Choose a template and add your project details.",
              "type": "lecture",
              "is_preview": false,
              "is_published": false,
              "sort_order": 1,
              "video": null,
              "attachments": [],
              "assignment": null,
              "questions": [],
              "created_at": "2026-09-01T12:00:00Z",
              "updated_at": "2026-09-01T12:00:00Z"
            }
          ],
          "created_at": "2026-09-01T12:00:00Z",
          "updated_at": "2026-09-01T12:00:00Z"
        }
      ],
      "created_at": "2026-09-01T12:00:00Z",
      "updated_at": "2026-09-01T12:00:00Z"
    }
  ],
  "links": {
    "first": "https://sell.app/api/v2/courses/search?page=1",
    "last": "https://sell.app/api/v2/courses/search?page=1",
    "prev": null,
    "next": null
  },
  "meta": {
    "current_page": 1,
    "from": 1,
    "last_page": 1,
    "links": [
      {
        "url": null,
        "label": "&laquo; Previous",
        "active": false
      },
      {
        "url": "https://sell.app/api/v2/courses/search?page=1",
        "label": "1",
        "active": true
      },
      {
        "url": null,
        "label": "Next &raquo;",
        "active": false
      }
    ],
    "path": "https://sell.app/api/v2/courses/search",
    "per_page": 15,
    "to": 1,
    "total": 1
  }
}

{
  "type": "invalid_request_error",
  "code": "bad_request",
  "message": "The request could not be understood.",
  "status": 400,
  "param": null,
  "request_id": "01992a65-e064-71ba-b38f-902b7966a6be",
  "docs_url": "https://sell.app/docs/api/errors#bad-request"
}

{
  "type": "authentication_error",
  "code": "unauthenticated",
  "message": "Unauthenticated.",
  "status": 401,
  "param": null,
  "request_id": "01992a65-e064-71ba-b38f-902b7966a6be",
  "docs_url": "https://sell.app/docs/api/errors#unauthenticated"
}

{
  "type": "authorization_error",
  "code": "forbidden",
  "message": "This action is unauthorized.",
  "status": 403,
  "param": null,
  "request_id": "01992a65-e064-71ba-b38f-902b7966a6be",
  "docs_url": "https://sell.app/docs/api/errors#forbidden"
}

{
  "type": "validation_error",
  "code": "validation_failed",
  "message": "The selected product variant id is invalid.",
  "status": 422,
  "param": "product_variant_id",
  "request_id": "01992a65-e064-71ba-b38f-902b7966a6be",
  "docs_url": "https://sell.app/docs/api/errors#validation-failed",
  "errors": {
    "product_variant_id": [
      "The selected product variant id is invalid."
    ]
  }
}

{
  "type": "rate_limit_error",
  "code": "rate_limit_exceeded",
  "message": "Too Many Attempts.",
  "status": 429,
  "param": null,
  "request_id": "01992a65-e064-71ba-b38f-902b7966a6be",
  "docs_url": "https://sell.app/docs/api/errors#rate-limit-exceeded"
}

{
  "type": "api_error",
  "code": "api_error",
  "message": "Server Error",
  "status": 500,
  "param": null,
  "request_id": "01992a65-e064-71ba-b38f-902b7966a6be",
  "docs_url": "https://sell.app/docs/api/errors#api-error"
}

Search courses

Authorization

Query Parameters

Header Parameters

Request Body

Response Body

200application/json

400application/json

401application/json

403application/json

422application/json

429application/json

500application/json

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`