Talk to Kvix
from anything.

Aggregate support reporting for the key’s company or brand. Includes current and previous summaries, current backlog, daily counts, topics and channels. Maximum 90 local calendar days. Spam and deleted tickets are excluded. Durations are medians for tickets created in the period, including AI first replies. Resolved counts use resolution dates and exclude reopened tickets. AI-only resolutions require a confirmed automatic reply with no public human reply. The previous period has the same local-day span and equivalent cutoff time. Null durations mean no qualifying observations.

GET https://app.kvix.ai/api/v1/statistics/support?from=2026-09-01&to=2026-09-30&timezone=Europe%2FCopenhagen (X-API-Key header)

{"data":{"version":1,"brand":{"id":2,"name":"All2day"},"summary":{"created_tickets":100,"resolved_tickets":90,"ai_only_resolved_tickets":40,"ai_only_resolution_percent":40,"median_first_response_seconds":120,"first_response_sample_count":80,"median_resolution_seconds":600,"resolution_sample_count":70},"backlog":{"total":12,"unanswered":5,"by_status":{"new":5,"open":4,"pending":3},"by_age":{"under_24_hours":6,"24_to_72_hours":4,"over_72_hours":2},"oldest_seconds":300000},"daily":[],"topics":[],"channels":[]}}

Describes the calling key: company, brand, scopes and rate limit. Use it to verify an integration's configuration without touching data.

curl -H "X-API-Key: $KVIX_KEY" https://app.kvix.ai/api/v1/me

{
  "data": {
    "key": { "name": "Production server", "last_four": "tv96", "scopes": ["tickets:read", "messages:read"], "all_access": false, "expires_at": null },
    "company": { "id": 1, "name": "ApexX" },
    "brand": { "id": 2, "name": "All2day" },
    "rate_limit_per_minute": 120
  }
}

Paginated list of tickets with customer and brand, newest activity first. All filters are optional and combined with AND.

curl -H "X-API-Key: $KVIX_KEY" \
  https://app.kvix.ai/api/v1/tickets?status=open&per_page=10

{
  "data": [
    {
      "id": 18,
      "reference_code": "TKT-AC-00018",
      "subject": "Refund question",
      "status": "open",
      "priority": "normal",
      "channel": "email",
      "assigned_to": null,
      "tags": ["billing"],
      "first_response_at": null,
      "resolved_at": null,
      "closed_at": null,
      "last_activity_at": "2026-05-15T09:14:02+00:00",
      "created_at": "2026-05-15T08:55:11+00:00"
    }
  ],
  "links": { "first": "...", "last": "...", "prev": null, "next": "..." },
  "meta":  { "current_page": 1, "per_page": 10, "total": 28 }
}

Create a new ticket. Customer is matched by email or auto-created.

curl -H "X-API-Key: $KVIX_KEY" \
  -H 'Content-Type: application/json' \
  -X POST https://app.kvix.ai/api/v1/tickets \
  -d '{"email":"[email protected]","subject":"Hello","body":"My order is late."}'

{
  "data": {
    "id": 142,
    "reference_code": "TKT-AC-00142",
    "subject": "Hello",
    "status": "new",
    "channel": "api",
    "customer": { "id": 88, "email": "[email protected]", "name": null },
    "brand":    { "id": 3, "slug": "default", "name": "Acme Support" }
  }
}

A single ticket plus its full message thread.

curl -H "X-API-Key: $KVIX_KEY" https://app.kvix.ai/api/v1/tickets/142

{
  "data": {
    "id": 142,
    "subject": "Hello",
    "status": "open",
    "messages": [
      { "id": 401, "sender_type": "customer", "body": "My order is late." },
      { "id": 402, "sender_type": "member", "body": "Sorry — let me check." }
    ]
  }
}

Update one or more of: status, priority, assignee, tags. Returns the refreshed ticket.

curl -H "X-API-Key: $KVIX_KEY" \
  -H 'Content-Type: application/json' \
  -X PATCH https://app.kvix.ai/api/v1/tickets/142 \
  -d '{"status":"resolved"}'

{
  "data": {
    "id": 142,
    "status": "resolved",
    "resolved_at": "2026-05-15T10:02:18+00:00"
  }
}

Paginated message list for a ticket, oldest first.

curl -H "X-API-Key: $KVIX_KEY" https://app.kvix.ai/api/v1/tickets/142/messages

{
  "data": [
    { "id": 401, "sender_type": "customer", "body": "My order is late.",  "is_internal_note": false },
    { "id": 402, "sender_type": "member",    "body": "Sorry — let me check.", "is_internal_note": false }
  ],
  "meta": { "current_page": 1, "per_page": 50, "total": 2 }
}

Append a member reply or internal note. A reply is delivered to the customer on the ticket's channel (e-mail, Facebook, Instagram), stamps the first response time, moves a new ticket to open and reopens a resolved one. Internal notes are never sent and never change the status.

curl -H "X-API-Key: $KVIX_KEY" \
  -H 'Content-Type: application/json' \
  -X POST https://app.kvix.ai/api/v1/tickets/142/messages \
  -d '{"body":"Thanks for your patience — refund issued."}'

{
  "data": {
    "id": 403,
    "ticket_id": 142,
    "sender_type": "member",
    "body": "Thanks for your patience — refund issued.",
    "is_internal_note": false,
    "ai_generated": false,
    "created_at": "2026-05-15T10:05:01+00:00"
  }
}

Paginated list of reviews, newest first. Read-only: replying to a review stays a dashboard action. The author's e-mail and internal AI fields are never returned.

curl -H "X-API-Key: $KVIX_KEY" \
  "https://app.kvix.ai/api/v1/reviews?max_rating=2&unanswered=true"

{
  "data": [
    {
      "id": 88,
      "provider": "trustpilot",
      "external_url": "https://www.trustpilot.com/reviews/…",
      "author_name": "Karen K.",
      "rating": 1,
      "title": "Voucher did not work",
      "body": "…",
      "language": "da",
      "sentiment": "negative",
      "category": null,
      "tags": [],
      "status": "unread",
      "brand": { "id": 2, "name": "All2day" },
      "posted_at": "2026-09-20T18:04:11+00:00",
      "edited_at": null,
      "replied_at": null
    }
  ],
  "links": { "first": "…", "last": "…", "prev": null, "next": null },
  "meta":  { "current_page": 1, "per_page": 25, "total": 1 }
}

A single review with the replies that were actually posted (drafts and pending approvals are internal).

curl -H "X-API-Key: $KVIX_KEY" https://app.kvix.ai/api/v1/reviews/88

{
  "data": {
    "id": 88,
    "provider": "trustpilot",
    "rating": 1,
    "title": "Voucher did not work",
    "status": "replied",
    "replies": [
      { "id": 12, "body": "We are sorry — a new voucher is on its way.", "ai_generated": false, "posted_at": "2026-09-21T08:12:40+00:00" }
    ]
  }
}