> ## Documentation Index
> Fetch the complete documentation index at: https://docs.stateset.com/llms.txt
> Use this file to discover all available pages before exploring further.

# ACP API Endpoints

> Order submission endpoints and request patterns.

# ACP API Endpoints

ACP exposes endpoints for synchronous, async, and batch order submission.

## Endpoints

| Method | Endpoint                                   | Description                 |
| ------ | ------------------------------------------ | --------------------------- |
| POST   | `/v1/tenants/{tenant_id}/acp/orders`       | Process order synchronously |
| POST   | `/v1/tenants/{tenant_id}/acp/orders/async` | Process order in background |
| POST   | `/v1/tenants/{tenant_id}/acp/orders/batch` | Process multiple orders     |

## Authentication

Use either header for API key authentication:

```
Authorization: Bearer your-api-key-here
```

```
X-API-Key: your-api-key-here
```

## Example: Basic Order Submission

```bash theme={null}
curl -X POST https://your-server.com/v1/tenants/{tenant_id}/acp/orders \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "orderId": "agent-order-001",
    "orderNumber": "ORD-1001",
    "customer": {
      "email": "customer@example.com",
      "firstName": "John",
      "lastName": "Doe"
    },
    "shippingAddress": {
      "name": "John Doe",
      "address1": "123 Main Street",
      "city": "San Francisco",
      "state": "CA",
      "postalCode": "94102",
      "countryCode": "US"
    },
    "lineItems": [
      {
        "sku": "WIDGET-001",
        "title": "Blue Widget",
        "quantity": 2,
        "price": 29.99
      }
    ]
  }'
```