# Succo AI Public API

> REST API for surveys, forms and their responses. Authenticate with a Bearer API key (`succo_sk_…`) created in Succo AI account settings.

- OpenAPI spec: https://succo.ai/api/public/v1/openapi.json
- Get started: https://succo.ai/developers/get-started
- API reference & playground: https://succo.ai/developers/api
- Versioning: date-based via the `Succo-Version` header. Supported: 2026-07-21.
- Errors: RFC 7807 `application/problem+json` with a stable `code`.
- Pagination: keyset with an opaque `cursor`; envelope `{data, next_cursor, limit_left}`.
- PII: redacted unless the key holds `read:pii` and the request sets `include_pii=true`.
- Analytics: `/surveys/{id}/analytics/{metrics,drop-off,dimensions}`; streaming export at `/responses/export` (`fmt=csv|ndjson`).
- Sparse fieldsets: append `?fields=a,b` to trim returned keys.