Job Materials

Retrieve a Job Material

Changed on

OAuth Scope

This endpoint requires the following OAuth scope read_job_materials.

get/jobmaterial/{uuid}.json

Request

  • Base URL
    https://api.servicem8.com/api_1.0
  • URL
    https://api.servicem8.com/api_1.0/jobmaterial/{uuid}.json
  • Auth
    • API key in header X-Api-Key
    • or OAuth 2
      Authorization code: https://api.servicem8.com/oauth/authorize
      Token URL: https://api.servicem8.com/oauth/access_token scopes: read_job_materials

Path parameters

uuidstring uuid required

UUID of the Job Material

Response

Job Material record retrieved successfully

job_uuidstring uuid

The UUID of the job this material is associated with. This is a required field that establishes the relationship between the job material and its parent job.

material_uuidstring uuid

The UUID of the material catalog item this job material is based on. Links the job material to the corresponding material in the materials catalog.

namestring

The name of the material item used on the job. This is displayed on invoices and is used to identify the material to the customer. The name typically comes from the associated material object but can be customized per job.

quantitystring required

The quantity of this material used on the job. This field is mandatory and cannot be empty.

pricestring

The unit price of the material excluding tax. Used in calculations to determine the total price for this line item on the job. The system may automatically adjust this value to maintain consistency with tax-inclusive pricing.

displayed_amountstring

The unit price amount as displayed on invoices and quotes. This can be either tax-inclusive or tax-exclusive depending on the displayed_amount_is_tax_inclusive field value. Used for presentation to customers.

displayed_amount_is_tax_inclusivestring

Boolean flag indicating whether the displayed_amount includes tax (true) or excludes tax (false). This controls how prices are presented to customers and determines which price value (inclusive or exclusive) is used in calculations.

tax_rate_uuidstring uuid

The UUID of the tax rate applied to this job material. Determines how tax is calculated for this specific line item.

sort_orderstring

Integer value controlling the display order of materials on a job. Lower values appear first in lists. Used to customize the presentation order of materials on quotes, invoices and job forms.

coststring

The cost of the material for this job. This is the ex-tax amount.

displayed_coststring

The cost of the material for this job, displayed as inc-tax or ex-tax depending on jobMaterial.displayed_amount_is_tax_inclusive.

uuidstring uuid

Unique identifier for this record

active0 | 1

Record active/deleted flag. Valid values are [0,1]

edit_datestring

Timestamp at which record was last modified

job_material_bundle_uuidstring uuid

UUID of a JobMaterialBundle which this JobMaterial belongs to. The default value is blank, which means that the JobMaterial is not part of a JobMaterialBundle.

Example response

{
  "job_uuid": "123e4567-9539-4f05-ba2e-23f943147fab",
  "material_uuid": "123e4567-6664-44df-8cc2-23f94cbf8a9b",
  "tax_rate_uuid": "123e4567-a746-4be2-bd00-23f949815b5b",
  "uuid": "123e4567-be6b-4a92-a2d6-23f94483836b",
  "edit_date": "2026-03-01 12:00:00",
  "job_material_bundle_uuid": "123e4567-50da-46fd-9a5e-23f941ffeacb"
}

Changes

  • ca9b053c4373Revision changes
    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status