Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.launchmystore.io/llms.txt

Use this file to discover all available pages before exploring further.

​
API Reference

The LaunchMyStore API is a REST API that allows you to manage store data including products, orders, customers, and more.

​
Base URL

https://api.launchmystore.io

​
Authentication

All API requests require authentication via OAuth 2.0 access tokens: 
curl -X GET "https://api.launchmystore.io/api/v1/products" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json"
See Authentication for details on obtaining tokens.

​
Request Format

  • All requests should include Content-Type: application/json
  • Request bodies should be valid JSON
  • Date fields use ISO 8601 format (2024-01-15T10:30:00Z)
  • Monetary values are in cents (e.g., 1000 = $10.00)

​
Response Format

All responses return JSON with consistent structure:

​
Success Response

{
  "success": true,
  "data": {
    // Resource data
  }
}

​
List Response

{
  "success": true,
  "data": {
    "items": [...],
    "pagination": {
      "page": 1,
      "limit": 50,
      "total": 150,
      "hasMore": true
    }
  }
}

​
Error Response

{
  "success": false,
  "error": {
    "code": "RESOURCE_NOT_FOUND",
    "message": "Product not found",
    "details": {}
  }
}

​
Pagination

List endpoints support pagination:
ParameterDefaultDescription
page1Page number
limit50Items per page (max 250)
GET /api/v1/products?page=2&limit=100

​
Filtering

Many endpoints support filtering: 
GET /api/v1/products?status=active&vendor=Nike
GET /api/v1/orders?created_at_min=2024-01-01&status=fulfilled

​
Rate Limits

Rate limits are based on your app’s billing tier:
TierRequests/second
Free20
Basic40
Pro100
Enterprise500
Rate limit headers are included in every response: 
X-RateLimit-Limit: 40
X-RateLimit-Remaining: 38
X-RateLimit-Reset: 1705312800
When rate limited, you’ll receive a 429 Too Many Requests response.

​
Error Codes

CodeHTTP StatusDescription
UNAUTHORIZED401Invalid or expired token
FORBIDDEN403Insufficient permissions
RESOURCE_NOT_FOUND404Resource doesn’t exist
VALIDATION_ERROR422Invalid request data
RATE_LIMITED429Too many requests
INTERNAL_ERROR500Server error

​
Versioning

The API version is included in the URL path. The current version is v1. Breaking changes will be released in new versions (e.g., v2). We’ll provide at least 12 months notice before deprecating old versions.

​
Resources

Products

Manage products and variants

Orders

Process and fulfill orders

Customers

Manage customer data

Inventory

Track inventory levels

Collections

Organize products

Discounts

Create discount codes