/ API Reference

Stores

Manage connected e-commerce stores

Endpoints

GET /api/v1/stores Requires: read

List all stores

GET /api/v1/stores/:id Requires: read

Get a store

POST /api/v1/stores Requires: write

Create a store

PATCH /api/v1/stores/:id Requires: write

Update a store

DELETE /api/v1/stores/:id Requires: delete

Delete a store

Fields

Field	Type	Required	Description
`id`	uuid	Optional	Unique identifier
`name`	string	Required	Store name
`platform`	string	Required	Platform type (swell, shopstack)
`domain`	string	Optional	Store domain URL
`active`	boolean	Optional	Whether the store is active

Examples

List Stores

curl -X GET "https://trucustom.net/api/v1/stores" \
  -H "Authorization: Bearer pc_your_api_key" \
  -H "Content-Type: application/json"

Response:

{
  "data": [
    {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "id": {},
      "name": "example",
      "platform": "example"
    }
  ],
  "meta": {
    "page": 1,
    "per_page": 20,
    "total": 42,
    "total_pages": 3
  }
}

Get Single Store

curl -X GET "https://trucustom.net/api/v1/stores/123e4567-e89b-12d3-a456-426614174000" \
  -H "Authorization: Bearer pc_your_api_key" \
  -H "Content-Type: application/json"

Create Store

curl -X POST "https://trucustom.net/api/v1/stores" \
  -H "Authorization: Bearer pc_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "value",
    "platform": "value"
  }'

Query Parameters

Parameter	Type	Description
`page`	integer	Page number (default: 1)
`per_page`	integer	Items per page (default: 20, max: 100)
`q`	string	Search query (searches name field)