Decisiv Case Line Items API

openapi: 3.2.0
info:
  version: 0.48.24
  termsOfService: https://www.decisiv.com/terms-of-use
  contact:
    name: Decisiv Support
    email: support@decisiv.com
    url: https://www.decisiv.com
  title: Service Management Case Line Items API
  description: The **Decisiv SRM Gateway** `Service Management` module provides the API functionality for managing an asset's case lifecycle from a Service Providers perspective.
  license:
    name: Proprietary
    identifier: proprietary
    url: https://www.decisiv.com/terms-of-use/
servers:
- url: https://srm-api.staging.decisivapps.com
- url: https://srm-api.decisivapps.com
security:
- OAuth2AuthorizationCode: []
  AccessToken: []
- OAuth2Password: []
  AccessToken: []
tags:
- name: Case Line Items
paths:
  /service_management/{srm_account_id}/v1/cases/{case_id}/line_items:
    get:
      summary: List line items for the requested case
      operationId: listCaseLineItems
      description: 'A line item represents a single operation on the case — the atomic complaint/cause/correction unit billed against it, carrying labor, parts, and VMRS coding.

        '
      tags:
      - Case Line Items
      parameters:
      - name: srm_account_id
        in: path
        description: The account ID for SRM
        required: true
        schema:
          type: string
      - name: case_id
        in: path
        schema:
          type: string
          format: uuid
        description: The case UUID
        required: true
      - name: include
        in: query
        required: false
        schema:
          type: array
          items:
            type: string
            enum:
            - parts
            - technician_stories
            - assignee
        description: The relationships to be included.
      - name: filter[assignee.id]
        in: query
        required: false
        schema:
          type: string
          format: uuid
        description: Filter line items assigned to the user with the given assignee id (the id segment of the assignee's user URI).
      - name: filter[assignee.id:includes]
        in: query
        required: false
        schema:
          type: string
        description: Filter line items assigned to any of the given assignee ids. Accepts a comma-separated list of up to 50 ids.
      - name: filter[assignee.id:excludes]
        in: query
        required: false
        schema:
          type: string
        description: Filter line items excluding those assigned to any of the given assignee ids. Accepts a comma-separated list of up to 50 ids.
      - name: page[number]
        in: query
        required: false
        schema:
          type: integer
          default: 1
          minimum: 1
        description: Sets the desired `page` when encountering larger result sets
      - name: page[size]
        in: query
        required: false
        schema:
          type: integer
          default: 25
          minimum: 1
        description: Sets the desired maximum number of results per page
      responses:
        '200':
          description: Returns list of line items for the case
          content:
            application/vnd.api+json:
              example:
                data:
                - id: ba889598-5f26-4481-90f7-2c172d42ca5f
                  type: line_items
                  attributes:
                    complaint: CEL on
                    cause: Diagnostic check required
                    correction: Reset Diagnostics
                    opcode: T3789-0-04
                    price_code: SR37TYP
                    name: Air Dryer Cartridge, Replacement
                    description: All Engines All Years All Models All Makes for Air Dryer Cartridge, Replacement, Description
                    labor:
                      time: 2
                      skill_level: A
                    pricing:
                      estimated_total: '300.00'
                      fixed_total: null
                      labor:
                        estimated_total: '140.00'
                        fixed_total: null
                      parts:
                        estimated_total: '140.00'
                      core_price:
                        estimated_total: '20.00'
                      additional_charges:
                        estimated_total: '450.0'
                    paint:
                      time: 1.5
                      rate: 95
                      total: 142.5
                      skill_level: P1
                    billing_classification: warranty
                    under_warranty: true
                    approval_group_tag: GROUP-A
                    vmrs:
                      reason_for_repair:
                        code_key: '14'
                        code: '01'
                      component:
                        code_key: '33'
                        code: 023-000-000
                      position:
                        code_key: '79'
                        code: '03'
                      operator_report:
                      - code_key: '82'
                        code: '001'
                      - code_key: '82'
                        code: '002'
                      technician_failure:
                        code_key: '18'
                        code: B1
                      work_accomplished:
                        code_key: '15'
                        code: A
                    work_status:
                      code: start
                      reason: awaiting_parts
                      timestamp: '2026-06-22T14:30:00Z'
                      set_by_user:
                        id: 6383dc89-05b6-4572-8979-a6257f3597ec
                        name: Jordan Tech
                    approval_status:
                      name: approved
                      reason: labor_cost
                      reason_description: Approved after review
                      reviewed_by:
                        id: 6383dc89-05b6-4572-8979-a6257f3597ec
                        name: Pat Reviewer
                      reviewed_at: '2026-06-22T15:00:00Z'
                    internal_label: approved
                  relationships:
                    parts:
                      data:
                      - type: line_item_parts
                        id: 167f089e-339d-4d05-b175-9b10206c3cbf
                    technician_stories:
                      data:
                      - type: technician_stories
                        id: b2610b45-a2e1-4abf-ad21-7f820bca4923
              schema:
                $ref: '#/components/schemas/line_items'
        '400':
          description: Invalid request.
          content:
            application/vnd.api+json:
              example:
                errors:
                - title: Filter not allowed
                  detail: '''{{filter_name}}'' is not allowed. Valid filters: {{filters_list}}'
                  code: decisiv:filters:001
                  status: '400'
                  source:
                    parameter: filter[filter_name]
              schema:
                $ref: '#/components/schemas/errors_response'
        '401':
          description: This response may occur when the access token provided within the Authorization token has expired.
          content:
            application/vnd.api+json:
              example:
                errors:
                - title: Access unauthorized
                  detail: Access unauthorized
                  code: decisiv::access_token:001
                  status: '401'
              schema:
                $ref: '#/components/schemas/errors_response'
        '403':
          description: This response may occur when the authenticated user embedded within the Authorization header does not have access to the requested resource.
          content:
            application/vnd.api+json:
              example:
                errors:
                - title: Forbidden
                  detail: User does not have permission to perform this action on the requested resource(s)
                  code: decisiv:access:001
                  status: '403'
              schema:
                $ref: '#/components/schemas/errors_response'
        '424':
          description: This response may occur when there is an unresolved data dependency or configuration required inside of the Decisiv Platform preventing access to the requested action.
          content:
            application/vnd.api+json:
              example:
                errors:
                - title: Failed Dependency
                  detail: Failed Dependency
                  code: '424'
                  status: '424'
              schema:
                $ref: '#/components/schemas/errors_response'
        '504':
          description: This response may occur when there is an unexpected system timeout.
          content:
            application/vnd.api+json:
              example:
                errors:
                - code: '504'
                  detail: Gateway timeout error
                  status: '504'
                  title: Gateway timeout error
              schema:
                $ref: '#/components/schemas/errors_response'
    post:
      summary: Create a line item for the requested case
      operationId: createCaseLineItem
      description: 'A line item represents a single operation on the case; multiple may exist per case.

        '
      tags:
      - Case Line Items
      parameters:
      - name: srm_account_id
        in: path
        description: The account ID for SRM
        required: true
        schema:
          type: string
      - name: case_id
        in: path
        schema:
          type: string
          format: uuid
        description: The case UUID
        required: true
      responses:
        '201':
          description: Successful creation of line item
          content:
            application/vnd.api+json:
              example:
                data:
                  id: ba889598-5f26-4481-90f7-2c172d42ca5f
                  type: line_items
                  attributes:
                    complaint: CEL on
                    cause: Diagnostic check required
                    correction: Reset Diagnostics
                    opcode: T3789-0-04
                    price_code: SR37TYP
                    name: Air Dryer Cartridge, Replacement
                    description: All Engines All Years All Models All Makes for Air Dryer Cartridge, Replacement, Description
                    labor:
                      time: 2
                      skill_level: A
                    pricing:
                      estimated_total: '300.00'
                      fixed_total: null
                      labor:
                        estimated_total: '140.00'
                        fixed_total: null
                      parts:
                        estimated_total: '140.00'
                      core_price:
                        estimated_total: '20.00'
                      additional_charges:
                        estimated_total: '450.0'
                    paint:
                      time: 1.5
                      rate: 95
                      total: 142.5
                      skill_level: P1
                    billing_classification: warranty
                    under_warranty: true
                    approval_group_tag: GROUP-A
                    vmrs:
                      reason_for_repair:
                        code_key: '14'
                        code: '01'
                      component:
                        code_key: '33'
                        code: 023-000-000
                      position:
                        code_key: '79'
                        code: '03'
                      operator_report:
                      - code_key: '82'
                        code: '001'
                      - code_key: '82'
                        code: '002'
                      technician_failure:
                        code_key: '18'
                        code: B1
                      work_accomplished:
                        code_key: '15'
                        code: A
                    work_status:
                      code: start
                      reason: awaiting_parts
                      timestamp: '2026-06-22T14:30:00Z'
                      set_by_user:
                        id: 6383dc89-05b6-4572-8979-a6257f3597ec
                        name: Jordan Tech
                    approval_status:
                      name: approved
                      reason: labor_cost
                      reason_description: Approved after review
                      reviewed_by:
                        id: 6383dc89-05b6-4572-8979-a6257f3597ec
                        name: Pat Reviewer
                      reviewed_at: '2026-06-22T15:00:00Z'
                    internal_label: approved
                  relationships:
                    parts:
                      data:
                      - type: line_item_parts
                        id: 167f089e-339d-4d05-b175-9b10206c3cbf
                    technician_stories:
                      data:
                      - type: technician_stories
                        id: b2610b45-a2e1-4abf-ad21-7f820bca4923
              schema:
                $ref: '#/components/schemas/line_item'
        '401':
          description: This response may occur when the access token provided within the Authorization token has expired.
          content:
            application/vnd.api+json:
              example:
                errors:
                - title: Access unauthorized
                  detail: Access unauthorized
                  code: decisiv::access_token:001
                  status: '401'
              schema:
                $ref: '#/components/schemas/errors_response'
        '403':
          description: This response may occur when the authenticated user embedded within the Authorization header does not have access to the requested resource.
          content:
            application/vnd.api+json:
              example:
                errors:
                - title: Forbidden
                  detail: User does not have permission to perform this action on the requested resource(s)
                  code: decisiv:access:001
                  status: '403'
              schema:
                $ref: '#/components/schemas/errors_response'
        '404':
          description: This response may occur when the requested resource is not found.
          content:
            application/vnd.api+json:
              example:
                errors:
                - status: '404'
                  code: decisiv:resource:001
                  title: Resource Identifier - Not Found
                  detail: The parent resource could not be found
                  source:
                    parameter: id
              schema:
                $ref: '#/components/schemas/errors_response'
        '422':
          description: Attribute value rejected by validation.
          content:
            application/vnd.api+json:
              schema:
                $ref: '#/components/schemas/errors_response'
              examples:
                Invalid internal_label value:
                  value:
                    errors:
                    - status: '422'
                      code: decisiv:request_attributes:010
                      title: Invalid Attribute Value
                      detail: Invalid internal_label value provided
                      source:
                        pointer: /data/attributes/internal_label
                      links:
                        about: https://decisiv.net/service_management/SRM_ACCOUNT/v1/line_item_internal_labels
        '504':
          description: This response may occur when there is an unexpected system timeout.
          content:
            application/vnd.api+json:
              example:
                errors:
                - code: '504'
                  detail: Gateway timeout error
                  status: '504'
                  title: Gateway timeout error
              schema:
                $ref: '#/components/schemas/errors_response'
      requestBody:
        content:
          application/vnd.api+json:
            schema:
              $ref: '#/components/schemas/create_line_item'
            examples:
              Create Line Item:
                value:
                  data:
                    type: line_items
                    attributes:
                      complaint: things are broken in the asset
                      cause: bad use from the owner
                      correction: Fix it all
                      opcode: OPCODE
                      price_code: PriceCode
                      name: Change Engine
                      description: Description
                      internal_label: approved
                      approval_group_tag: GROUP-A
                      billing_classification: warranty
                      labor:
                        time: 3.5
                        skill_level: A
                        rate: 100
                        total: 350
                      approval_status:
                        name: approved
                        reason: labor_cost
                        reason_description: Approved after review
                      vmrs:
                        work_accomplished:
                          code: A
                        technician_failure:
                          code: B1
                        component:
                          code: 023-000-000
                        position:
                          code: '03'
                        operator_report:
                        - code: '001'
                    relationships:
                      assignee:
                        data:
                          type: internal_users
                          id: 6383dc89-05b6-4572-8979-a6257f3597ec
  /service_management/{srm_account_id}/v1/cases/{case_id}/line_items/{id}:
    get:
      summary: Retrieve a line item for the requested case
      operationId: getCaseLineItem
      description: Retrieve a single line item.
      tags:
      - Case Line Items
      parameters:
      - name: srm_account_id
        in: path
        description: The account ID for SRM
        required: true
        schema:
          type: string
      - name: case_id
        in: path
        schema:
          type: string
          format: uuid
        description: The case UUID
        required: true
      - name: id
        in: path
        schema:
          type: string
          format: uuid
        description: The resource UUID
        required: true
      - name: include
        in: query
        required: false
        schema:
          type: array
          items:
            type: string
            enum:
            - parts
            - technician_stories
            - assignee
        description: The relationships to be included.
      responses:
        '200':
          description: Show details for requested Line Item
          content:
            application/vnd.api+json:
              example:
                data:
                  id: ba889598-5f26-4481-90f7-2c172d42ca5f
                  type: line_items
                  attributes:
                    complaint: CEL on
                    cause: Diagnostic check required
                    correction: Reset Diagnostics
                    opcode: T3789-0-04
                    price_code: SR37TYP
                    name: Air Dryer Cartridge, Replacement
                    description: All Engines All Years All Models All Makes for Air Dryer Cartridge, Replacement, Description
                    labor:
                      time: 2
                      skill_level: A
                    pricing:
                      estimated_total: '300.00'
                      fixed_total: null
                      labor:
                        estimated_total: '140.00'
                        fixed_total: null
                      parts:
                        estimated_total: '140.00'
                      core_price:
                        estimated_total: '20.00'
                      additional_charges:
                        estimated_total: '450.0'
                    paint:
                      time: 1.5
                      rate: 95
                      total: 142.5
                      skill_level: P1
                    billing_classification: warranty
                    under_warranty: true
                    approval_group_tag: GROUP-A
                    vmrs:
                      reason_for_repair:
                        code_key: '14'
                        code: '01'
                      component:
                        code_key: '33'
                        code: 023-000-000
                      position:
                        code_key: '79'
                        code: '03'
                      operator_report:
                      - code_key: '82'
                        code: '001'
                      - code_key: '82'
                        code: '002'
                      technician_failure:
                        code_key: '18'
                        code: B1
                      work_accomplished:
                        code_key: '15'
                        code: A
                    work_status:
                      code: start
                      reason: awaiting_parts
                      timestamp: '2026-06-22T14:30:00Z'
                      set_by_user:
                        id: 6383dc89-05b6-4572-8979-a6257f3597ec
                        name: Jordan Tech
                    approval_status:
                      name: approved
                      reason: labor_cost
                      reason_description: Approved after review
                      reviewed_by:
                        id: 6383dc89-05b6-4572-8979-a6257f3597ec
                        name: Pat Reviewer
                      reviewed_at: '2026-06-22T15:00:00Z'
                    internal_label: approved
                  relationships:
                    parts:
                      data:
                      - type: line_item_parts
                        id: 167f089e-339d-4d05-b175-9b10206c3cbf
                    technician_stories:
                      data:
                      - type: technician_stories
                        id: b2610b45-a2e1-4abf-ad21-7f820bca4923
              schema:
                $ref: '#/components/schemas/line_item'
        '400':
          description: Invalid request.
          content:
            application/vnd.api+json:
              example:
                errors:
                - title: Filter not allowed
                  detail: '''{{filter_name}}'' is not allowed. Valid filters: {{filters_list}}'
                  code: decisiv:filters:001
                  status: '400'
                  source:
                    parameter: filter[filter_name]
              schema:
                $ref: '#/components/schemas/errors_response'
        '401':
          description: This response may occur when the access token provided within the Authorization token has expired.
          content:
            application/vnd.api+json:
              example:
                errors:
                - title: Access unauthorized
                  detail: Access unauthorized
                  code: decisiv::access_token:001
                  status: '401'
              schema:
                $ref: '#/components/schemas/errors_response'
        '403':
          description: This response may occur when the authenticated user embedded within the Authorization header does not have access to the requested resource.
          content:
            application/vnd.api+json:
              example:
                errors:
                - title: Forbidden
                  detail: User does not have permission to perform this action on the requested resource(s)
                  code: decisiv:access:001
                  status: '403'
              schema:
                $ref: '#/components/schemas/errors_response'
        '404':
          description: This response may occur when the requested resource is not found.
          content:
            application/vnd.api+json:
              example:
                errors:
                - title: Record not found
                  detail: The requested record or one of its relationships could not be found
                  code: '404'
                  status: '404'
              schema:
                $ref: '#/components/schemas/errors_response'
        '424':
          description: This response may occur when there is an unresolved data dependency or configuration required inside of the Decisiv Platform preventing access to the requested action.
          content:
            application/vnd.api+json:
              example:
                errors:
                - title: Failed Dependency
                  detail: Failed Dependency
                  code: '424'
                  status: '424'
              schema:
                $ref: '#/components/schemas/errors_response'
        '504':
          description: This response may occur when there is an unexpected system timeout.
          content:
            application/vnd.api+json:
              example:
                errors:
                - code: '504'
                  detail: Gateway timeout error
                  status: '504'
                  title: Gateway timeout error
              schema:
                $ref: '#/components/schemas/errors_response'
    patch:
      summary: Update a line item for the requested case
      operationId: updateCaseLineItem
      description: 'Reassigning the line item''s `assignee` is not supported on this endpoint.

        '
      tags:
      - Case Line Items
      parameters:
      - name: srm_account_id
        in: path
        description: The account ID for SRM
        required: true
        schema:
          type: string
      - name: case_id
        in: path
        schema:
          type: string
          format: uuid
        description: The case UUID
        required: true
      - name: id
        in: path
        schema:
          type: string
          format: uuid
        description: The resource UUID
        required: true
      responses:
        '200':
          description: Successful update of line item
          content:
            application/vnd.api+json:
              example:
                data:
                  type: line_items
                  id: ba889598-5f26-4481-90f7-2c172d42ca5f
                  attributes:
                    complaint: things are broken in the asset
                    cause: bad use from the owner
                    correction: Fix it all
                    opcode: OPCODE
                    price_code: PriceCode
                    name: Change Engine
                    description: Description
                    internal_label: approved
                    approval_group_tag: GROUP-A
                    billing_classification: policy
                    under_warranty: false
                    labor:
                      time: 3.5
                      skill_level: A
                    paint:
                      time: 1.5
                      rate: 95
                      total: 142.5
                      skill_level: P1
                    work_status:
                      code: complete
                      reason: null
                      timestamp: '2026-06-22T16:00:00Z'
                      set_by_user:
                        id: 6383dc89-05b6-4572-8979-a6257f3597ec
                        name: Jordan Tech
                    approval_status:
                      name: declined
                      reason: parts_costs
                      reason_description: Customer declined parts cost
                      reviewed_by:
                        id: 6383dc89-05b6-4572-8979-a6257f3597ec
                        name: Pat Reviewer
                      reviewed_at: '2026-06-22T16:00:00Z'
              schema:
                $ref: '#/components/schemas/line_item'
        '400':
          description: Invalid request.
          content:
            application/vnd.api+json:
              schema:
                $ref: '#/components/schemas/errors_response'
              examples:
                Invalid Alpha Numeric:
                  value:
                    errors:
                    - status: '400'
                      code: decisiv:request_attributes:010
                      title: Invalid Attribute Value
                      detail: Invalid skill_level value provided - must be a valid alphanumeric value
                      source:
                        pointer: /data/attributes/labor/skill_level
                Not Found Skill Level:
                  value:
                    errors:
                    - status: '400'
                      code: decisiv:request_attributes:010
                      title: Invalid Attribute Value
                      detail: Invalid skill_level value provided - must exist for the namespaced SRM Account
                      source:
                        pointer: /data/attributes/labor/skill_level
                      links:
                        about: https://decisiv.net/service_management/SRM_ACCOUNT/v1/skill_levels
        '401':
          description: This response may occur when the access token provided within the Authorization token has expired.
          content:
            application/vnd.api+json:
              example:
                errors:
                - title: Access unauthorized
                  detail: Access unauthorized
                  code: decisiv::access_token:001
                  status: '401'
              schema:
                $ref: '#/components/schemas/errors_response'
        '403':
          description: This response may occur when the authenticated user embedded within the Authorization header does not have access to the requested resource.
          content:
            application/vnd.api+json:
              example:
                errors:
                - title: Forbidden
                  detail: User does not have permission to perform this action on the requested resource(s)
                  code: decisiv:access:001
                  status: '403'
              schema:
                $ref: '#/components/schemas/errors_response'
        '404':
          description: This response may occur when the requested resource is not found.
          content:
            application/vnd.api+json:
              example:
                errors:
                - status: '404'
                  code: decisiv:resource:001
                  title: Resource Identifier - Not Found
                  detail: The parent resource could not be found
                  source:
                    parameter: id
              schema:
                $ref: '#/components/schemas/errors_response'
        '422':
          description: Attribute value rejected by validation.
          content:
            application/vnd.api+json:
              schema:
                $ref: '#/components/schemas/errors_response'
              examples:
                Invalid internal_label value:
                  value:
                    errors:
                    - status: '422'
                      code: decisiv:request_attributes:010
                      title: Invalid Attribute Value
                      detail: Invalid internal_label value provided
                      source:
                        pointer: /data/attributes/internal_label
                      links:
                        about: https://decisiv.net/service_management/SRM_ACCOUNT/v1/line_item_internal_labels
        '504':
          description: This response may occur when there is an unexpected system timeout.
          content:
            application/vnd.api+json:
              example:
                errors:
                - code: '504'
                  detail: Gateway timeout error
                  status: '504'
                  title: Gateway timeout error
              schema:
                $ref: '#/components/schemas/errors_response'
      requestBody:
        content:
          application/vnd.api+json:
            schema:
              $ref: '#/components/schemas/update_line_item'
            examples:
              Update Line Item:
                value:
                  data:
                    type: line_items
                    id: ba88

# --- truncated at 32 KB (90 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/decisiv/refs/heads/main/openapi/decisiv-case-line-items-api-openapi.yml