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

# List artist affiliations

> List artist affiliations



## OpenAPI

````yaml /openapi.json get /api/artist-affiliations
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: AffiliationGraph
    description: >-
      The ensembles and organizations within a few affiliations of one of them
      (ADR-0018 §8), as nodes and edges. Pages draw one ring; deeper
      neighbourhoods are served here only.
  - name: ArtistAffiliation
    description: >-
      An orchestra or choir linked to an organization as its contractor, studio
      or parent institution (ADR-0018).
  - 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: Portrayal
    description: A real artist portraying a fictional artist in a production.
  - 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: OrganizationRelation
    description: An organization and its parent organization (ADR-0018 §8).
  - 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: Resolution
    description: >-
      Resolves a public FMDB slug or page URL to the UUID of the record it
      names, following renamed slugs and records merged into another.
  - 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/artist-affiliations:
    get:
      tags:
        - ArtistAffiliation
      summary: List artist affiliations
      description: List artist affiliations
      operationId: api_artist-affiliations_get_collection
      parameters:
        - name: page
          in: query
          description: The collection page number
          required: false
          deprecated: false
          schema:
            type: integer
            default: 1
            minimum: 1
          style: form
          explode: true
        - name: artist
          in: query
          description: Keep the affiliations of this orchestra or choir (artist UUID).
          required: false
          deprecated: false
          schema:
            type: string
            format: uuid
          style: form
          explode: true
        - name: artist[]
          in: query
          description: Keep the affiliations of this orchestra or choir (artist UUID).
          required: false
          deprecated: false
          schema:
            type: array
            items:
              type: string
              format: uuid
          style: deepObject
          explode: true
        - name: organization
          in: query
          description: Keep the affiliations with this organization (organization UUID).
          required: false
          deprecated: false
          schema:
            type: string
            format: uuid
          style: form
          explode: true
        - name: organization[]
          in: query
          description: Keep the affiliations with this organization (organization UUID).
          required: false
          deprecated: false
          schema:
            type: array
            items:
              type: string
              format: uuid
          style: deepObject
          explode: true
        - name: kind
          in: query
          description: Keep the affiliations of this kind.
          required: false
          deprecated: false
          schema:
            type: string
            enum:
              - contractor
              - studio
              - parent_institution
          style: form
          explode: true
        - name: kind[]
          in: query
          description: Keep the affiliations of this kind.
          required: false
          deprecated: false
          schema:
            type: array
            items:
              type: string
              enum:
                - contractor
                - studio
                - parent_institution
          style: deepObject
          explode: true
      responses:
        '200':
          description: ArtistAffiliation collection
          content:
            application/vnd.api+json:
              schema:
                description: ArtistAffiliation.jsonapi collection.
                allOf:
                  - $ref: '#/components/schemas/JsonApiCollectionBaseSchema'
                  - type: object
                    properties:
                      data:
                        type: array
                        items:
                          $ref: >-
                            #/components/schemas/ArtistAffiliation.jsonapi.resource
                      included:
                        description: >-
                          Related resources requested via the "include" query
                          parameter.
                        type: array
                        items:
                          anyOf:
                            - $ref: '#/components/schemas/Artist.jsonapi.resource'
                            - $ref: >-
                                #/components/schemas/Organization.jsonapi.resource
                        readOnly: true
                        externalDocs:
                          url: https://jsonapi.org/format/#fetching-includes
          headers:
            RateLimit:
              $ref: '#/components/headers/RateLimit'
            RateLimit-Policy:
              $ref: '#/components/headers/RateLimit-Policy'
        '429':
          $ref: '#/components/responses/TooManyRequests'
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
    ArtistAffiliation.jsonapi.resource:
      type: object
      properties:
        id:
          type: string
        type:
          type: string
        attributes:
          type: object
          properties:
            _id:
              type: string
            kind:
              description: >-
                contractor: books the musicians; studio: the recording studio
                the ensemble works from; parent_institution: the broadcaster,
                opera house or other body the ensemble belongs to.
              example: contractor
              type: string
              enum:
                - contractor
                - studio
                - parent_institution
            position:
              description: Order among the artist's affiliations, from 0.
              default: 0
              example: 0
              type: integer
        relationships:
          type: object
          properties:
            artist:
              properties:
                data:
                  oneOf:
                    - type: 'null'
                    - type: object
                      properties:
                        type:
                          type: string
                        id:
                          type: string
                          format: iri-reference
                      required:
                        - type
                        - id
            organization:
              properties:
                data:
                  oneOf:
                    - type: 'null'
                    - type: object
                      properties:
                        type:
                          type: string
                        id:
                          type: string
                          format: iri-reference
                      required:
                        - type
                        - id
      required:
        - type
        - id
    Artist.jsonapi.resource:
      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
            slug:
              readOnly: true
              default: ''
              example: john-williams-4f9a1c
              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'
            fictional:
              description: >-
                Marks a character or a fictional band. MusicBrainz equivalents:
                person + fictional is a Character, group + fictional an ordinary
                Group. For a fictional artist, begin_date is the real-world date
                the character was created; end_date stays empty and in-fiction
                dates are never entered.
              default: false
              example: false
              type: boolean
            formation:
              description: >-
                How an orchestra or choir exists, left out while unknown and for
                persons and groups. `standing`: A permanent institution with its
                own season, members or employer, such as a symphony orchestra or
                a studio staff orchestra. `session`: A recurring pool of
                musicians booked for recordings under a stable brand name.
                `ad_hoc`: Assembled for a single project, with no recurring
                identity.
              example: session
              type:
                - string
                - 'null'
              enum:
                - standing
                - session
                - ad_hoc
                - 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
            affiliations:
              properties:
                data:
                  type: array
                  items:
                    type: object
                    properties:
                      type:
                        type: string
                      id:
                        type: string
                        format: iri-reference
                    required:
                      - type
                      - id
      required:
        - type
        - id
    Organization.jsonapi.resource:
      type: object
      properties:
        id:
          type: string
        type:
          type: string
        attributes:
          type: object
          properties:
            _id:
              example: f9e6ba0a-4ba0-48b8-b97e-bf54a3d4396f
              type: string
            name:
              example: Isobel Griffiths Ltd.
              type: string
            country:
              example: GB
              type:
                - string
                - 'null'
            slug:
              readOnly: true
              default: ''
              example: isobel-griffiths-ltd
              type: string
            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:
            affiliatedArtists:
              properties:
                data:
                  type: array
                  items:
                    type: object
                    properties:
                      type:
                        type: string
                      id:
                        type: string
                        format: iri-reference
                    required:
                      - type
                      - id
            parentOrganization:
              properties:
                data:
                  oneOf:
                    - type: 'null'
                    - type: object
                      properties:
                        type:
                          type: string
                        id:
                          type: string
                          format: iri-reference
                      required:
                        - type
                        - id
            childOrganizations:
              properties:
                data:
                  type: array
                  items:
                    type: object
                    properties:
                      type:
                        type: string
                      id:
                        type: string
                        format: iri-reference
                    required:
                      - type
                      - id
      required:
        - type
        - id
    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
          items:
            type: object
      required:
        - data
  headers:
    RateLimit:
      description: >-
        What each quota policy in force has left, and in how many seconds it
        admits another request.
      schema:
        type: string
      example: '"burst";r=9;t=1, "steady";r=287;t=43, "sustained";r=4711;t=2854'
    RateLimit-Policy:
      description: >-
        The quota policies in force: the requests each grants and the window it
        counts them over.
      schema:
        type: string
      example: '"burst";q=10;w=1, "steady";q=300;w=60, "sustained";q=5000;w=3600'
    Retry-After:
      description: Seconds to wait before the refused request is worth repeating.
      schema:
        type: integer
        minimum: 1
      example: 43
  responses:
    TooManyRequests:
      description: The request exceeded one of the quota policies in force.
      content:
        application/vnd.api+json:
          schema:
            type: object
            required:
              - errors
            properties:
              errors:
                type: array
                items:
                  type: object
                  required:
                    - status
                    - title
                    - detail
                  properties:
                    status:
                      type: string
                      enum:
                        - '429'
                    title:
                      type: string
                      enum:
                        - Rate Limit Exceeded
                    detail:
                      type: string
                      description: >-
                        Names the quota that refused the request and when its
                        window frees.
          example:
            errors:
              - status: '429'
                title: Rate Limit Exceeded
                detail: >-
                  You have exceeded the rate limit of 300 requests per 60
                  seconds. The budget resets at 2026-01-15T10:00:42+00:00.
      headers:
        RateLimit:
          $ref: '#/components/headers/RateLimit'
        RateLimit-Policy:
          $ref: '#/components/headers/RateLimit-Policy'
        Retry-After:
          $ref: '#/components/headers/Retry-After'
  securitySchemes:
    bearerAuth:
      type: http
      description: API token authentication
      scheme: bearer
      bearerFormat: JWT

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.