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

# Read the affiliation graph around an artist or an organization

> Read the affiliation graph around an artist or an organization



## OpenAPI

````yaml /openapi.json get /api/affiliation-graph
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/affiliation-graph:
    get:
      tags:
        - AffiliationGraph
      summary: Read the affiliation graph around an artist or an organization
      description: Read the affiliation graph around an artist or an organization
      operationId: api_affiliation-graph_get
      parameters:
        - name: node
          in: query
          description: 'The start: artist:<uuid> or organization:<uuid>.'
          required: true
          deprecated: false
          schema:
            type: string
            pattern: >-
              ^(artist|organization):[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$
          style: form
          explode: true
        - name: depth
          in: query
          description: How many affiliations away to walk.
          required: false
          deprecated: false
          schema:
            type: integer
            minimum: 1
            maximum: 3
            default: 1
          style: form
          explode: true
      responses:
        '200':
          description: AffiliationGraph resource
          content:
            application/vnd.api+json:
              schema:
                $ref: '#/components/schemas/AffiliationGraph.jsonapi'
          headers:
            RateLimit:
              $ref: '#/components/headers/RateLimit'
            RateLimit-Policy:
              $ref: '#/components/headers/RateLimit-Policy'
        '400':
          description: >-
            node is missing or not artist:<uuid> or organization:<uuid>, or
            depth is not 1 to 3.
          headers:
            RateLimit:
              $ref: '#/components/headers/RateLimit'
            RateLimit-Policy:
              $ref: '#/components/headers/RateLimit-Policy'
        '404':
          description: No artist or organization has that id.
          headers:
            RateLimit:
              $ref: '#/components/headers/RateLimit'
            RateLimit-Policy:
              $ref: '#/components/headers/RateLimit-Policy'
        '429':
          $ref: '#/components/responses/TooManyRequests'
components:
  schemas:
    AffiliationGraph.jsonapi:
      type: object
      properties:
        data:
          $ref: '#/components/schemas/AffiliationGraph.jsonapi.resource'
    AffiliationGraph.jsonapi.resource:
      type: object
      properties:
        id:
          type: string
        type:
          type: string
        attributes:
          type: object
          properties:
            nodes:
              type: array
              items:
                type: object
                properties:
                  type:
                    type: string
                    enum:
                      - artist
                      - organization
                  id:
                    type: string
                    format: uuid
                  name:
                    type: string
                  slug:
                    type: string
                  depth:
                    type: integer
                    minimum: 0
            edges:
              type: array
              items:
                type: object
                properties:
                  from:
                    type: string
                    example: artist:5e3f8a2c-1b4d-4c6e-9f70-2a8b3c4d5e6f
                  to:
                    type: string
                    example: organization:f9e6ba0a-4ba0-48b8-b97e-bf54a3d4396f
                  kind:
                    type: string
                    enum:
                      - contractor
                      - studio
                      - parent_institution
                  derived:
                    type: boolean
      required:
        - type
        - id
  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.