Skip to content

List Resources

GET
/resources

Returns a paginated list of Resources in the current Space. Supports filtering by type, unit assignment, unassigned status, and text search. Each item includes assigned units and certificate count.

page
number
default: 1 >= 1
Example
1

Page number (1-based)

limit
number
default: 20 >= 1 <= 100
Example
20

Items per page (max 100)

sortDir
string
Allowed values: asc desc
Example
asc

Sort direction

search
string
Example
john

Search by name (case-insensitive)

type
string
Allowed values: person equipment environment substance
Example
person

Filter by resource type

unitId
string format: uuid
Example
550e8400-e29b-41d4-a716-446655440000

Filter by Unit ID

unassigned
boolean

If true, only resources not assigned to any unit

sortBy
string
Allowed values: name type certificateCount
Example
name

Sort field

X-Space-Id
required
string format: uuid

UUID of the target Space (tenant boundary). Validated against user access.

object
data
required
Array<object>
object
id
required

Resource ID

string format: uuid
Example
550e8400-e29b-41d4-a716-446655440000
name
required

Resource name

string
Example
John Smith
type
required

Resource type

string
Allowed values: person equipment environment substance
Example
person
units
required

Units this resource is assigned to

Array<object>
object
id
required

Unit ID

string format: uuid
Example
550e8400-e29b-41d4-a716-446655440000
name
required

Unit name

string
Example
Production Department
certificateCount
required

Number of certificates

number
Example
3
meta
required
object
page
required

Current page number

number
Example
1
limit
required

Items per page

number
Example
20
total
required

Total number of items

number
Example
42
totalPages
required

Total number of pages

number
Example
3

Unauthorized — missing or invalid JWT

Forbidden — insufficient permissions