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

> Retrieves the collection of CollectionItem resources.



## OpenAPI

````yaml /openapi.json get /api/me/collection
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/me/collection:
    get:
      tags:
        - CollectionItem
      summary: Retrieves the collection of CollectionItem resources.
      description: Retrieves the collection of CollectionItem resources.
      operationId: my_collection
      parameters:
        - name: status
          in: query
          description: >-
            Filter collection items by a single status value. Unsupported values
            (including the legacy lent_out / sold) return 400. May gain
            multi-value support later without a breaking change.
          required: false
          deprecated: false
          schema:
            type: string
            enum:
              - ordered
              - active
          style: form
          explode: true
        - name: page
          in: query
          description: The collection page number
          required: false
          deprecated: false
          schema:
            type: integer
            default: 1
          style: form
          explode: true
      responses:
        '200':
          description: CollectionItem collection
          content:
            application/vnd.api+json:
              schema:
                description: CollectionItem.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: 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
        '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: {}
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
    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
    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

````