Skip to content

AICO API Documentation

Welcome to the AICO API documentation. This documentation covers all available API endpoints for integrating with the AICO platform.

Overview

AICO provides two main API interfaces:

AicoNeo API

High-performance optimized API endpoints designed for speed and efficiency. These endpoints use direct SQL queries for optimal performance.

Features:

  • Products, Customers, Orders, and Documents endpoints
  • Optimized for high-volume operations
  • Comprehensive filtering and sorting options
  • Includes support for related resources

Base URL: /api/aiconeo

V1 API

Standard JSON:API compliant endpoints for products, variants, and related resources.

Features:

  • Full JSON:API compliance
  • Products and Variants management
  • Suppliers, Tax Classes, and Sellers
  • Relationship management

Base URL: /{workspaceId}/api/v1


Authentication

All API endpoints require authentication using a Bearer Token:

curl -H "Authorization: Bearer YOUR_API_TOKEN" \
     -H "Accept: application/vnd.api+json" \
     https://app.aico.swiss/{workspaceId}/api/v1/products

Getting Started

  1. Obtain API credentials from your AICO administrator
  2. Choose the right API for your use case:
  3. Use AicoNeo API for high-performance operations
  4. Use V1 API for JSON:API compliant integrations
  5. Review the endpoint documentation for request/response formats
  6. Test your integration using the provided examples

Need Help?

If you have questions or need assistance with the API, please contact your AICO support representative.