> ## Documentation Index
> Fetch the complete documentation index at: https://docs.spacemedia.uk/llms.txt
> Use this file to discover all available pages before exploring further.

# List Revenue Splits

> Access: organization users with revenue split permissions; admins see organization splits and end users see allowed splits.

List all Revenue Splits of the organization (If requested without X-User-Id header).



## OpenAPI

````yaml /api-reference/openapi.json get /api/v1/splits
openapi: 3.1.0
info:
  title: SpaceMedia Public API
  version: 1.0.0
  description: >-
    Production public API reference for SpaceMedia organization admins,
    permitted team members, end users, and API clients. The spec excludes
    SpaceMedia system/backoffice routes and cross-organization selectors.
  contact:
    name: SpaceMedia Support
    email: whitelabel@spacemedia.uk
    url: https://spacemedia.uk/contact
servers:
  - url: https://enterprise.spacemedia.uk
    description: Production
security:
  - bearerAuth: []
tags:
  - name: Authentication
    description: 'Access: API client credential flow.'
    x-mint:
      icon: key
  - name: Account Settings
    description: 'Access: authenticated organization user.'
    x-mint:
      icon: settings
  - name: Reference Data
    description: 'Access: authenticated organization users and API clients.'
    x-mint:
      icon: globe
  - name: Artists
    description: >-
      Access: organization users with artist permissions; `X-User-Id` may target
      a same-organization user where allowed.
    x-mint:
      icon: mic
  - name: Releases
    description: >-
      Access: organization users with release permissions; `X-User-Id` may
      target a same-organization user where allowed.
    x-mint:
      icon: disc
  - name: Tracks
    description: >-
      Access: organization users with track permissions; `X-User-Id` may target
      a same-organization user where allowed.
    x-mint:
      icon: music
  - name: Revenue Splits
    description: >-
      Access: organization users with revenue split permissions; admins see
      organization splits and end users see allowed splits.
    x-mint:
      icon: percent
  - name: User Management
    description: >-
      Access: organization admins or users allowed by user policies.
      Cross-organization selectors are excluded from this public spec.
    x-mint:
      icon: users
  - name: Plans & Upgrades
    description: >-
      Access: organization admins for plan lists; authenticated end users for
      upgrade options.
    x-mint:
      icon: package
  - name: Billing & Checkouts
    description: >-
      Access: authenticated organization users. Gateway availability depends on
      organization settings.
    x-mint:
      icon: credit-card
  - name: Add-On Management
    description: 'Access: organization admins for add-on checkout and lifecycle actions.'
    x-mint:
      icon: blocks
  - name: Copyright Management
    description: >-
      Access: organization admins or users with copyright wallet and release
      access. System-only provider and adjustment actions are excluded.
    x-mint:
      icon: shield-check
  - name: Quality Control
    description: 'Access: organization admins with release processing permission.'
    x-mint:
      icon: clipboard-check
paths:
  /api/v1/splits:
    get:
      tags:
        - Revenue Splits
      summary: List Revenue Splits
      description: >-
        Access: organization users with revenue split permissions; admins see
        organization splits and end users see allowed splits.


        List all Revenue Splits of the organization (If requested without
        X-User-Id header).
      operationId: getRevenueSplits
      parameters:
        - name: Accept
          in: header
          required: false
          description: Use `application/json` for API responses.
          schema:
            type: string
          example: application/json
        - name: Authorization
          in: header
          required: false
          description: Bearer access token. Use `Bearer <YOUR_ACCESS_TOKEN>`.
          schema:
            type: string
          example: Bearer <YOUR_ACCESS_TOKEN>
        - in: header
          name: X-User-Id
          description: >-
            Optional user UUID to perform the request on behalf of a user in the
            same organization.
          example: 42e6f4a8-9b12-4f7a-8c55-9d7f6a2b1234
          schema:
            type: string
        - name: search
          in: query
          required: false
          description: Search term scoped to the authenticated organization.
          schema:
            type: string
          example: midnight
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: object
                additionalProperties: true
              example:
                data:
                  - id: a99f63b8-7df7-4091-a0e0-f9327ff7c8d1
                    title: Midnight Signals Writer Share
                    percentage: 25
                    start_date: '2026-05-01T00:00:00+00:00'
                    end_date: '2026-12-31T00:00:00+00:00'
                    locked: false
                    beneficiary:
                      id: 83c09c76-32a5-4b1a-92fa-30129f8e8e6b
                      uuid: 83c09c76-32a5-4b1a-92fa-30129f8e8e6b
                      organization_id: 2a8d3e82-4a9d-4e33-9d3b-85bb1a93e8d4
                      organization_uuid: 2a8d3e82-4a9d-4e33-9d3b-85bb1a93e8d4
                      name: Eli Brooks
                      full_name: Eli Brooks
                      first_name: Eli
                      last_name: Brooks
                      email: eli.brooks@example.test
                      phone: '+442071838750'
                      language: en
                      country: United Kingdom
                      address: 22 Demo Lane, London
                      photo: null
                      profile_photo: null
                      verified: true
                      email_verified_at: '2026-04-10T08:15:00+00:00'
                      last_login_at: '2026-04-18T08:45:00+00:00'
                      created_at: '2026-03-20T09:00:00+00:00'
                      updated_at: '2026-04-18T08:45:00+00:00'
                      is_suspended: false
                      suspended_at: null
                      invitation_status: accepted
                      is_invited: false
                      roles:
                        - id: role-admin-demo
                          uuid: role-admin-demo
                          name: Admin
                    creator:
                      id: 9d7046b2-3ab1-4c9d-9bd8-90bbd22b7df2
                      uuid: 9d7046b2-3ab1-4c9d-9bd8-90bbd22b7df2
                      organization_id: 2a8d3e82-4a9d-4e33-9d3b-85bb1a93e8d4
                      organization_uuid: 2a8d3e82-4a9d-4e33-9d3b-85bb1a93e8d4
                      name: Maya Chen
                      full_name: Maya Chen
                      first_name: Maya
                      last_name: Chen
                      email: maya.chen@example.test
                      phone: '+442071838750'
                      language: en
                      country: United Kingdom
                      address: 22 Demo Lane, London
                      photo: null
                      profile_photo: null
                      verified: true
                      email_verified_at: '2026-04-10T08:15:00+00:00'
                      last_login_at: '2026-04-18T08:45:00+00:00'
                      created_at: '2026-03-20T09:00:00+00:00'
                      updated_at: '2026-04-18T08:45:00+00:00'
                      is_suspended: false
                      suspended_at: null
                      invitation_status: accepted
                      is_invited: false
                      roles:
                        - id: role-admin-demo
                          uuid: role-admin-demo
                          name: Admin
        '401':
          $ref: '#/components/responses/Unauthorized'
        '403':
          $ref: '#/components/responses/Forbidden'
        '404':
          $ref: '#/components/responses/NotFound'
        '422':
          $ref: '#/components/responses/ValidationError'
      security:
        - bearerAuth: []
components:
  responses:
    Unauthorized:
      description: Unauthorized
      content:
        application/json:
          example:
            success: false
            message: Missing bearer token
    Forbidden:
      description: Forbidden
      content:
        application/json:
          example:
            success: false
            message: This action is unauthorized.
    NotFound:
      description: Not found
      content:
        application/json:
          example:
            success: false
            message: Resource not found
    ValidationError:
      description: Validation error
      content:
        application/json:
          example:
            success: false
            message: Validation failed.
            errors:
              title:
                - The title field is required.
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: Sanctum token

````