List sites

GET

/api/sites

const url = 'http://localhost:3000/api/sites?page=1&sort=name&order=asc';
const options = {method: 'GET', headers: {cookie: 'session=<session>'}};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

curl --request GET \
  --url 'http://localhost:3000/api/sites?page=1&sort=name&order=asc' \
  --cookie session=<session>

Authorizations

cookieAuth

Parameters

Query Parameters

page

integer

default: 1 >= 1

Page number (1-based)

pageSize

integer

>= 1 <= 10000

Rows per page. Omitted = full table, capped at 10000.

search

string

Case-insensitive substring match across name, slug, facility, description

sort

string

Allowed values: name slug status createdAt

Sort column

order

string

Allowed values: asc desc

Sort direction

Responses

200

Success

application/json

object

data

required

Array<object>

object

required

string format: uuid

name

required

string

slug

string

nullable

status

required

string

Allowed values: active planned retired

regionId

string format: uuid

nullable

facility

string

nullable

latitude

Decimal degrees, numeric(9,6) serialised as string

string

nullable

longitude

Decimal degrees, numeric(9,6) serialised as string

string

nullable

description

string

nullable

createdAt

required

string format: date-time

updatedAt

required

string format: date-time

total

required

integer

page

required

integer

pageSize

required

integer

hasMore

required

boolean

Example

{
  "data": [
    {
      "status": "active"
    }
  ]
}

400

Invalid filter param

application/json

object

error

required

string

Example

{
  "error": "Not found"
}

401

Not authenticated

application/json

object

error

required

string

Example

{
  "error": "Not found"
}