> ## 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 a CollectionItem resource.

> Retrieves a CollectionItem resource.



## OpenAPI

````yaml /openapi.json get /api/users/{userId}/collection/{id}
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/users/{userId}/collection/{id}:
    get:
      tags:
        - CollectionItem
      summary: Retrieves a CollectionItem resource.
      description: Retrieves a CollectionItem resource.
      operationId: api_users_userIdcollection_id_get
      parameters:
        - name: userId
          in: path
          description: UserResource identifier
          required: true
          deprecated: false
          schema:
            type: string
          style: simple
          explode: false
        - name: id
          in: path
          description: CollectionItem identifier
          required: true
          deprecated: false
          schema:
            type: string
          style: simple
          explode: false
      responses:
        '200':
          description: CollectionItem resource
          content:
            application/vnd.api+json:
              schema:
                $ref: '#/components/schemas/CollectionItem.jsonapi'
        '403':
          description: Forbidden
          content:
            application/vnd.api+json:
              schema:
                $ref: '#/components/schemas/Error.jsonapi'
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error'
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          links: {}
        '404':
          description: Not found
          content:
            application/vnd.api+json:
              schema:
                $ref: '#/components/schemas/Error.jsonapi'
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error'
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          links: {}
components:
  schemas:
    CollectionItem.jsonapi:
      properties:
        data:
          type: object
          properties:
            id:
              type: string
            type:
              type: string
            attributes:
              type: object
              properties:
                _id:
                  example: 11111111-1111-1111-1111-111111111111
                  type: string
                condition:
                  example: mint
                  type:
                    - string
                    - 'null'
                  enum:
                    - mint
                    - near_mint
                    - very_good_plus
                    - very_good
                    - good
                    - good_plus
                    - poor
                    - fair
                    - sealed
                    - null
                status:
                  example: active
                  type: string
                  enum:
                    - ordered
                    - active
                purchased_at:
                  example: '2024-06-15T00:00:00+00:00'
                  type:
                    - string
                    - 'null'
                shop:
                  example: Amazon
                  type:
                    - string
                    - 'null'
                notes:
                  example: First pressing
                  type:
                    - string
                    - 'null'
                purchase_price_cents:
                  example: 2499
                  type:
                    - integer
                    - 'null'
                currency:
                  example: USD
                  type:
                    - string
                    - 'null'
                  enum:
                    - EUR
                    - USD
                    - GBP
                    - CHF
                    - null
                storage_location:
                  example: Shelf A3
                  type:
                    - string
                    - 'null'
                is_signed:
                  default: false
                  example: false
                  type: boolean
                quantity:
                  default: 1
                  example: 1
                  type: integer
                order_date:
                  type:
                    - string
                    - 'null'
                order_price_cents:
                  type:
                    - integer
                    - 'null'
                order_vendor:
                  type:
                    - string
                    - 'null'
                format_type:
                  default: physical
                  example: physical
                  type: string
                release:
                  example:
                    id: 2792425e-5267-11e7-ae76-fa163ef5db36
                    title: Jurassic Park
                    slug: jurassic-park
                  type: object
                  additionalProperties:
                    type:
                      - string
                      - 'null'
                created_at:
                  example: '2024-06-15T10:00:00+00:00'
                  type:
                    - string
                    - 'null'
                updated_at:
                  example: '2024-06-15T14:30:00+00:00'
                  type:
                    - string
                    - 'null'
          required:
            - type
            - id
    Error.jsonapi:
      properties:
        errors:
          type: array
          items:
            allOf:
              - $ref: '#/components/schemas/Error'
              - type: object
                properties:
                  source:
                    type: object
                  status:
                    type:
                      - string
                      - integer
                      - 'null'
    Error:
      type: object
      description: A representation of common errors.
      properties:
        id:
          type:
            - string
            - 'null'
        title:
          readOnly: true
          description: A short, human-readable summary of the problem.
          type:
            - string
            - 'null'
        detail:
          readOnly: true
          description: >-
            A human-readable explanation specific to this occurrence of the
            problem.
          type:
            - string
            - 'null'
        status:
          type:
            - integer
            - 'null'
          examples:
            - 404
          default: 400
        instance:
          readOnly: true
          description: >-
            A URI reference that identifies the specific occurrence of the
            problem. It may or may not yield further information if
            dereferenced.
          type:
            - string
            - 'null'
        type:
          readOnly: true
          description: A URI reference that identifies the problem type
          type: string
        meta:
          type: object
        source:
          type: object
          properties:
            pointer:
              type: string
            parameter:
              type: string
            header:
              type: string
  securitySchemes:
    bearerAuth:
      type: http
      description: API token authentication
      scheme: bearer
      bearerFormat: JWT

````