---
title: "List all Job Materials"
method: GET
path: "/jobmaterial.json"
tags: ["Job Materials"]
---

# List all Job Materials

`GET /jobmaterial.json`

#### Filtering
This endpoint supports result filtering. For more information on how to filter this request, [go here](/docs/filtering).
			
			
#### OAuth Scope
This endpoint requires the following OAuth scope **read_job_materials**.

## Response `200`

An array of Job Materials

- JobMaterial[]
  - `job_uuid` string, 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_uuid` string, 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.
  - `name` string — 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.
  - `quantity` string, required — The quantity of this material used on the job. This field is mandatory and cannot be empty.
  - `price` string — 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_amount` string — 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_inclusive` string — 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_uuid` string, uuid — The UUID of the tax rate applied to this job material. Determines how tax is calculated for this specific line item.
  - `sort_order` string — 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.
  - `cost` string — The cost of the material for this job. This is the ex-tax amount.
  - `displayed_cost` string — The cost of the material for this job, displayed as inc-tax or ex-tax depending on jobMaterial.displayed_amount_is_tax_inclusive.
  - `uuid` string, uuid — Unique identifier for this record
  - `active` 0 | 1 — Record active/deleted flag. Valid values are [0,1]
  - `edit_date` string — Timestamp at which record was last modified
  - `job_material_bundle_uuid` string, 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.

## Other responses

- `400` — Bad Request - The request is malformed or contains invalid parameters
- `401` — Unauthorized - Authentication credentials are missing or invalid
- `403` — Forbidden - You don't have permission to access this resource
- `429` — Too Many Requests - You have exceeded the rate limit
- `500` — Internal Server Error - An unexpected error occurred on the server

---

[API](https://skmtc.net/servicem8/apis/servicem8-api.md) · [All operations](https://skmtc.net/servicem8/apis/servicem8-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/servicem8/servicem8-api/versions/53ede60e3653/schema)