> ## 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 ArtistAlias resources.

> Retrieves the collection of ArtistAlias resources.



## OpenAPI

````yaml /openapi.json get /api/artists/{artistId}/name-variations
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/{artistId}/name-variations:
    get:
      tags:
        - ArtistAlias
      summary: Retrieves the collection of ArtistAlias resources.
      description: Retrieves the collection of ArtistAlias resources.
      operationId: api_artists_artistIdname-variations_get_collection
      parameters:
        - name: artistId
          in: path
          description: ArtistResource identifier
          required: true
          deprecated: false
          schema:
            type: string
          style: simple
          explode: false
        - name: page
          in: query
          description: The collection page number
          required: false
          deprecated: false
          schema:
            type: integer
            default: 1
          style: form
          explode: true
        - name: variation
          in: query
          description: ''
          required: false
          deprecated: false
          schema:
            type: string
          style: form
          explode: false
        - name: type
          in: query
          description: ''
          required: false
          deprecated: false
          schema:
            type: string
            enum:
              - nickname
              - translation
              - abbreviation
              - acronym
              - initials
              - diminutive
              - homophone
              - corruption
              - other
              - real_name
          style: form
          explode: false
        - name: type[]
          in: query
          description: ''
          required: false
          deprecated: false
          schema:
            type: array
            items:
              type: string
              enum:
                - nickname
                - translation
                - abbreviation
                - acronym
                - initials
                - diminutive
                - homophone
                - corruption
                - other
                - real_name
          style: form
          explode: true
        - name: order[variation]
          in: query
          description: ''
          required: false
          deprecated: false
          schema:
            type: string
            default: asc
            enum:
              - asc
              - desc
          style: form
          explode: false
      responses:
        '200':
          description: ArtistAlias collection
          content:
            application/vnd.api+json:
              schema:
                description: ArtistAlias.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:
                                  example: 01934567-89ab-7cde-af01-23456789abcd
                                  type: string
                                variation:
                                  example: T. Bangalter
                                  type: string
                                _type:
                                  example: nickname
                                  type:
                                    - string
                                    - 'null'
                                  enum:
                                    - nickname
                                    - translation
                                    - abbreviation
                                    - acronym
                                    - initials
                                    - diminutive
                                    - homophone
                                    - corruption
                                    - other
                                    - real_name
                                    - null
                                notes:
                                  example: Stage name used in early career
                                  type:
                                    - string
                                    - 'null'
                          required:
                            - type
                            - id
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
    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

````