> ## Documentation Index > Fetch the complete documentation index at: https://docs.fmdb.net/llms.txt > Use this file to discover all available pages before exploring further. # Retrieves the collection of Artist resources. > Retrieves the collection of Artist resources. ## OpenAPI ````yaml /openapi.json get /api/artists openapi: 3.1.0 info: title: FMDB API description: >- The FMDB API provides access to a comprehensive film music database, covering releases, productions, artists, and recordings. It is designed for integration with third-party applications and services. FMDB is a non-commercial, privacy-first platform. The API is currently in beta and subject to change. Authentication is required for all endpoints unless stated otherwise. version: 1.0.0 Beta servers: - url: https://www.fmdb.net description: Production security: - bearerAuth: [] tags: - name: ArtistGroupMember description: Group memberships for artists. - name: ArtistAlias description: Artist aliases including nicknames, pseudonyms, and alternate spellings. - name: Artist description: Musical artists including individuals, groups, orchestras, and choirs. - name: ArtistRoleResolution description: >- Resolves a free-text credit title to the best-matching artist role, scoped by credit context. - name: ArtistRole description: >- Artist roles define the function of an artist in a release, recording, or track. - name: ArtistExternalLink description: External links for artists (MusicBrainz, Spotify, etc.). - name: LabelExternalLink description: External links for labels (MusicBrainz, Spotify, etc.). - name: OrganizationExternalLink description: External links for organizations (VGMdb, etc.). - name: ProductionExternalLink description: External links for productions (VGMdb, MusicBrainz, etc.). - name: ReleaseExternalLink description: External links for releases (Spotify, Discogs, MusicBrainz, etc.). - name: Label description: Record labels and music publishers. - name: LabelSeries description: Label series for categorizing releases within a label. - name: Organization description: >- Non-performer organizations credited on recordings (orchestra contractors, music-preparation houses, scoring services). - name: PackagingType description: >- Physical packaging types for releases (Jewel Case, Digipak, Box Set, etc.). - name: ProductionEntry description: Individual entries (episodes, parts) within a production series. - name: ProductionRecording description: Recordings associated with a production. - name: Production description: Film, TV, and game productions with associated music. - name: ReleaseFormat description: Physical or digital formats of a release (CD, vinyl, digital). - name: ReleaseRecording description: >- Recordings linked to a release with effective credits after applying exclusions. - name: Release description: Music releases including albums, soundtracks, and compilations. - name: ReleaseTrack description: Individual tracks on a release format. - name: Me description: Resource 'Me' operations. - name: User description: Resource 'User' operations. - name: CollectionItem description: Collection items representing releases owned by a user. - name: WishlistItem description: Wishlist items representing releases a user wants to acquire. paths: /api/artists: get: tags: - Artist summary: Retrieves the collection of Artist resources. description: Retrieves the collection of Artist resources. operationId: api_artists_get_collection parameters: - name: page in: query description: The collection page number required: false deprecated: false schema: type: integer default: 1 style: form explode: true - name: name in: query description: Artist name required: false deprecated: false schema: type: string style: form explode: true - name: name[] in: query description: Artist name required: false deprecated: false schema: type: array items: type: string style: deepObject explode: true - name: type in: query description: Artist type required: false deprecated: false schema: type: string style: form explode: true - name: q in: query description: Artist q required: false deprecated: false schema: type: string style: form explode: true - name: bornAfter in: query description: >- Keep artists whose begin date (birth for people, formation for groups) is on or after this partial date (YYYY, YYYY-MM or YYYY-MM-DD). Inclusive. Artists without a begin date are excluded. required: false deprecated: false schema: type: string pattern: ^\d{4}(-\d{2}(-\d{2})?)?$ style: form explode: true - name: bornBefore in: query description: >- Keep artists whose begin date is on or before this partial date. Inclusive to the end of the period, so bornBefore=1950 still matches an artist born on 1950-12-31. Artists without a begin date are excluded. required: false deprecated: false schema: type: string pattern: ^\d{4}(-\d{2}(-\d{2})?)?$ style: form explode: true - name: diedAfter in: query description: >- Keep artists whose end date (death for people, dissolution for groups) is on or after this partial date. Inclusive. Artists without an end date are excluded. required: false deprecated: false schema: type: string pattern: ^\d{4}(-\d{2}(-\d{2})?)?$ style: form explode: true - name: diedBefore in: query description: >- Keep artists whose end date is on or before this partial date. Inclusive to the end of the period. Artists without an end date are excluded. required: false deprecated: false schema: type: string pattern: ^\d{4}(-\d{2}(-\d{2})?)?$ style: form explode: true - name: order[beginDateSort] in: query description: >- Sort chronologically by begin date (birth / formation). Artists without a begin date sort first in ascending order (last in descending). Ignored when combined with q. required: false deprecated: false schema: type: string enum: - asc - desc - ASC - DESC style: form explode: true - name: order[endDateSort] in: query description: >- Sort chronologically by end date (death / dissolution). Artists without an end date sort first in ascending order (last in descending). Ignored when combined with q. required: false deprecated: false schema: type: string enum: - asc - desc - ASC - DESC style: form explode: true - name: order[name] in: query description: >- Sort by name or country. Sorting applies to the plain listing; when combined with q, Meilisearch keeps relevance ranking and order is ignored. required: false deprecated: false schema: type: string enum: - asc - desc - ASC - DESC style: form explode: true - name: order[country] in: query description: >- Sort by name or country. Sorting applies to the plain listing; when combined with q, Meilisearch keeps relevance ranking and order is ignored. required: false deprecated: false schema: type: string enum: - asc - desc - ASC - DESC style: form explode: true responses: '200': description: Artist collection content: application/vnd.api+json: schema: description: Artist.jsonapi collection. allOf: - $ref: '#/components/schemas/JsonApiCollectionBaseSchema' - type: object properties: data: type: array items: type: object properties: id: type: string type: type: string attributes: type: object properties: _id: type: string name: type: string _type: type: string enum: - person - group - orchestra - choir country: type: - string - 'null' display_name: readOnly: true description: >- Display name including disambiguator when the artist name collides with other artists. Falls back to plain name otherwise. default: '' example: Brian May (Australian composer) type: string real_name: example: Thomas Bangalter type: - string - 'null' begin_date: example: '1957-06-12' type: - string - 'null' end_date: example: 1920-05 type: - string - 'null' begin_city: type: - string - 'null' begin_country: type: - string - 'null' end_city: type: - string - 'null' end_country: type: - string - 'null' disambiguation: type: - string - 'null' biography: type: - string - 'null' variations: readOnly: true type: array items: type: object additionalProperties: type: - string - 'null' created_at: readOnly: true example: '2024-01-15T10:00:00+00:00' type: string format: date-time updated_at: readOnly: true example: '2024-01-15T14:30:00+00:00' type: - string - 'null' format: date-time relationships: type: object properties: members: properties: data: type: array items: type: object properties: type: type: string id: type: string format: iri-reference required: - type - id groups: properties: data: type: array items: type: object properties: type: type: string id: type: string format: iri-reference required: - type - id required: - type - id included: description: >- Related resources requested via the "include" query parameter. type: array items: anyOf: - $ref: '#/components/schemas/Artist.jsonapi' readOnly: true externalDocs: url: https://jsonapi.org/format/#fetching-includes components: schemas: JsonApiCollectionBaseSchema: allOf: - $ref: '#/components/schemas/JsonApiCollectionBaseSchemaNoPagination' - type: object properties: links: type: object properties: first: type: string format: iri-reference prev: type: string format: iri-reference next: type: string format: iri-reference last: type: string format: iri-reference example: first: string prev: string next: string last: string meta: type: object properties: itemsPerPage: type: integer minimum: 0 currentPage: type: integer minimum: 0 Artist.jsonapi: properties: data: type: object properties: id: type: string type: type: string attributes: type: object properties: _id: type: string name: type: string _type: type: string enum: - person - group - orchestra - choir country: type: - string - 'null' display_name: readOnly: true description: >- Display name including disambiguator when the artist name collides with other artists. Falls back to plain name otherwise. default: '' example: Brian May (Australian composer) type: string real_name: example: Thomas Bangalter type: - string - 'null' begin_date: example: '1957-06-12' type: - string - 'null' end_date: example: 1920-05 type: - string - 'null' begin_city: type: - string - 'null' begin_country: type: - string - 'null' end_city: type: - string - 'null' end_country: type: - string - 'null' disambiguation: type: - string - 'null' biography: type: - string - 'null' variations: readOnly: true type: array items: type: object additionalProperties: type: - string - 'null' created_at: readOnly: true example: '2024-01-15T10:00:00+00:00' type: string format: date-time updated_at: readOnly: true example: '2024-01-15T14:30:00+00:00' type: - string - 'null' format: date-time relationships: type: object properties: members: properties: data: type: array items: type: object properties: type: type: string id: type: string format: iri-reference required: - type - id groups: properties: data: type: array items: type: object properties: type: type: string id: type: string format: iri-reference required: - type - id required: - type - id included: description: Related resources requested via the "include" query parameter. type: array items: anyOf: - $ref: '#/components/schemas/Artist.jsonapi' readOnly: true externalDocs: url: https://jsonapi.org/format/#fetching-includes JsonApiCollectionBaseSchemaNoPagination: type: object properties: links: type: object properties: self: type: string format: iri-reference example: self: string meta: type: object properties: totalItems: type: integer minimum: 0 data: type: array required: - data securitySchemes: bearerAuth: type: http description: API token authentication scheme: bearer bearerFormat: JWT ````