---
title: "Integration API overview"
canonical: "http://docs.symios.ai/integration"
lang: "en"
---

# Overview

The Integration API exposes the same read-only dashboard metrics available in Symios, scoped to a company via API credentials managed in the Symios dashboard.

## Base URL

```
https://api.symios.ai/v2/integration
```

## What you can do

- List brands and query sets for the authenticated company
- List published runs for a query set
- Fetch Overview, Presence, Life, Gravity, Scout, and Market card payloads
- Connect LLM apps and IDEs via the hosted [MCP server](http://docs.symios.ai/integration/mcp.md)

## What you cannot do

- Mutate data (create, update, or delete)
- Authenticate as a dashboard user (Bearer `authToken` is a separate surface)
- Access brands outside the credential’s company

## Example

### Typical catalog call

**Endpoint**

```
GET /sets/brands/{brandId}/list
```

**Query string parameters**

None

**Return**

```json
[
    {
        "id": 42,
        "name": "Italy Q4",
        "created_at": "2026-03-01T10:00:00+00:00"
    }
]
```

**Example (cURL)**

```bash
curl -sS "https://api.symios.ai/v2/integration/sets/brands/12/list" \
  -H "X-Api-Key: sk_live_YOUR_KEY" \
  -H "X-Api-Secret: YOUR_SECRET"
```

Next: [Authentication](http://docs.symios.ai/integration/authentication.md) · [Catalog](http://docs.symios.ai/integration/catalog.md) · [Metrics](http://docs.symios.ai/integration/metrics.md)