> ## Documentation Index > Fetch the complete documentation index at: https://komga-sdk.mintlify.site/llms.txt > Use this file to discover all available pages before exploring further. # List series groups > List series grouped by the first character of their sort title. ## OpenAPI ````yaml https://raw.githubusercontent.com/gotson/komga/1.25.0/komga/docs/openapi.json post /api/v1/series/list/alphabetical-groups openapi: 3.1.0 info: description: >- Komga REST API. ## Reference Check the API reference: - on the [Komga website](https://komga.org/docs/openapi/komga-api) - on any running Komga instance at `/swagger-ui.html` - on [GitHub](https://raw.githubusercontent.com/gotson/komga/refs/heads/master/komga/docs/openapi.json) ## Authentication Most endpoints require authentication. Authentication is done using either: - Basic Authentication - Passing an API Key in the `X-API-Key` header ## Sessions Upon successful authentication, a session is created, and can be reused. - By default, a `KOMGA-SESSION` cookie is set via `Set-Cookie` response header. This works well for browsers and clients that can handle cookies. - If you specify a header `X-Auth-Token` during authentication, the session ID will be returned via this same header. You can then pass that header again for subsequent requests to reuse the session. If you need to set the session cookie later on, you can call `/api/v1/login/set-cookie` with `X-Auth-Token`. The response will contain the `Set-Cookie` header. ## Remember Me During authentication, if a request parameter `remember-me` is passed and set to `true`, the server will also return a `komga-remember-me` cookie. This cookie will be used to login automatically even if the session has expired. ## Logout You can explicitly logout an existing session by calling `/api/logout`. This would return a `204`. ## Deprecation API endpoints marked as deprecated will be removed in the next major version. license: name: MIT url: https://github.com/gotson/komga/blob/master/LICENSE title: Komga API version: 1.25.0 servers: - url: https://demo.komga.org description: Demo server - url: http://localhost:{port} description: Local development server variables: port: enum: - '8080' - '25600' default: '25600' security: - basicAuth: [] - apiKey: [] tags: - name: Deprecated - description: Manage libraries. name: Libraries - description: Manage series. name: Series - description: Manage posters for series. name: Series Poster - description: Manage books. name: Books - description: Manage posters for books. name: Book Poster - name: Book Pages - name: WebPub Manifest - name: Import - description: Provide font files and CSS for the Epub Reader. name: Fonts - description: Manage duplicate pages. Duplicate pages are identified by a page hash. name: Duplicate Pages - description: Manage collections. name: Collections - description: Manage posters for collections. name: Collection Poster - name: Collection Series - description: Manage readlists. name: Readlists - description: Manage posters for readlists. name: Readlist Poster - name: Readlist Books - description: Retrieve referential metadata from all items in the Komga server. name: Referential metadata - description: Manage current user. name: Current user - description: Manage users. name: Users - description: Manage API Keys name: API Keys - name: User session - description: List registered OAuth2 providers name: OAuth2 - description: Sync points are automatically created during a Kobo sync. name: Sync points - description: Claim a freshly installed Komga server. name: Claim - description: Manage server tasks name: Tasks - description: Server events history name: History - description: List files from the host server's file system name: File system - description: Store and retrieve server settings name: Server settings - description: Retrieve releases information name: Releases - description: Retrieve announcements from the Komga website name: Announcements - description: Manage server name: Management - name: Mihon - name: ComicRack - description: >- Store and retrieve global and per-user settings. Those settings are not used by Komga itself, but can be stored for convenience by client applications. name: Client settings externalDocs: description: Komga documentation url: https://komga.org paths: /api/v1/series/list/alphabetical-groups: post: tags: - Series summary: List series groups description: List series grouped by the first character of their sort title. operationId: getSeriesAlphabeticalGroups requestBody: content: application/json: schema: $ref: '#/components/schemas/SeriesSearch' required: true responses: '200': content: application/json: schema: type: array items: $ref: '#/components/schemas/GroupCountDto' description: OK '400': content: '*/*': schema: $ref: '#/components/schemas/ValidationErrorResponse' description: Bad Request components: schemas: SeriesSearch: type: object properties: condition: $ref: '#/components/schemas/SearchConditionSeries' fullTextSearch: type: string GroupCountDto: type: object properties: count: type: integer format: int32 group: type: string required: - count - group ValidationErrorResponse: type: object properties: violations: type: array items: $ref: '#/components/schemas/Violation' required: - violations SearchConditionSeries: oneOf: - $ref: '#/components/schemas/SearchConditionAnyOfSeries' - $ref: '#/components/schemas/SearchConditionAllOfSeries' - $ref: '#/components/schemas/SearchConditionLibraryId' - $ref: '#/components/schemas/SearchConditionCollectionId' - $ref: '#/components/schemas/SearchConditionDeleted' - $ref: '#/components/schemas/SearchConditionComplete' - $ref: '#/components/schemas/SearchConditionOneShot' - $ref: '#/components/schemas/SearchConditionTitle' - $ref: '#/components/schemas/SearchConditionTitleSort' - $ref: '#/components/schemas/SearchConditionReleaseDate' - $ref: '#/components/schemas/SearchConditionTag' - $ref: '#/components/schemas/SearchConditionSharingLabel' - $ref: '#/components/schemas/SearchConditionPublisher' - $ref: '#/components/schemas/SearchConditionLanguage' - $ref: '#/components/schemas/SearchConditionGenre' - $ref: '#/components/schemas/SearchConditionAgeRating' - $ref: '#/components/schemas/SearchConditionReadStatus' - $ref: '#/components/schemas/SearchConditionSeriesStatus' - $ref: '#/components/schemas/SearchConditionAuthor' Violation: type: object properties: fieldName: type: string message: type: string SearchConditionAnyOfSeries: properties: anyOf: type: array items: $ref: '#/components/schemas/SearchConditionSeries' required: - anyOf SearchConditionAllOfSeries: properties: allOf: type: array items: $ref: '#/components/schemas/SearchConditionSeries' required: - allOf SearchConditionLibraryId: properties: libraryId: $ref: '#/components/schemas/SearchOperatorEqualityString' required: - libraryId SearchConditionCollectionId: properties: collectionId: $ref: '#/components/schemas/SearchOperatorEqualityString' required: - collectionId SearchConditionDeleted: properties: deleted: $ref: '#/components/schemas/SearchOperatorBoolean' required: - deleted SearchConditionComplete: properties: complete: $ref: '#/components/schemas/SearchOperatorBoolean' required: - complete SearchConditionOneShot: properties: oneShot: $ref: '#/components/schemas/SearchOperatorBoolean' required: - oneShot SearchConditionTitle: properties: title: $ref: '#/components/schemas/SearchOperatorString' required: - title SearchConditionTitleSort: properties: titleSort: $ref: '#/components/schemas/SearchOperatorString' required: - titleSort SearchConditionReleaseDate: properties: releaseDate: $ref: '#/components/schemas/SearchOperatorDate' required: - releaseDate SearchConditionTag: properties: tag: $ref: '#/components/schemas/SearchOperatorEqualityNullableString' required: - tag SearchConditionSharingLabel: properties: sharingLabel: $ref: '#/components/schemas/SearchOperatorEqualityNullableString' required: - sharingLabel SearchConditionPublisher: properties: publisher: $ref: '#/components/schemas/SearchOperatorEqualityString' required: - publisher SearchConditionLanguage: properties: language: $ref: '#/components/schemas/SearchOperatorEqualityString' required: - language SearchConditionGenre: properties: genre: $ref: '#/components/schemas/SearchOperatorEqualityNullableString' required: - genre SearchConditionAgeRating: properties: ageRating: $ref: '#/components/schemas/SearchOperatorNumericNullableInteger' required: - ageRating SearchConditionReadStatus: properties: readStatus: $ref: '#/components/schemas/SearchOperatorEqualityReadStatus' required: - readStatus SearchConditionSeriesStatus: properties: seriesStatus: $ref: '#/components/schemas/SearchOperatorEqualityStatus' required: - seriesStatus SearchConditionAuthor: properties: author: $ref: '#/components/schemas/SearchOperatorEqualityAuthorMatch' required: - author SearchOperatorEqualityString: discriminator: mapping: is: '#/components/schemas/SearchOperatorIs' isNot: '#/components/schemas/SearchOperatorIsNot' propertyName: operator oneOf: - $ref: '#/components/schemas/SearchOperatorIs' - $ref: '#/components/schemas/SearchOperatorIsNot' properties: operator: type: string required: - operator SearchOperatorBoolean: discriminator: mapping: isFalse: '#/components/schemas/SearchOperatorIsFalse' isTrue: '#/components/schemas/SearchOperatorIsTrue' propertyName: operator oneOf: - $ref: '#/components/schemas/SearchOperatorIsTrue' - $ref: '#/components/schemas/SearchOperatorIsFalse' properties: operator: type: string required: - operator SearchOperatorString: discriminator: mapping: beginsWith: '#/components/schemas/SearchOperatorBeginsWith' contains: '#/components/schemas/SearchOperatorContains' doesNotBeginWith: '#/components/schemas/SearchOperatorDoesNotBeginWith' doesNotContain: '#/components/schemas/SearchOperatorDoesNotContain' doesNotEndWith: '#/components/schemas/SearchOperatorDoesNotEndWith' endsWith: '#/components/schemas/SearchOperatorEndsWith' is: '#/components/schemas/SearchOperatorIs' isNot: '#/components/schemas/SearchOperatorIsNot' propertyName: operator oneOf: - $ref: '#/components/schemas/SearchOperatorBeginsWith' - $ref: '#/components/schemas/SearchOperatorDoesNotBeginWith' - $ref: '#/components/schemas/SearchOperatorContains' - $ref: '#/components/schemas/SearchOperatorDoesNotContain' - $ref: '#/components/schemas/SearchOperatorEndsWith' - $ref: '#/components/schemas/SearchOperatorDoesNotEndWith' - $ref: '#/components/schemas/SearchOperatorIs' - $ref: '#/components/schemas/SearchOperatorIsNot' properties: operator: type: string required: - operator SearchOperatorDate: discriminator: mapping: after: '#/components/schemas/SearchOperatorAfter' before: '#/components/schemas/SearchOperatorBefore' isInTheLast: '#/components/schemas/SearchOperatorIsInTheLast' isNotInTheLast: '#/components/schemas/SearchOperatorIsNotInTheLast' isNotNull: '#/components/schemas/SearchOperatorIsNotNull' isNull: '#/components/schemas/SearchOperatorIsNull' propertyName: operator oneOf: - $ref: '#/components/schemas/SearchOperatorBefore' - $ref: '#/components/schemas/SearchOperatorAfter' - $ref: '#/components/schemas/SearchOperatorIsInTheLast' - $ref: '#/components/schemas/SearchOperatorIsNotInTheLast' - $ref: '#/components/schemas/SearchOperatorIsNull' - $ref: '#/components/schemas/SearchOperatorIsNotNull' properties: operator: type: string required: - operator SearchOperatorEqualityNullableString: discriminator: mapping: is: '#/components/schemas/SearchOperatorIs' isNot: '#/components/schemas/SearchOperatorIsNot' isNotNull: '#/components/schemas/SearchOperatorIsNotNullT' isNull: '#/components/schemas/SearchOperatorIsNullT' propertyName: operator oneOf: - $ref: '#/components/schemas/SearchOperatorIs' - $ref: '#/components/schemas/SearchOperatorIsNot' - $ref: '#/components/schemas/SearchOperatorIsNullT' - $ref: '#/components/schemas/SearchOperatorIsNotNullT' properties: operator: type: string required: - operator SearchOperatorNumericNullableInteger: discriminator: mapping: greaterThan: '#/components/schemas/SearchOperatorGreaterThan' is: '#/components/schemas/SearchOperatorIs' isNot: '#/components/schemas/SearchOperatorIsNot' isNotNull: '#/components/schemas/SearchOperatorIsNotNullT' isNull: '#/components/schemas/SearchOperatorIsNullT' lessThan: '#/components/schemas/SearchOperatorLessThan' propertyName: operator oneOf: - $ref: '#/components/schemas/SearchOperatorGreaterThan' - $ref: '#/components/schemas/SearchOperatorLessThan' - $ref: '#/components/schemas/SearchOperatorIsNullT' - $ref: '#/components/schemas/SearchOperatorIsNotNullT' - $ref: '#/components/schemas/SearchOperatorIs' - $ref: '#/components/schemas/SearchOperatorIsNot' properties: operator: type: string required: - operator SearchOperatorEqualityReadStatus: discriminator: mapping: is: '#/components/schemas/SearchOperatorIs' isNot: '#/components/schemas/SearchOperatorIsNot' propertyName: operator oneOf: - $ref: '#/components/schemas/SearchOperatorIs' - $ref: '#/components/schemas/SearchOperatorIsNot' properties: operator: type: string required: - operator SearchOperatorEqualityStatus: discriminator: mapping: is: '#/components/schemas/SearchOperatorIs' isNot: '#/components/schemas/SearchOperatorIsNot' propertyName: operator oneOf: - $ref: '#/components/schemas/SearchOperatorIs' - $ref: '#/components/schemas/SearchOperatorIsNot' properties: operator: type: string required: - operator SearchOperatorEqualityAuthorMatch: discriminator: mapping: is: '#/components/schemas/SearchOperatorIs' isNot: '#/components/schemas/SearchOperatorIsNot' propertyName: operator oneOf: - $ref: '#/components/schemas/SearchOperatorIs' - $ref: '#/components/schemas/SearchOperatorIsNot' properties: operator: type: string required: - operator SearchOperatorIs: properties: value: {} required: - value SearchOperatorIsNot: properties: value: {} required: - value SearchOperatorIsFalse: allOf: - $ref: '#/components/schemas/SearchOperatorBoolean' SearchOperatorIsTrue: allOf: - $ref: '#/components/schemas/SearchOperatorBoolean' SearchOperatorBeginsWith: properties: value: type: string required: - value SearchOperatorContains: properties: value: type: string required: - value SearchOperatorDoesNotBeginWith: properties: value: type: string required: - value SearchOperatorDoesNotContain: properties: value: type: string required: - value SearchOperatorDoesNotEndWith: properties: value: type: string required: - value SearchOperatorEndsWith: properties: value: type: string required: - value SearchOperatorAfter: properties: dateTime: type: string format: date-time required: - dateTime SearchOperatorBefore: properties: dateTime: type: string format: date-time required: - dateTime SearchOperatorIsInTheLast: properties: duration: type: string required: - duration SearchOperatorIsNotInTheLast: properties: duration: type: string required: - duration SearchOperatorIsNotNull: allOf: - $ref: '#/components/schemas/SearchOperatorDate' SearchOperatorIsNull: allOf: - $ref: '#/components/schemas/SearchOperatorDate' SearchOperatorIsNotNullT: allOf: - $ref: '#/components/schemas/SearchOperatorNumericNullableInteger' - $ref: '#/components/schemas/SearchOperatorEqualityNullableString' SearchOperatorIsNullT: allOf: - $ref: '#/components/schemas/SearchOperatorNumericNullableInteger' - $ref: '#/components/schemas/SearchOperatorEqualityNullableString' SearchOperatorGreaterThan: properties: value: {} required: - value SearchOperatorLessThan: properties: value: {} required: - value securitySchemes: basicAuth: scheme: basic type: http apiKey: in: header name: X-API-Key type: apiKey ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.