# Retrieve Material List

Endpoint: GET /organisations/{orgId}/materials
Version: v2_28
Security: ApiKeyAuth

## Path parameters:

  - `orgId` (string, required)
    The organisation identity

## Query parameters:

  - `name` (string)

  - `category` (string)

  - `recordState` (string)
    Enum: "ACTIVE", "ARCHIVED"

  - `size` (integer)
    The number of elements to return in each page. Minimum value must be 1, defaults to 20.

  - `page` (integer)
    The pageNo to return. (Zero-based)

## Response 200 fields (application/json):

  - `content` (array, required)

  - `content.name` (string, required)
    The name of the material.

  - `content.scientificName` (string)
    This is the Scientific Name for this material. It is an optional field but is required for sbmission to the Traces NT system.

  - `content.commonName` (string)
    This is a Common Name for this material. It is an optional field but is required for sbmission to the Traces NT system.

  - `content.category` (string, required)
    The category for the material.

  - `content.recordState` (string)
    State of the record.
    Enum: "ACTIVE", "ARCHIVED"

  - `content.id` (string)
    System assigned or user defined id field.

  - `content.createdBy` (string)
    User who created the record.

  - `content.createdTime` (string)
    Date & Time that the record was created.

  - `content.updatedBy` (string)
    Last updated by user.

  - `content.updatedTime` (string)
    Date & Time that the record was last updated.

  - `page` (object, required)

  - `page.size` (integer, required)

  - `page.totalElements` (integer, required)

  - `page.totalPages` (integer, required)


## Response 401 fields

## Response 403 fields

## Response 429 fields

## Response 500 fields