Skip to main content

SKU.io API Reference

SKU.io is an inventory management platform for multichannel ecommerce brands.

Getting Started​

1. Set Your Base URL​

Your SKU.io base URL
https://app.sku.io
https://.sku.io

Saved locally in your browser. Use this URL as the base for all API requests. In the Try It panels, set tenant to app to send requests directly from the docs.

2. Create a Personal Access Token​

All API requests require authentication via a Personal Access Token (PAT):

  1. Log in to your SKU.io account
  2. Navigate to Settings → Developer → Personal Access Tokens
  3. Click Create Token, give it a name and select the scopes you need
  4. Copy the token immediately — it won't be shown again

3. Authenticate Your Requests​

Include the token as a Bearer token in every request:

Authorization: Bearer <your-token>

Conventions​

Pagination​

List endpoints return paginated results. Use page and per_page query parameters:

GET /api/sales-orders?page=1&per_page=25

Response includes pagination metadata:

{
  "data": [...],
  "current_page": 1,
  "last_page": 10,
  "per_page": 25,
  "total": 243
}

Filtering​

Many list endpoints support filters via filter[field]=value (Spatie QueryBuilder):

GET /api/sales-orders?filter[status]=open&filter[search]=acme

Sorting​

Sort using the sort parameter. Prefix with - for descending:

GET /api/sales-orders?sort=-created_at
GET /api/sales-orders?sort=customer_name

Date Formats​

  • Date-only fields: YYYY-MM-DD (e.g. 2024-01-15)
  • Date range filters often use m/d/Y format (e.g. 01/15/2024) — see individual endpoint docs

Response Format​

Success​

{
  "data": { ... },
  "message": "Success"
}

Validation Error (422)​

{
  "message": "The given data was invalid.",
  "errors": {
    "field_name": ["The field name is required."]
  }
}

Unauthorized (401)​

{
  "message": "Unauthenticated."
}

Support​