Documentation Powered by Redocly

Trap.NZ API (development)

Download OpenAPI specification:Download

API for Trap.NZ

Organisations

A top-level organisation on Trap.NZ

Get organisations

Authorizations:
trap_auth
query Parameters
changed_since
string <date-time>

Only return entities changed since this date.

changed_since_uuid
string <uuid>

Only return entities changed since this UUID, if the date is equal to changed_since.

limit
integer [ 1 .. 100000 ]
Default: 1000

Only return up to this many entities. Tentatively limited to 100,000.

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Get organisation

Authorizations:
trap_auth
path Parameters
organisationUUID
required
string <uuid> (Organisation UUID)

Responses

Response samples

Content type
application/json
{
  • "uuid": "095be615-a8ad-4c33-8e9c-c7612fbf6c9f",
  • "name": "string",
  • "summary": "string",
  • "description": "string",
  • "meta": {
    }
}

Projects

A top-level project on Trap.NZ

Get projects

Authorizations:
trap_auth
query Parameters
changed_since
string <date-time>

Only return entities changed since this date.

changed_since_uuid
string <uuid>

Only return entities changed since this UUID, if the date is equal to changed_since.

organisation
string <uuid> (Organisation UUID)

Only return entities associated with this organisation.

limit
integer [ 1 .. 100000 ]
Default: 1000

Only return up to this many entities. Tentatively limited to 100,000.

my_membership_state
any (My Membership State)
Enum: "active" "pending" "blocked" null

The current users membership state

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Get project sync status

Authorizations:
trap_auth
query Parameters
my_membership_state
any (My Membership State)
Enum: "active" "pending" "blocked" null

The current users membership state

limit
integer [ 1 .. 100000 ]
Default: 1000

Only return up to this many entities. Tentatively limited to 100,000.

project
string <uuid> (Project UUID)

Optional — return status for one project only

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Get project

Authorizations:
trap_auth
path Parameters
projectUUID
required
string <uuid> (Project UUID)

Responses

Response samples

Content type
application/json
{
  • "uuid": "095be615-a8ad-4c33-8e9c-c7612fbf6c9f",
  • "name": "string",
  • "location": "string",
  • "tags": [
    ],
  • "is_listed": true,
  • "share_summary_data": true,
  • "curated": true,
  • "organisations": [
    ],
  • "contact": "string",
  • "contact_organisation": "string",
  • "description": "string",
  • "websites": [
    ],
  • "base_layers": [
    ],
  • "enabled_features": {
    },
  • "my_access": {
    },
  • "capabilities": {
    },
  • "meta": {
    }
}

Lines

A line on Trap.NZ

Get lines

Authorizations:
trap_auth
query Parameters
changed_since
string <date-time>

Only return entities changed since this date.

changed_since_uuid
string <uuid>

Only return entities changed since this UUID, if the date is equal to changed_since.

organisation
string <uuid> (Organisation UUID)

Only return entities associated with this organisation.

limit
integer [ 1 .. 100000 ]
Default: 1000

Only return up to this many entities. Tentatively limited to 100,000.

Array of Project UUID (strings) or string

Only return entities associated with one or more projects.

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Create new line under a project

Authorizations:
trap_auth
Request Body schema: application/json

Line to create for a project

name
required
string (Line Name)
required
object (Project)

The project this line belongs to

required
object (Line type)
colour
string (Colour) ^#[0-9A-Fa-f]{6}$

The colour to render the line

location
string <wkt> (Location)

The location of this line

Responses

Request samples

Content type
application/json
{
  • "name": "string",
  • "project": {
    },
  • "type": {
    },
  • "colour": "string",
  • "location": "string"
}

Response samples

Content type
application/json
{
  • "message": "string",
  • "line": {
    }
}

Get line

Authorizations:
trap_auth
path Parameters
lineUUID
required
string <uuid> (Line UUID)

Responses

Response samples

Content type
application/json
{
  • "uuid": "095be615-a8ad-4c33-8e9c-c7612fbf6c9f",
  • "name": "string",
  • "project": {
    },
  • "type": {
    },
  • "colour": "string",
  • "location": "string",
  • "meta": {
    }
}

Update line

Authorizations:
trap_auth
path Parameters
lineUUID
required
string <uuid> (Line UUID)
Request Body schema: application/json

Line to update

name
string (Line Name)
object (Line type)
colour
string (Colour) ^#[0-9A-Fa-f]{6}$

The colour to render the line

location
string <wkt> (Location)

The location of this line

Responses

Request samples

Content type
application/json
{
  • "name": "string",
  • "type": {
    },
  • "colour": "string",
  • "location": "string"
}

Response samples

Content type
application/json
{
  • "message": "string",
  • "line": {
    }
}

Delete line

Authorizations:
trap_auth
path Parameters
lineUUID
required
string <uuid> (Line UUID)

Responses

Response samples

Content type
application/json
{
  • "message": "string",
  • "uuid": "095be615-a8ad-4c33-8e9c-c7612fbf6c9f"
}

Traps

Traps kill or catch pests

Get traps

Get traps, ordered from least recently changed to most recently changed.

Authorizations:
trap_auth
query Parameters
changed_since
string <date-time>

Only return entities changed since this date.

changed_since_uuid
string <uuid>

Only return entities changed since this UUID, if the date is equal to changed_since.

organisation
string <uuid> (Organisation UUID)

Only return entities associated with this organisation.

project
string <uuid> (Project UUID)

Only return entities associated with this project.

line
string <uuid> (Line UUID)

Only return entities associated with this line.

date_installed_before
string <date-time>

Only return entities installed before this date.

date_installed_since
string <date-time>

Only return entities installed since this date.

limit
integer [ 1 .. 100000 ]
Default: 1000

Only return up to this many entities. Tentatively limited to 100,000.

is_retired
boolean (Retired state)

The entities retired state

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Create trap

Create a new trap

Authorizations:
trap_auth
header Parameters
App-Version
string (App Version)

The app version to record along with a commit ID.

Request Body schema: application/json
name
required
string (Trap Number / Code)
tags
Array of strings (Tags)
date_installed
required
string <date-time> (Date Installed)

The date of installation

installed_by
string (Installed By)

The name of the installer

required
object
object (Line)

The line this trap belongs to

required
object (Project)

The project this trap belongs to

location
required
string <wkt> (Location)

The location of this trap

notes
string (Notes)
Array of objects
is_retired
required
boolean (Is retired?)
object

The sensor of this trap

object (Contact details)
weight
integer (Weight)

The sort weight for this trap within its line

commit_id
string (commitId)

Responses

Request samples

Content type
application/json
{
  • "name": "string",
  • "tags": [
    ],
  • "date_installed": "2019-08-24T14:15:22Z",
  • "installed_by": "string",
  • "device_model": {
    },
  • "line": {
    },
  • "project": {
    },
  • "location": "string",
  • "notes": "string",
  • "images": [
    ],
  • "is_retired": true,
  • "sensor": {
    },
  • "contact": {
    },
  • "weight": 0,
  • "commit_id": "string"
}

Response samples

Content type
application/json
{
  • "uuid": "095be615-a8ad-4c33-8e9c-c7612fbf6c9f",
  • "name": "string",
  • "tags": [
    ],
  • "date_installed": "2019-08-24T14:15:22Z",
  • "installed_by": "string",
  • "device_model": {
    },
  • "sensor": {
    },
  • "line": {
    },
  • "project": {
    },
  • "location": "string",
  • "weight": 0,
  • "images": [
    ],
  • "notes": "string",
  • "qr_code": "string",
  • "is_retired": true,
  • "contact": {
    },
  • "meta": {
    }
}

Get trap

Get a single trap

Authorizations:
trap_auth
path Parameters
trapUUID
required
string <uuid>

Responses

Response samples

Content type
application/json
{
  • "uuid": "095be615-a8ad-4c33-8e9c-c7612fbf6c9f",
  • "name": "string",
  • "tags": [
    ],
  • "date_installed": "2019-08-24T14:15:22Z",
  • "installed_by": "string",
  • "device_model": {
    },
  • "sensor": {
    },
  • "line": {
    },
  • "project": {
    },
  • "location": "string",
  • "weight": 0,
  • "images": [
    ],
  • "notes": "string",
  • "qr_code": "string",
  • "is_retired": true,
  • "contact": {
    },
  • "meta": {
    }
}

Update trap

Update a single trap

Authorizations:
trap_auth
path Parameters
trapUUID
required
string <uuid>
header Parameters
App-Version
string (App Version)

The app version to record along with a commit ID.

Request Body schema: application/json
name
string (Trap Number / Code)
tags
Array of strings (Tags)
date_installed
string <date-time> (Date Installed)

The date of installation

installed_by
string (Installed By)

The name of the installer

object
object (Line)

The line this trap belongs to

location
string <wkt> (Location)

The location of this trap

notes
string (Notes)
Array of objects
is_retired
boolean (Is retired?)
object

The sensor of this trap

object (Contact details)
weight
integer (Weight)

The sort weight for this trap within its line

Responses

Request samples

Content type
application/json
{
  • "name": "string",
  • "tags": [
    ],
  • "date_installed": "2019-08-24T14:15:22Z",
  • "installed_by": "string",
  • "device_model": {
    },
  • "line": {
    },
  • "location": "string",
  • "notes": "string",
  • "images": [
    ],
  • "is_retired": true,
  • "sensor": {
    },
  • "contact": {
    },
  • "weight": 0
}

Response samples

Content type
application/json
{
  • "uuid": "095be615-a8ad-4c33-8e9c-c7612fbf6c9f",
  • "name": "string",
  • "tags": [
    ],
  • "date_installed": "2019-08-24T14:15:22Z",
  • "installed_by": "string",
  • "device_model": {
    },
  • "sensor": {
    },
  • "line": {
    },
  • "project": {
    },
  • "location": "string",
  • "weight": 0,
  • "images": [
    ],
  • "notes": "string",
  • "qr_code": "string",
  • "is_retired": true,
  • "contact": {
    },
  • "meta": {
    }
}

Delete trap

Deletes the trap. Trap records and supplementary traps must be deleted first. Any sensor on the trap is released and can be installed elsewhere.

Authorizations:
trap_auth
path Parameters
trapUUID
required
string <uuid>
header Parameters
App-Version
string (App Version)

The app version to record along with a commit ID.

Responses

Response samples

Content type
application/json
{
  • "message": "string",
  • "uuid": "095be615-a8ad-4c33-8e9c-c7612fbf6c9f"
}

Get records

Get records, ordered from least recently changed to most recently changed.

Authorizations:
trap_auth
query Parameters
changed_since
string <date-time>

Only return entities changed since this date.

changed_since_uuid
string <uuid>

Only return entities changed since this UUID, if the date is equal to changed_since.

organisation
string <uuid> (Organisation UUID)

Only return entities associated with this organisation.

project
string <uuid> (Project UUID)

Only return entities associated with this project.

line
string <uuid> (Line UUID)

Only return entities associated with this line.

limit
integer [ 1 .. 100000 ]
Default: 1000

Only return up to this many entities. Tentatively limited to 100,000.

trap
string <uuid> (Trap UUID)

Only return records associated with this trap.

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Create trap record

Create a new trap record

Authorizations:
trap_auth
header Parameters
App-Version
string (App Version)

The app version to record along with a commit ID.

Request Body schema: application/json
date
required
string <date-time> (Date of record)
recorded_by
string (Recorded By)

The name of the recorder

required
object
required
object
relured
required
boolean (Relured)

Whether the trap was relured

required
Array of Lure (object) or Lure (object) (Relure)

The lures added, if relured

required
object or object (trap_status)
condition
required
string (Condition)
Enum: "OK" "Needs maintenance" "Repaired" "Regassed" "Relured" "Battery charge" "Disabled"
strikes
required
integer (Strikes) >= 0

The number of strikes

Array of objects (Images)
notes
string (Notes)
commit_id
string (commitId)

Responses

Request samples

Content type
application/json
{
  • "date": "2019-08-24T14:15:22Z",
  • "recorded_by": "string",
  • "trap": {
    },
  • "catch": {
    },
  • "relured": true,
  • "relure": [
    ],
  • "status": {
    },
  • "condition": "OK",
  • "strikes": 0,
  • "images": [
    ],
  • "notes": "string",
  • "commit_id": "string"
}

Response samples

Content type
application/json
{
  • "uuid": "095be615-a8ad-4c33-8e9c-c7612fbf6c9f",
  • "date": "2019-08-24T14:15:22Z",
  • "recorded_by": "string",
  • "trap": {
    },
  • "catch": {
    },
  • "relured": true,
  • "relure": [
    ],
  • "status": {
    },
  • "condition": "OK",
  • "strikes": 0,
  • "images": [
    ],
  • "notes": "string",
  • "meta": {
    }
}

Get trap record

Get a single trap record

Authorizations:
trap_auth
path Parameters
trapRecordUUID
required
string <uuid>

Responses

Response samples

Content type
application/json
{
  • "uuid": "095be615-a8ad-4c33-8e9c-c7612fbf6c9f",
  • "date": "2019-08-24T14:15:22Z",
  • "recorded_by": "string",
  • "trap": {
    },
  • "catch": {
    },
  • "relured": true,
  • "relure": [
    ],
  • "status": {
    },
  • "condition": "OK",
  • "strikes": 0,
  • "images": [
    ],
  • "notes": "string",
  • "meta": {
    }
}

Update trap record

Update a single trap record

Authorizations:
trap_auth
path Parameters
trapRecordUUID
required
string <uuid>
header Parameters
App-Version
string (App Version)

The app version to record along with a commit ID.

Request Body schema: application/json
date
string <date-time> (Date of record)
recorded_by
string (Recorded By)

The name of the recorder

object (Catch)

The catch, if caught

relured
boolean (Relured)

Whether the trap was relured

Array of Lure (object) or Lure (object) (Relure)

The lures added, if relured

object or object (trap_status)
condition
string (Condition)
Enum: "OK" "Needs maintenance" "Repaired" "Regassed" "Relured" "Battery charge" "Disabled"
strikes
integer (Strikes) >= 0

The number of strikes

Array of objects (Images)
notes
string (Notes)

Responses

Request samples

Content type
application/json
{
  • "date": "2019-08-24T14:15:22Z",
  • "recorded_by": "string",
  • "catch": {
    },
  • "relured": true,
  • "relure": [
    ],
  • "status": {
    },
  • "condition": "OK",
  • "strikes": 0,
  • "images": [
    ],
  • "notes": "string"
}

Response samples

Content type
application/json
{
  • "uuid": "095be615-a8ad-4c33-8e9c-c7612fbf6c9f",
  • "date": "2019-08-24T14:15:22Z",
  • "recorded_by": "string",
  • "trap": {
    },
  • "catch": {
    },
  • "relured": true,
  • "relure": [
    ],
  • "status": {
    },
  • "condition": "OK",
  • "strikes": 0,
  • "images": [
    ],
  • "notes": "string",
  • "meta": {
    }
}

Delete trap record

Deletes the trap record.

Authorizations:
trap_auth
path Parameters
trapRecordUUID
required
string <uuid>
header Parameters
App-Version
string (App Version)

The app version to record along with a commit ID.

Responses

Response samples

Content type
application/json
{
  • "message": "string",
  • "uuid": "095be615-a8ad-4c33-8e9c-c7612fbf6c9f"
}

Points of Interest

Points of interest record extra information within a project

Get points of interest

Get points of interest, ordered from least recently changed to most recently changed.

Authorizations:
trap_auth
query Parameters
changed_since
string <date-time>

Only return entities changed since this date.

changed_since_uuid
string <uuid>

Only return entities changed since this UUID, if the date is equal to changed_since.

organisation
string <uuid> (Organisation UUID)

Only return entities associated with this organisation.

project
string <uuid> (Project UUID)

Only return entities associated with this project.

line
string <uuid> (Line UUID)

Only return entities associated with this line.

limit
integer [ 1 .. 100000 ]
Default: 1000

Only return up to this many entities. Tentatively limited to 100,000.

projectNid
integer (Project Node Id)
Deprecated

Only return entities associated with this project.

active_at
string <date> (Active Date)

Only return points of interest active at this date

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Create point of interest

Create a new point of interest

Authorizations:
trap_auth
header Parameters
App-Version
string (App Version)

The app version to record along with a commit ID.

Request Body schema: application/json
name
required
string (Name)
Array of objects (Tags)
start_date
string <date> (Start Date)
end_date
string <date> (End Date)
object or object
object or object
required
object or object
location
required
string <wkt> (Location)

The location of this trap

colour
string (Colour) ^#[0-9A-Fa-f]{6}$

The colour to render the point of interest

weight
integer (Weight)

The sort weight for this point of interest within its line

Array of objects or objects
notes
string (Notes)
commit_id
string (commitId)

Responses

Request samples

Content type
application/json
{
  • "name": "string",
  • "tags": [
    ],
  • "start_date": "2019-08-24",
  • "end_date": "2019-08-24",
  • "type": {
    },
  • "line": {
    },
  • "project": {
    },
  • "location": "string",
  • "colour": "string",
  • "weight": 0,
  • "images": [
    ],
  • "notes": "string",
  • "commit_id": "string"
}

Response samples

Content type
application/json
{
  • "uuid": "095be615-a8ad-4c33-8e9c-c7612fbf6c9f",
  • "name": "string",
  • "tags": [
    ],
  • "start_date": "2019-08-24",
  • "end_date": "2019-08-24",
  • "type": {
    },
  • "line": {
    },
  • "project": {
    },
  • "location": "string",
  • "colour": "string",
  • "weight": 0,
  • "images": [
    ],
  • "notes": "string",
  • "meta": {
    },
  • "qr_code": "string"
}

Get point of interest

Get a single point of interest

Authorizations:
trap_auth
path Parameters
pointOfInterestUUID
required
string <uuid>

Responses

Response samples

Content type
application/json
{
  • "uuid": "095be615-a8ad-4c33-8e9c-c7612fbf6c9f",
  • "name": "string",
  • "tags": [
    ],
  • "start_date": "2019-08-24",
  • "end_date": "2019-08-24",
  • "type": {
    },
  • "line": {
    },
  • "project": {
    },
  • "location": "string",
  • "colour": "string",
  • "weight": 0,
  • "images": [
    ],
  • "notes": "string",
  • "meta": {
    },
  • "qr_code": "string"
}

Update point of interest

Update a single point of interest

Authorizations:
trap_auth
path Parameters
pointOfInterestUUID
required
string <uuid>
header Parameters
App-Version
string (App Version)

The app version to record along with a commit ID.

Request Body schema: application/json
name
string (Name)
start_date
string <date> (Start Date)
end_date
string <date> (End Date)
object (POI type)
object (Line)

The line this point of interest belongs to

location
string <wkt> (Location)

The location of this trap

colour
string (Colour) ^#[0-9A-Fa-f]{6}$

The colour to render the point of interest

weight
integer (Weight)

The sort weight for this point of interest within its line

Array of objects or objects
notes
string (Notes)

Responses

Request samples

Content type
application/json
{
  • "name": "string",
  • "start_date": "2019-08-24",
  • "end_date": "2019-08-24",
  • "type": {
    },
  • "line": {
    },
  • "location": "string",
  • "colour": "string",
  • "weight": 0,
  • "images": [
    ],
  • "notes": "string"
}

Response samples

Content type
application/json
{
  • "uuid": "095be615-a8ad-4c33-8e9c-c7612fbf6c9f",
  • "name": "string",
  • "tags": [
    ],
  • "start_date": "2019-08-24",
  • "end_date": "2019-08-24",
  • "type": {
    },
  • "line": {
    },
  • "project": {
    },
  • "location": "string",
  • "colour": "string",
  • "weight": 0,
  • "images": [
    ],
  • "notes": "string",
  • "meta": {
    },
  • "qr_code": "string"
}

Delete point of interest

Deletes the point of interest. Point of interest records must be deleted first.

Authorizations:
trap_auth
path Parameters
pointOfInterestUUID
required
string <uuid>
header Parameters
App-Version
string (App Version)

The app version to record along with a commit ID.

Responses

Response samples

Content type
application/json
{
  • "message": "string",
  • "uuid": "095be615-a8ad-4c33-8e9c-c7612fbf6c9f"
}

Get point of interest Deprecated

Get a single point of interest by its node id

Authorizations:
trap_auth
path Parameters
pointOfInterestNid
required
integer

Responses

Response samples

Content type
application/json
{
  • "uuid": "095be615-a8ad-4c33-8e9c-c7612fbf6c9f",
  • "name": "string",
  • "tags": [
    ],
  • "start_date": "2019-08-24",
  • "end_date": "2019-08-24",
  • "type": {
    },
  • "line": {
    },
  • "project": {
    },
  • "location": "string",
  • "colour": "string",
  • "weight": 0,
  • "images": [
    ],
  • "notes": "string",
  • "meta": {
    },
  • "qr_code": "string"
}

Update point of interest Deprecated

Update a single point of interest by its node id

Authorizations:
trap_auth
path Parameters
pointOfInterestNid
required
integer
header Parameters
App-Version
string (App Version)

The app version to record along with a commit ID.

Request Body schema: application/json
name
string (Name)
start_date
string <date> (Start Date)
end_date
string <date> (End Date)
object (POI type)
object (Line)

The line this point of interest belongs to

location
string <wkt> (Location)

The location of this trap

colour
string (Colour) ^#[0-9A-Fa-f]{6}$

The colour to render the point of interest

weight
integer (Weight)

The sort weight for this point of interest within its line

Array of objects or objects
notes
string (Notes)

Responses

Request samples

Content type
application/json
{
  • "name": "string",
  • "start_date": "2019-08-24",
  • "end_date": "2019-08-24",
  • "type": {
    },
  • "line": {
    },
  • "location": "string",
  • "colour": "string",
  • "weight": 0,
  • "images": [
    ],
  • "notes": "string"
}

Response samples

Content type
application/json
{
  • "uuid": "095be615-a8ad-4c33-8e9c-c7612fbf6c9f",
  • "name": "string",
  • "tags": [
    ],
  • "start_date": "2019-08-24",
  • "end_date": "2019-08-24",
  • "type": {
    },
  • "line": {
    },
  • "project": {
    },
  • "location": "string",
  • "colour": "string",
  • "weight": 0,
  • "images": [
    ],
  • "notes": "string",
  • "meta": {
    },
  • "qr_code": "string"
}

Get point of interest records

Get point of interest records, ordered from least recently changed to most recently changed.

Authorizations:
trap_auth
query Parameters
changed_since
string <date-time>

Only return entities changed since this date.

changed_since_uuid
string <uuid>

Only return entities changed since this UUID, if the date is equal to changed_since.

organisation
string <uuid> (Organisation UUID)

Only return entities associated with this organisation.

project
string <uuid> (Project UUID)

Only return entities associated with this project.

line
string <uuid> (Line UUID)

Only return entities associated with this line.

limit
integer [ 1 .. 100000 ]
Default: 1000

Only return up to this many entities. Tentatively limited to 100,000.

pointOfInterest
string <uuid> (Point of Interest UUID)

Only return records associated with this point of interest.

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Create a point of interest record

Create a new record at a point of interest

Authorizations:
trap_auth
header Parameters
App-Version
string (App Version)

The app version to record along with a commit ID.

Request Body schema: application/json
required
object or object
Array of objects (Tags)
ISO String (string) or ISO String (object) or Seconds since Epoch (object) (date)
notes
string (Notes)
Array of objects or objects
commit_id
string (commitId)

Responses

Request samples

Content type
application/json
{
  • "pointOfInterest": {
    },
  • "tags": [
    ],
  • "date": "2019-08-24T14:15:22Z",
  • "notes": "string",
  • "images": [
    ],
  • "commit_id": "string"
}

Response samples

Content type
application/json
{
  • "uuid": "095be615-a8ad-4c33-8e9c-c7612fbf6c9f",
  • "name": "string",
  • "pointOfInterest": {
    },
  • "tags": [
    ],
  • "date": null,
  • "notes": "string",
  • "images": [
    ],
  • "meta": {
    }
}

Get point of interest record

Get a single point of interest record

Authorizations:
trap_auth
path Parameters
pointOfInterestRecordUUID
required
string <uuid>

Responses

Response samples

Content type
application/json
{
  • "uuid": "095be615-a8ad-4c33-8e9c-c7612fbf6c9f",
  • "name": "string",
  • "pointOfInterest": {
    },
  • "tags": [
    ],
  • "date": null,
  • "notes": "string",
  • "images": [
    ],
  • "meta": {
    }
}

Update point of interest record

Update a single point of interest record

Authorizations:
trap_auth
path Parameters
pointOfInterestRecordUUID
required
string <uuid>
header Parameters
App-Version
string (App Version)

The app version to record along with a commit ID.

Request Body schema: application/json
Array of objects (Tags)
ISO String (string) or ISO String (object) or Seconds since Epoch (object) (date)
notes
string (Notes)
Array of objects or objects
commit_id
string (commitId)

Responses

Request samples

Content type
application/json
{
  • "tags": [
    ],
  • "date": "2019-08-24T14:15:22Z",
  • "notes": "string",
  • "images": [
    ],
  • "commit_id": "string"
}

Response samples

Content type
application/json
{
  • "uuid": "095be615-a8ad-4c33-8e9c-c7612fbf6c9f",
  • "name": "string",
  • "pointOfInterest": {
    },
  • "tags": [
    ],
  • "date": null,
  • "notes": "string",
  • "images": [
    ],
  • "meta": {
    }
}

Delete point of interest record

Deletes the point of interest record.

Authorizations:
trap_auth
path Parameters
pointOfInterestRecordUUID
required
string <uuid>
header Parameters
App-Version
string (App Version)

The app version to record along with a commit ID.

Responses

Response samples

Content type
application/json
{
  • "message": "string",
  • "uuid": "095be615-a8ad-4c33-8e9c-c7612fbf6c9f"
}

Sensors

Sensors and sensor records

Create trap record from a sensor

Create a trap record on the trap a sensor is installed on. The caller must hold the Sensor Provider role and provide the named sensor. The trap is resolved from the provider and the sensor ID, so no project membership or trap assignment is required, and a provider can only reach traps carrying its own sensors. Noting that a sensor provider cannot read the record back following creation - this is by design.

Authorizations:
trap_auth
header Parameters
App-Version
string (App Version)

The app version to record along with a commit ID.

Request Body schema: application/json
sensor_id
required
string (Sensor ID)

The sensor reporting this record. The trap is resolved from this and the caller's own sensor provider, so the trap is not named directly.

date
required
string <date-time> (Date of record)
recorded_by
string (Recorded By)

The name of the recorder

required
object
relured
required
boolean (Relured)

Whether the trap was relured

required
Array of Lure (object) or Lure (object) (Relure)

The lures added, if relured

required
object or object (trap_status)
condition
required
string (Condition)
Enum: "OK" "Needs maintenance" "Repaired" "Regassed" "Relured" "Battery charge" "Disabled"
strikes
required
integer (Strikes) >= 0

The number of strikes

Array of objects (Images)
notes
string (Notes)

Responses

Request samples

Content type
application/json
{
  • "sensor_id": "string",
  • "date": "2019-08-24T14:15:22Z",
  • "recorded_by": "string",
  • "catch": {
    },
  • "relured": true,
  • "relure": [
    ],
  • "status": {
    },
  • "condition": "OK",
  • "strikes": 0,
  • "images": [
    ],
  • "notes": "string"
}

Response samples

Content type
application/json
{
  • "uuid": "095be615-a8ad-4c33-8e9c-c7612fbf6c9f",
  • "date": "2019-08-24T14:15:22Z",
  • "recorded_by": "string",
  • "trap": {
    },
  • "catch": {
    },
  • "relured": true,
  • "relure": [
    ],
  • "status": {
    },
  • "condition": "OK",
  • "strikes": 0,
  • "images": [
    ],
  • "notes": "string",
  • "meta": {
    }
}

Get sensor records

Get sensor records, ordered from least recently changed to most recently changed.

Authorizations:
trap_auth
query Parameters
changed_since
string <date-time>

Only return entities changed since this date.

changed_since_uuid
string <uuid>

Only return entities changed since this UUID, if the date is equal to changed_since.

limit
integer [ 1 .. 100000 ]
Default: 1000

Only return up to this many entities. Tentatively limited to 100,000.

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Post a sensor record

Authorizations:
trap_auth
query Parameters
return_record_uuid
boolean
Default: false

Return the created sensor record UUID in the response body.

Request Body schema: application/json
sensor_id
required
string (Sensor ID)

The ID of the sensor (unique per sensor provider)

required
ISO String (string) or ISO String (object) or Seconds since Epoch (object) (date)
event
required
string (Event)
Enum: "Sprung" "Set" "Vibration" "Heartbeat" "Baitlevel"

The type of event for this record

status
string (Status)
Enum: "Sprung" "Set" "Baitlevel"

The status of the device

network
string (Network)

The name or ID of the network the device is connected to

gateway
string (Gateway)

IP address of the network gateway the device is connected to

rssi
integer (RSSI)

Wireless network Received Signal Strength Indicator

sequence
integer (Sequence)

A total count of transmissions sent according to the device

counter
integer (Counter)

A device-specific counter such as the number of times a trigger has sprung

battery_voltage
number (Battery voltage)

The current measured battery voltage

snr
number (Signal to noise ratio)

(decibels)

timeout
integer (Timeout)

Heartbeat interval (seconds). Alternatively -1 (no timeout) or 0: (expired)

bait_level
number (Bait level)

The measured level of the remaining bait

temperature
number (Temperature)

Degrees Celsius

humidity
number (Humidity)

Relative humidity (%)

tilt_angle
number (Tilt angle)

Single-axis gyroscopic tilt (degrees)

bump
boolean (Bump detection)

Bump, shock or rapid accelerometer detection

pir_count
integer (PIR count)

Count of infrared motion detections (since last record)

extra
string (Extra info) <= 255 characters

Extra data, info or debugging not captured by the official fields

Responses

Request samples

Content type
application/json
{
  • "sensor_id": "string",
  • "date": "2019-08-24T14:15:22Z",
  • "event": "Sprung",
  • "status": "Sprung",
  • "network": "string",
  • "gateway": "string",
  • "rssi": 0,
  • "sequence": 0,
  • "counter": 0,
  • "battery_voltage": 0,
  • "snr": 0,
  • "timeout": 0,
  • "bait_level": 0,
  • "temperature": 0,
  • "humidity": 0,
  • "tilt_angle": 0,
  • "bump": true,
  • "pir_count": 0,
  • "extra": "string"
}

Response samples

Content type
application/json
"string"

Get sensor record

Get a single sensor record

Authorizations:
trap_auth
path Parameters
sensorRecordUUID
required
string <uuid>

Responses

Response samples

Content type
application/json
{
  • "uuid": "095be615-a8ad-4c33-8e9c-c7612fbf6c9f",
  • "user_uuid": "7c4d2d7d-8620-4fb3-967a-4a621082cf1f",
  • "provider": "string",
  • "sensor_id": "string",
  • "date": null,
  • "submissionDate": null,
  • "event": "Sprung",
  • "status": "Sprung",
  • "network": "string",
  • "gateway": "string",
  • "rssi": 0,
  • "sequence": 0,
  • "counter": 0,
  • "battery_voltage": 0,
  • "snr": 0,
  • "timeout": 0,
  • "bait_level": 0,
  • "temperature": 0,
  • "humidity": 0,
  • "tilt_angle": 0,
  • "bump": true,
  • "pir_count": 0,
  • "extra": "string",
  • "meta": null
}

Get sensor providers

Authorizations:
trap_auth

Responses

Response samples

Content type
application/json
[
  • "string"
]

Get sensors

Authorizations:
trap_auth

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Get sensor

Authorizations:
trap_auth
path Parameters
sensorProvider
required
string
sensorID
required
string

Responses

Response samples

Content type
application/json
{
  • "id": "string",
  • "provider": "string",
  • "installation": {
    },
  • "meta": { }
}

Auth

Endpoints related to auth

Request access token

Authorizations:
Request Body schema: application/json
One of
grant_type
required
string
Value: "password"
scope
string
Value: "default"
username
required
string
password
required
string <password>
client_id
required
string
client_secret
string <password>

Responses

Request samples

Content type
application/json
Example
{
  • "grant_type": "password",
  • "scope": "default",
  • "username": "string",
  • "password": "pa$$word",
  • "client_id": "string",
  • "client_secret": "pa$$word"
}

Response samples

Content type
application/json
{
  • "access_token": "pa$$word",
  • "refresh_token": "pa$$word",
  • "token_type": "Bearer",
  • "scope": "default",
  • "expires_in": "string"
}

Users

Endpoints related to users

Get current user

Authorizations:
trap_auth

Responses

Response samples

Content type
application/json
{
  • "uuid": "095be615-a8ad-4c33-8e9c-c7612fbf6c9f",
  • "username": "string",
  • "common_name": "string",
  • "email": "[email protected]",
  • "is_site_administrator": true,
  • "meta": {
    }
}

Deployment Markers

Endpoints related to deployment markers

Get deployment markers by project

Authorizations:
trap_auth
query Parameters
changed_since
string <date-time>

Only return entities changed since this date.

changed_since_uuid
string <uuid>

Only return entities changed since this UUID, if the date is equal to changed_since.

limit
integer [ 1 .. 100000 ]
Default: 1000

Only return up to this many entities. Tentatively limited to 100,000.

project
required
string <uuid> (Project UUID)

Only return entities associated with this project.

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Create new deployment marker under a project

Authorizations:
trap_auth
Request Body schema: application/json

Deployment to create for a project

name
string (Deployment Marker Name)
planned_installation_type
required
string (Planned Installation Type)
Enum: "trap" "bait_station" "monitoring_station"
planned_install_term_uuid
required
string <uuid> (Planned install term)

The term that describes the planned install detail or subtype (e.g. trap type or monitoring station type).

deployment_state
string (Deployment State)
Enum: "planned" "in_progress" "approved" "installed" "declined"
project_uuid
required
string <uuid> (Project)

The project which this deployment belongs to

line_uuid
string <uuid> (Line)

The line this deployment is associated with

location
required
string <wkt> (wkt_polygon)
notes
string (Notes)

General notes about this deployment marker

photos
Array of strings <uuid> (Photos)

Responses

Request samples

Content type
application/json
{
  • "name": "string",
  • "planned_installation_type": "trap",
  • "planned_install_term_uuid": "eacf8cd1-316c-42f2-84cf-8a3c396f6928",
  • "deployment_state": "planned",
  • "project_uuid": "1de37675-f868-4726-bb1d-b08d89f463f9",
  • "line_uuid": "9e7574fe-bdba-45e4-a7ea-861287f5a8c6",
  • "location": "string",
  • "notes": "string",
  • "photos": [
    ]
}

Response samples

Content type
application/json
{
  • "message": "string",
  • "deployment_marker": {
    }
}

Create multiple deployment markers

Authorizations:
trap_auth
Request Body schema: application/json

Deployments to create

Array
name
string (Deployment Marker Name)
planned_installation_type
required
string (Planned Installation Type)
Enum: "trap" "bait_station" "monitoring_station"
planned_install_term_uuid
required
string <uuid> (Planned install term)

The term that describes the planned install detail or subtype (e.g. trap type or monitoring station type).

deployment_state
string (Deployment State)
Enum: "planned" "in_progress" "approved" "installed" "declined"
project_uuid
required
string <uuid> (Project)

The project which this deployment belongs to

line_uuid
string <uuid> (Line)

The line this deployment is associated with

location
required
string <wkt> (wkt_polygon)
notes
string (Notes)

General notes about this deployment marker

Responses

Request samples

Content type
application/json
[
  • {
    }
]

Response samples

Content type
application/json
{
  • "message": "string",
  • "deployment_markers": [
    ]
}

Update multiple deployment markers

Authorizations:
trap_auth
Request Body schema: application/json

Deployments to update

Array
name
string (Deployment Marker Name)
planned_installation_type
string (Planned Installation Type)
Enum: "trap" "bait_station" "monitoring_station"
planned_install_term_uuid
string <uuid> (Planned install term)

The term that describes the planned install detail or subtype (e.g. trap type or monitoring station type).

deployment_state
string (Deployment State)
Enum: "planned" "in_progress" "approved" "installed" "declined"
line_uuid
string <uuid> (Line)

The line this deployment is associated with

installation_uuid
string <uuid> (Installation)

Reference ID of the actual installed item

location
string <wkt> (wkt_polygon)
uuid
required
string <uuid> (Deployment Marker UUID)
notes
string (Notes)

General notes about this deployment marker

photos
Array of strings <uuid> (Photos)

Responses

Request samples

Content type
application/json
[
  • {
    }
]

Response samples

Content type
application/json
{
  • "message": "string",
  • "deployment_markers": [
    ]
}

Delete multiple deployment markers

Authorizations:
trap_auth
Request Body schema: application/json

Deployments to delete

Array
string <uuid>

Responses

Request samples

Content type
application/json
[
  • "497f6eca-6276-4993-bfeb-53cbbbba6f08"
]

Response samples

Content type
application/json
{
  • "message": "string",
  • "deployment_markers": [
    ]
}

Get deployment

Authorizations:
trap_auth
path Parameters
deploymentMarkerUUID
required
string <uuid> (Deployment Marker UUID)

Responses

Response samples

Content type
application/json
{
  • "uuid": "095be615-a8ad-4c33-8e9c-c7612fbf6c9f",
  • "name": "string",
  • "planned_installation_type": "trap",
  • "planned_install_term_uuid": "eacf8cd1-316c-42f2-84cf-8a3c396f6928",
  • "deployment_state": "planned",
  • "project_uuid": "1de37675-f868-4726-bb1d-b08d89f463f9",
  • "line_uuid": "9e7574fe-bdba-45e4-a7ea-861287f5a8c6",
  • "line": "string",
  • "installation_uuid": "ae0baaae-4d83-4a10-88b5-16662b772857",
  • "location": "string",
  • "notes": "string",
  • "photos": [
    ],
  • "meta": {
    }
}

Update deployment

Authorizations:
trap_auth
path Parameters
deploymentMarkerUUID
required
string <uuid> (Deployment Marker UUID)
Request Body schema: application/json

Deployment marker to update

name
string (Deployment Marker Name)
planned_installation_type
string (Planned Installation Type)
Enum: "trap" "bait_station" "monitoring_station"
planned_install_term_uuid
string <uuid> (Planned install term)

The term that describes the planned install detail or subtype (e.g. trap type or monitoring station type).

deployment_state
string (Deployment State)
Enum: "planned" "in_progress" "approved" "installed" "declined"
line_uuid
string <uuid> (Line)

The line this deployment is associated with

installation_uuid
string <uuid> (Installation)

Reference ID of the actual installed item

location
string <wkt> (wkt_polygon)
notes
string (Notes)

General notes about this deployment marker

photos
Array of strings <uuid> (Photos)

Responses

Request samples

Content type
application/json
{
  • "name": "string",
  • "planned_installation_type": "trap",
  • "planned_install_term_uuid": "eacf8cd1-316c-42f2-84cf-8a3c396f6928",
  • "deployment_state": "planned",
  • "line_uuid": "9e7574fe-bdba-45e4-a7ea-861287f5a8c6",
  • "installation_uuid": "ae0baaae-4d83-4a10-88b5-16662b772857",
  • "location": "string",
  • "notes": "string",
  • "photos": [
    ]
}

Response samples

Content type
application/json
{
  • "message": "string",
  • "deployment_marker": {
    }
}

Delete deployment

Authorizations:
trap_auth
path Parameters
deploymentMarkerUUID
required
string <uuid> (Deployment Marker UUID)

Responses

Response samples

Content type
application/json
{
  • "message": "string",
  • "uuid": "095be615-a8ad-4c33-8e9c-c7612fbf6c9f"
}

QRCodes

Endpoints related to qr code metadata on installations

Get QR Code Meta

Authorizations:
app_authtrap_auth
path Parameters
qrCode
required
string (QrCode)

Responses

Response samples

Content type
application/json
{
  • "installation_info": {
    },
  • "project_info": {
    }
}

Images

Endpoints related to image upload/retrieval

Bait Products

Bait product configurations for bait stations

Get all global bait products

Authorizations:
trap_auth

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Create a global bait product

Requires the Drupal site-wide administrator role.

Authorizations:
trap_auth
Request Body schema: application/json
name
string (Name)
formulation_uuid
string <uuid> (Formulation UUID)
toxin_uuid
string <uuid> (Toxin UUID)
toxin_pct
number (Toxin Percentage)
max_fill_g
number (Max Fill (grams))
unit_weight_g
number (Unit Weight (grams))
manufacturer
string (Manufacturer)
jurisdiction
string (Jurisdiction)
notes
string (Notes)

Responses

Request samples

Content type
application/json
{
  • "name": "string",
  • "formulation_uuid": "a6205384-21b5-4f55-b9f8-df34fd3df5e7",
  • "toxin_uuid": "32a08302-f57a-481a-a60f-5dccaf7033f2",
  • "toxin_pct": 0,
  • "max_fill_g": 0,
  • "unit_weight_g": 0,
  • "manufacturer": "string",
  • "jurisdiction": "string",
  • "notes": "string"
}

Response samples

Content type
application/json
{
  • "uuid": "095be615-a8ad-4c33-8e9c-c7612fbf6c9f",
  • "name": "string",
  • "formulation": {
    },
  • "toxin": {
    },
  • "toxin_pct": "string",
  • "max_fill_g": 0,
  • "unit_weight_g": 0,
  • "manufacturer": "string",
  • "jurisdiction": "string",
  • "notes": "string",
  • "references": [
    ],
  • "is_global": true,
  • "project_uuid": "1de37675-f868-4726-bb1d-b08d89f463f9"
}

Update a global bait product

Requires the Drupal site-wide administrator role.

Authorizations:
trap_auth
path Parameters
baitProductUUID
required
string <uuid> (Bait Product UUID)
Request Body schema: application/json
name
string (Name)
formulation_uuid
string <uuid> (Formulation UUID)
toxin_uuid
string <uuid> (Toxin UUID)
toxin_pct
number (Toxin Percentage)
max_fill_g
number (Max Fill (grams))
unit_weight_g
number (Unit Weight (grams))
manufacturer
string (Manufacturer)
jurisdiction
string (Jurisdiction)
notes
string (Notes)

Responses

Request samples

Content type
application/json
{
  • "name": "string",
  • "formulation_uuid": "a6205384-21b5-4f55-b9f8-df34fd3df5e7",
  • "toxin_uuid": "32a08302-f57a-481a-a60f-5dccaf7033f2",
  • "toxin_pct": 0,
  • "max_fill_g": 0,
  • "unit_weight_g": 0,
  • "manufacturer": "string",
  • "jurisdiction": "string",
  • "notes": "string"
}

Response samples

Content type
application/json
{
  • "uuid": "095be615-a8ad-4c33-8e9c-c7612fbf6c9f",
  • "name": "string",
  • "formulation": {
    },
  • "toxin": {
    },
  • "toxin_pct": "string",
  • "max_fill_g": 0,
  • "unit_weight_g": 0,
  • "manufacturer": "string",
  • "jurisdiction": "string",
  • "notes": "string",
  • "references": [
    ],
  • "is_global": true,
  • "project_uuid": "1de37675-f868-4726-bb1d-b08d89f463f9"
}

Soft-delete a global bait product

Requires the Drupal site-wide administrator role.

Authorizations:
trap_auth
path Parameters
baitProductUUID
required
string <uuid> (Bait Product UUID)

Responses

Response samples

Content type
application/json
"string"

Get bait products for a project (global + project-specific)

Authorizations:
trap_auth
path Parameters
projectUUID
required
string <uuid> (Project UUID)

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Create a project-specific bait product

Authorizations:
trap_auth
path Parameters
projectUUID
required
string <uuid> (Project UUID)
Request Body schema: application/json
name
string (Name)
formulation_uuid
string <uuid> (Formulation UUID)
toxin_uuid
string <uuid> (Toxin UUID)
toxin_pct
number (Toxin Percentage)
max_fill_g
number (Max Fill (grams))
unit_weight_g
number (Unit Weight (grams))
manufacturer
string (Manufacturer)
jurisdiction
string (Jurisdiction)
notes
string (Notes)

Responses

Request samples

Content type
application/json
{
  • "name": "string",
  • "formulation_uuid": "a6205384-21b5-4f55-b9f8-df34fd3df5e7",
  • "toxin_uuid": "32a08302-f57a-481a-a60f-5dccaf7033f2",
  • "toxin_pct": 0,
  • "max_fill_g": 0,
  • "unit_weight_g": 0,
  • "manufacturer": "string",
  • "jurisdiction": "string",
  • "notes": "string"
}

Response samples

Content type
application/json
{
  • "uuid": "095be615-a8ad-4c33-8e9c-c7612fbf6c9f",
  • "name": "string",
  • "formulation": {
    },
  • "toxin": {
    },
  • "toxin_pct": "string",
  • "max_fill_g": 0,
  • "unit_weight_g": 0,
  • "manufacturer": "string",
  • "jurisdiction": "string",
  • "notes": "string",
  • "references": [
    ],
  • "is_global": true,
  • "project_uuid": "1de37675-f868-4726-bb1d-b08d89f463f9"
}

Update a project-specific bait product

Authorizations:
trap_auth
path Parameters
projectUUID
required
string <uuid> (Project UUID)
baitProductUUID
required
string <uuid> (Bait Product UUID)
Request Body schema: application/json
name
string (Name)
formulation_uuid
string <uuid> (Formulation UUID)
toxin_uuid
string <uuid> (Toxin UUID)
toxin_pct
number (Toxin Percentage)
max_fill_g
number (Max Fill (grams))
unit_weight_g
number (Unit Weight (grams))
manufacturer
string (Manufacturer)
jurisdiction
string (Jurisdiction)
notes
string (Notes)

Responses

Request samples

Content type
application/json
{
  • "name": "string",
  • "formulation_uuid": "a6205384-21b5-4f55-b9f8-df34fd3df5e7",
  • "toxin_uuid": "32a08302-f57a-481a-a60f-5dccaf7033f2",
  • "toxin_pct": 0,
  • "max_fill_g": 0,
  • "unit_weight_g": 0,
  • "manufacturer": "string",
  • "jurisdiction": "string",
  • "notes": "string"
}

Response samples

Content type
application/json
{
  • "uuid": "095be615-a8ad-4c33-8e9c-c7612fbf6c9f",
  • "name": "string",
  • "formulation": {
    },
  • "toxin": {
    },
  • "toxin_pct": "string",
  • "max_fill_g": 0,
  • "unit_weight_g": 0,
  • "manufacturer": "string",
  • "jurisdiction": "string",
  • "notes": "string",
  • "references": [
    ],
  • "is_global": true,
  • "project_uuid": "1de37675-f868-4726-bb1d-b08d89f463f9"
}

Soft-delete a project-specific bait product

Authorizations:
trap_auth
path Parameters
projectUUID
required
string <uuid> (Project UUID)
baitProductUUID
required
string <uuid> (Bait Product UUID)

Responses

Response samples

Content type
application/json
"string"

Add a safety reference to a bait product

Site administrator for global products; project manager / project admin / org admin for project products.

Authorizations:
trap_auth
path Parameters
baitProductUUID
required
string <uuid> (Bait Product UUID)
Request Body schema: application/json
reference_type
string
authority
string
reference_number
string
title
string
url
string
last_verified
string <date>
notes
string

Responses

Request samples

Content type
application/json
{
  • "reference_type": "string",
  • "authority": "string",
  • "reference_number": "string",
  • "title": "string",
  • "url": "string",
  • "last_verified": "2019-08-24",
  • "notes": "string"
}

Response samples

Content type
application/json
{
  • "uuid": "095be615-a8ad-4c33-8e9c-c7612fbf6c9f",
  • "bait_product_uuid": "8addb1fb-31d4-45b1-8246-3603d373a3e8",
  • "reference_type": "string",
  • "authority": "string",
  • "reference_number": "string",
  • "title": "string",
  • "url": "string",
  • "last_verified": "2019-08-24",
  • "notes": "string"
}

Update a bait product safety reference

Authorizations:
trap_auth
path Parameters
baitProductUUID
required
string <uuid> (Bait Product UUID)
referenceUUID
required
string <uuid> (Reference UUID)
Request Body schema: application/json
reference_type
string
authority
string
reference_number
string
title
string
url
string
last_verified
string <date>
notes
string

Responses

Request samples

Content type
application/json
{
  • "reference_type": "string",
  • "authority": "string",
  • "reference_number": "string",
  • "title": "string",
  • "url": "string",
  • "last_verified": "2019-08-24",
  • "notes": "string"
}

Response samples

Content type
application/json
{
  • "uuid": "095be615-a8ad-4c33-8e9c-c7612fbf6c9f",
  • "bait_product_uuid": "8addb1fb-31d4-45b1-8246-3603d373a3e8",
  • "reference_type": "string",
  • "authority": "string",
  • "reference_number": "string",
  • "title": "string",
  • "url": "string",
  • "last_verified": "2019-08-24",
  • "notes": "string"
}

Delete a bait product safety reference

Authorizations:
trap_auth
path Parameters
baitProductUUID
required
string <uuid> (Bait Product UUID)
referenceUUID
required
string <uuid> (Reference UUID)

Responses

Response samples

Content type
application/json
"string"

Ad hoc

Get records

Get records, ordered from least recently changed to most recently changed.

Authorizations:
trap_auth
query Parameters
changed_since
string <date-time>

Only return entities changed since this date.

changed_since_uuid
string <uuid>

Only return entities changed since this UUID, if the date is equal to changed_since.

organisation
string <uuid> (Organisation UUID)

Only return entities associated with this organisation.

project
string <uuid> (Project UUID)

Only return entities associated with this project.

limit
integer [ 1 .. 100000 ]
Default: 1000

Only return up to this many entities. Tentatively limited to 100,000.

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Create ad hoc kill

Create a new ad hoc kill

Authorizations:
trap_auth
header Parameters
App-Version
string (App Version)

The app version to record along with a commit ID.

Request Body schema: application/json
date
required
string <date-time> (Date of record)
recorded_by
string (Recorded By)

The name of the recorder

required
object (Kill)

The animal killed

required
object (Project)

The project this trap belongs to

required
object (Point)

The location of the kill

Array of objects (Images)
notes
string (Notes)
object (Metadata)
commit_id
string (commitId)

Responses

Request samples

Content type
application/json
{
  • "date": "2019-08-24T14:15:22Z",
  • "recorded_by": "string",
  • "kill": {
    },
  • "project": {
    },
  • "location": {
    },
  • "images": [
    ],
  • "notes": "string",
  • "meta": {
    },
  • "commit_id": "string"
}

Response samples

Content type
application/json
{
  • "uuid": "095be615-a8ad-4c33-8e9c-c7612fbf6c9f",
  • "date": "2019-08-24T14:15:22Z",
  • "recorded_by": "string",
  • "kill": {
    },
  • "project": {
    },
  • "location": {
    },
  • "images": [
    ],
  • "notes": "string",
  • "meta": {
    }
}

Get ad hoc kill

Get a single ad hoc kill record

Authorizations:
trap_auth
path Parameters
recordUUID
required
string <uuid>

Responses

Response samples

Content type
application/json
{
  • "uuid": "095be615-a8ad-4c33-8e9c-c7612fbf6c9f",
  • "date": "2019-08-24T14:15:22Z",
  • "recorded_by": "string",
  • "kill": {
    },
  • "project": {
    },
  • "location": {
    },
  • "images": [
    ],
  • "notes": "string",
  • "meta": {
    }
}

Update ad hoc kill

Update an ad hoc kill record

Authorizations:
trap_auth
path Parameters
recordUUID
required
string <uuid>
header Parameters
App-Version
string (App Version)

The app version to record along with a commit ID.

Request Body schema: application/json
date
string <date-time> (Date of record)
recorded_by
string (Recorded By)

The name of the recorder

object (Kill)

The animal killed

object (Point)

The location of the kill

Array of objects (Images)
notes
string (Notes)

Responses

Request samples

Content type
application/json
{
  • "date": "2019-08-24T14:15:22Z",
  • "recorded_by": "string",
  • "kill": {
    },
  • "location": {
    },
  • "images": [
    ],
  • "notes": "string"
}

Response samples

Content type
application/json
{
  • "uuid": "095be615-a8ad-4c33-8e9c-c7612fbf6c9f",
  • "date": "2019-08-24T14:15:22Z",
  • "recorded_by": "string",
  • "kill": {
    },
  • "project": {
    },
  • "location": {
    },
  • "images": [
    ],
  • "notes": "string",
  • "meta": {
    }
}

Get observations

Get observations, ordered from least recently changed to most recently changed.

Authorizations:
trap_auth
query Parameters
changed_since
string <date-time>

Only return entities changed since this date.

changed_since_uuid
string <uuid>

Only return entities changed since this UUID, if the date is equal to changed_since.

organisation
string <uuid> (Organisation UUID)

Only return entities associated with this organisation.

project
string <uuid> (Project UUID)

Only return entities associated with this project.

limit
integer [ 1 .. 100000 ]
Default: 1000

Only return up to this many entities. Tentatively limited to 100,000.

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Create ad hoc observation

Create a new ad hoc observation

Authorizations:
trap_auth
header Parameters
App-Version
string (App Version)

The app version to record along with a commit ID.

Request Body schema: application/json
date
required
string <date-time> (Date of record)
recorded_by
string (Recorded By)

The name of the recorder

required
object or object
required
Array of objects or objects (Species)
required
object (Project)

The project this station belongs to

required
object (Point)

The location of the observation

Array of objects (Images)
notes
string (Notes)
object (Metadata)
commit_id
string (commitId)

Responses

Request samples

Content type
application/json
{
  • "date": "2019-08-24T14:15:22Z",
  • "recorded_by": "string",
  • "observation_type": {
    },
  • "species": [
    ],
  • "project": {
    },
  • "location": {
    },
  • "images": [
    ],
  • "notes": "string",
  • "meta": {
    },
  • "commit_id": "string"
}

Response samples

Content type
application/json
{
  • "uuid": "095be615-a8ad-4c33-8e9c-c7612fbf6c9f",
  • "date": "2019-08-24T14:15:22Z",
  • "recorded_by": "string",
  • "species": [
    ],
  • "project": {
    },
  • "location": {
    },
  • "images": [
    ],
  • "notes": "string",
  • "meta": {
    },
  • "observation_type": {
    },
  • "disturbed": false,
  • "bait_lure": {
    },
  • "survey_event": {
    },
  • "protocol": {
    }
}

Get ad hoc observation

Get a single ad hoc observation record

Authorizations:
trap_auth
path Parameters
recordUUID
required
string <uuid>

Responses

Response samples

Content type
application/json
{
  • "uuid": "095be615-a8ad-4c33-8e9c-c7612fbf6c9f",
  • "date": "2019-08-24T14:15:22Z",
  • "recorded_by": "string",
  • "species": [
    ],
  • "project": {
    },
  • "location": {
    },
  • "images": [
    ],
  • "notes": "string",
  • "meta": {
    },
  • "observation_type": {
    },
  • "disturbed": false,
  • "bait_lure": {
    },
  • "survey_event": {
    },
  • "protocol": {
    }
}

Update ad hoc observation

Update an ad hoc observation record

Authorizations:
trap_auth
path Parameters
recordUUID
required
string <uuid>
header Parameters
App-Version
string (App Version)

The app version to record along with a commit ID.

Request Body schema: application/json
date
string <date-time> (Date of record)
recorded_by
string (Recorded By)

The name of the recorder

Array of objects (Species)
object (Point)

The location of the observation

Array of objects (Images)
notes
string (Notes)

Responses

Request samples

Content type
application/json
{
  • "date": "2019-08-24T14:15:22Z",
  • "recorded_by": "string",
  • "species": [
    ],
  • "location": {
    },
  • "images": [
    ],
  • "notes": "string"
}

Response samples

Content type
application/json
{
  • "uuid": "095be615-a8ad-4c33-8e9c-c7612fbf6c9f",
  • "date": "2019-08-24T14:15:22Z",
  • "recorded_by": "string",
  • "species": [
    ],
  • "project": {
    },
  • "location": {
    },
  • "images": [
    ],
  • "notes": "string",
  • "meta": {
    },
  • "observation_type": {
    },
  • "disturbed": false,
  • "bait_lure": {
    },
  • "survey_event": {
    },
  • "protocol": {
    }
}

Delete ad hoc observation

Deletes the ad hoc observation.

Authorizations:
trap_auth
path Parameters
recordUUID
required
string <uuid>
header Parameters
App-Version
string (App Version)

The app version to record along with a commit ID.

Responses

Response samples

Content type
application/json
{
  • "message": "string",
  • "uuid": "095be615-a8ad-4c33-8e9c-c7612fbf6c9f"
}

Bait Stations

Get bait stations

Authorizations:
trap_auth
query Parameters
changed_since
string <date-time>

Only return entities changed since this date.

changed_since_uuid
string <uuid>

Only return entities changed since this UUID, if the date is equal to changed_since.

organisation
string <uuid> (Organisation UUID)

Only return entities associated with this organisation.

is_retired
boolean (Retired state)

The entities retired state

date_installed_before
string <date-time>

Only return entities installed before this date.

date_installed_since
string <date-time>

Only return entities installed since this date.

Array of Project UUID (strings) or string

Only return entities associated with one or more projects.

Array of Line UUID (strings) or string

Only return entities associated with one or more lines.

Array of Area UUID (strings) or string

Only return entities located within one or more areas.

projectNid
integer (Project Node Id)
Deprecated

Only return entities associated with this project.

has_sensor
boolean

Only return entities if they have (true) or don't have (false) a sensor configured.

can_edit
boolean

Only return entities if the requesting user can (true) or can't (false) edit them. To "edit" includes the action of creating an associated record.

limit
integer [ 1 .. 100000 ]
Default: 1000

Only return up to this many entities. Tentatively limited to 100,000.

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Create bait station

Create a new bait station

Authorizations:
trap_auth
header Parameters
App-Version
string (App Version)

The app version to record along with a commit ID.

Request Body schema: application/json
name
required
string (Name)
Array of objects (Tags)
date_installed
required
string <date-time> (Date Installed)

The date of installation

installed_by
string (Installed By)

The name of the installer

required
object or object
object (Line)

The line this bait station belongs to

required
object (Project)

The project this bait station belongs to

required
object (Point)

The location of this bait station, as GeoJSON

notes
string (Notes)
Array of objects or objects
is_retired
required
boolean (Is retired?)
object (Sensor)
object (Contact details)
weight
integer (Weight)

The sort weight for this bait station within its line

commit_id
string (commitId)

Responses

Request samples

Content type
application/json
{
  • "name": "string",
  • "tags": [
    ],
  • "date_installed": "2019-08-24T14:15:22Z",
  • "installed_by": "string",
  • "device_model": {
    },
  • "line": {
    },
  • "project": {
    },
  • "location": {
    },
  • "notes": "string",
  • "images": [
    ],
  • "is_retired": true,
  • "sensor": {
    },
  • "contact": {
    },
  • "weight": 0,
  • "commit_id": "string"
}

Response samples

Content type
application/json
{
  • "uuid": "095be615-a8ad-4c33-8e9c-c7612fbf6c9f",
  • "name": "string",
  • "tags": [
    ],
  • "date_installed": "2019-08-24T14:15:22Z",
  • "installed_by": "string",
  • "device_model": {
    },
  • "line": {
    },
  • "project": {
    },
  • "location": {
    },
  • "notes": "string",
  • "images": [
    ],
  • "is_retired": true,
  • "sensor": {
    },
  • "contact": {
    },
  • "weight": 0,
  • "last_record": {
    },
  • "meta": {
    },
  • "qr_code": "string"
}

Get bait station

Get a single bait station

Authorizations:
trap_auth
path Parameters
baitStationUUID
required
string <uuid>

Responses

Response samples

Content type
application/json
{
  • "uuid": "095be615-a8ad-4c33-8e9c-c7612fbf6c9f",
  • "name": "string",
  • "tags": [
    ],
  • "date_installed": "2019-08-24T14:15:22Z",
  • "installed_by": "string",
  • "device_model": {
    },
  • "line": {
    },
  • "project": {
    },
  • "location": {
    },
  • "notes": "string",
  • "images": [
    ],
  • "is_retired": true,
  • "sensor": {
    },
  • "contact": {
    },
  • "weight": 0,
  • "last_record": {
    },
  • "meta": {
    },
  • "qr_code": "string"
}

Update bait station

Update a single bait station

Authorizations:
trap_auth
path Parameters
baitStationUUID
required
string <uuid>
header Parameters
App-Version
string (App Version)

The app version to record along with a commit ID.

Request Body schema: application/json
name
string (Name)
date_installed
string <date-time> (Date Installed)

The date of installation

installed_by
string (Installed By)

The name of the installer

object or object
object (Line)

The line this bait station belongs to

object (Point)

The location of this bait station, as GeoJSON

notes
string (Notes)
Array of objects or objects
is_retired
boolean (Is retired?)
object (Sensor)
object (Contact details)
weight
integer (Weight)

The sort weight for this bait station within its line

Responses

Request samples

Content type
application/json
{
  • "name": "string",
  • "date_installed": "2019-08-24T14:15:22Z",
  • "installed_by": "string",
  • "device_model": {
    },
  • "line": {
    },
  • "location": {
    },
  • "notes": "string",
  • "images": [
    ],
  • "is_retired": true,
  • "sensor": {
    },
  • "contact": {
    },
  • "weight": 0
}

Response samples

Content type
application/json
{
  • "uuid": "095be615-a8ad-4c33-8e9c-c7612fbf6c9f",
  • "name": "string",
  • "tags": [
    ],
  • "date_installed": "2019-08-24T14:15:22Z",
  • "installed_by": "string",
  • "device_model": {
    },
  • "line": {
    },
  • "project": {
    },
  • "location": {
    },
  • "notes": "string",
  • "images": [
    ],
  • "is_retired": true,
  • "sensor": {
    },
  • "contact": {
    },
  • "weight": 0,
  • "last_record": {
    },
  • "meta": {
    },
  • "qr_code": "string"
}

Delete bait station

Deletes the bait station. Bait station records must be deleted first. Any sensor on the bait station is released and can be installed elsewhere.

Authorizations:
trap_auth
path Parameters
baitStationUUID
required
string <uuid>
header Parameters
App-Version
string (App Version)

The app version to record along with a commit ID.

Responses

Response samples

Content type
application/json
{
  • "message": "string",
  • "uuid": "095be615-a8ad-4c33-8e9c-c7612fbf6c9f"
}

Get bait station records

Authorizations:
trap_auth
query Parameters
changed_since
string <date-time>

Only return entities changed since this date.

changed_before
string <date-time>

Only return entities changed before this date.

changed_since_uuid
string <uuid>

Only return entities changed since this UUID, if the date is equal to changed_since.

organisation
string <uuid> (Organisation UUID)

Only return entities associated with this organisation.

limit
integer [ 1 .. 100000 ]
Default: 1000

Only return up to this many entities. Tentatively limited to 100,000.

offset
integer >= 0
Default: 0

Offset the page returned by this many records

sort_order
string
Default: "asc"
Enum: "asc" "desc"

provide a sort order / direction

is_retired
boolean (Retired state)

The entities retired state

Array of Project UUID (strings) or Project UUID (string) (Project UUID)

Only return entities associated with one or more projects.

Array of Line UUID (strings) or Line UUID (string) (Line UUID)

Only return entities associated with one or more lines.

date_before
string <date-time>

Only return entities with date field before this date.

date_since
string <date-time>

Only return entities with date field after or since this date.

Array of Species detected (strings) or string

Only return entities associated with one or more species detected.

Array of Active Ingredients (strings) or string

Only return entities associated with one or more active_ingredients.

Array of Target species (strings) or string

Only return entities associated with one or more target species.

Array of Formulations (strings) or string

Only return entities associated with one or more formulations.

sort_column
string
Default: "changed"
Enum: "nid" "uuid" "created" "changed" "bait_station_name" "bait_station_nid" "bait_station_uuid" "date" "recorded_by" "active_ingredient" "target_species" "species_detected" "formulation" "concentration" "bait_remaining" "bait_removed" "bait_added" "notes" "images"

provide a field to sort by

bait_station
string <uuid> (Bait Station UUID)

Only return records associated with this bait station.

Responses

Response samples

Content type
application/json
{
  • "total": 0,
  • "items": [
    ]
}

Create bait station record

Create a new bait station record

Authorizations:
trap_auth
header Parameters
App-Version
string (App Version)

The app version to record along with a commit ID.

Request Body schema: application/json
required
object
date
required
string <date-time> (Date of record)
recorded_by
string (Recorded By)

The name of the recorder

active_ingredient
string (Active Ingredient)
target_species
required
string (Target Species)
Array of objects or objects
formulation
string (Formulation)
concentration
number (Concentration)
bait_product_uuid
string <uuid> (Bait product UUID)

Product applied on this visit. When set, formulation / active_ingredient / concentration may be omitted and will be copied from the product. Stored on the record's field_bsrec_bait_product field.

bait_remaining
required
number (Bait Remaining (kg))
bait_removed
number (Bait Removed (kg))
bait_added
number (Bait Added (kg))
notes
string (Notes)
Array of objects (Images)
commit_id
string (commitId)

Responses

Request samples

Content type
application/json
{
  • "bait_station": {
    },
  • "date": "2019-08-24T14:15:22Z",
  • "recorded_by": "string",
  • "active_ingredient": "string",
  • "target_species": "string",
  • "species_detected": [
    ],
  • "formulation": "string",
  • "concentration": 0,
  • "bait_product_uuid": "8addb1fb-31d4-45b1-8246-3603d373a3e8",
  • "bait_remaining": 0,
  • "bait_removed": 0,
  • "bait_added": 0,
  • "notes": "string",
  • "images": [
    ],
  • "commit_id": "string"
}

Response samples

Content type
application/json
{
  • "uuid": "095be615-a8ad-4c33-8e9c-c7612fbf6c9f",
  • "bait_station": {
    },
  • "date": "2019-08-24T14:15:22Z",
  • "recorded_by": "string",
  • "active_ingredient": "string",
  • "target_species": "string",
  • "species_detected": [
    ],
  • "formulation": "string",
  • "concentration": 0,
  • "bait_product": {
    },
  • "bait_remaining": 0,
  • "bait_removed": 0,
  • "bait_added": 0,
  • "notes": "string",
  • "images": [
    ],
  • "meta": {
    }
}

Get bait station record

Get a single bait station record

Authorizations:
trap_auth
path Parameters
baitStationRecordUUID
required
string <uuid>

Responses

Response samples

Content type
application/json
{
  • "uuid": "095be615-a8ad-4c33-8e9c-c7612fbf6c9f",
  • "bait_station": {
    },
  • "date": "2019-08-24T14:15:22Z",
  • "recorded_by": "string",
  • "active_ingredient": "string",
  • "target_species": "string",
  • "species_detected": [
    ],
  • "formulation": "string",
  • "concentration": 0,
  • "bait_product": {
    },
  • "bait_remaining": 0,
  • "bait_removed": 0,
  • "bait_added": 0,
  • "notes": "string",
  • "images": [
    ],
  • "meta": {
    }
}

Update bait station record

Update a single bait station record

Authorizations:
trap_auth
path Parameters
baitStationRecordUUID
required
string <uuid>
header Parameters
App-Version
string (App Version)

The app version to record along with a commit ID.

Request Body schema: application/json
date
string <date-time> (Date of record)
recorded_by
string (Recorded By)

The name of the recorder

active_ingredient
string (Active Ingredient)
target_species
string (Target Species)
Array of objects or objects
formulation
string (Formulation)
concentration
number (Concentration)
bait_product_uuid
string or null <uuid> (Bait product UUID)

Product applied on this visit. When set, formulation / active_ingredient / concentration may be omitted and will be copied from the product. Omit to leave the current product unchanged; send null to clear it.

bait_remaining
number (Bait Remaining (kg))
bait_removed
number (Bait Removed (kg))
bait_added
number (Bait Added (kg))
notes
string (Notes)
Array of objects (Images)

Responses

Request samples

Content type
application/json
{
  • "date": "2019-08-24T14:15:22Z",
  • "recorded_by": "string",
  • "active_ingredient": "string",
  • "target_species": "string",
  • "species_detected": [
    ],
  • "formulation": "string",
  • "concentration": 0,
  • "bait_product_uuid": "8addb1fb-31d4-45b1-8246-3603d373a3e8",
  • "bait_remaining": 0,
  • "bait_removed": 0,
  • "bait_added": 0,
  • "notes": "string",
  • "images": [
    ]
}

Response samples

Content type
application/json
{
  • "uuid": "095be615-a8ad-4c33-8e9c-c7612fbf6c9f",
  • "bait_station": {
    },
  • "date": "2019-08-24T14:15:22Z",
  • "recorded_by": "string",
  • "active_ingredient": "string",
  • "target_species": "string",
  • "species_detected": [
    ],
  • "formulation": "string",
  • "concentration": 0,
  • "bait_product": {
    },
  • "bait_remaining": 0,
  • "bait_removed": 0,
  • "bait_added": 0,
  • "notes": "string",
  • "images": [
    ],
  • "meta": {
    }
}

Delete bait station record

Deletes the bait station record.

Authorizations:
trap_auth
path Parameters
baitStationRecordUUID
required
string <uuid>
header Parameters
App-Version
string (App Version)

The app version to record along with a commit ID.

Responses

Response samples

Content type
application/json
{
  • "message": "string",
  • "uuid": "095be615-a8ad-4c33-8e9c-c7612fbf6c9f"
}

Bait Stations Species Detected

Get bait station records species detected

Authorizations:
trap_auth
query Parameters
Array of Project UUID (strings) or Project UUID (string) (Project UUID)

Only return entities associated with one or more projects.

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Bait Stations Formulations

Get bait station records formulations

Authorizations:
trap_auth
query Parameters
Array of Project UUID (strings) or Project UUID (string) (Project UUID)

Only return entities associated with one or more projects.

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Bait Stations Active Ingredients

Get bait station records active ingredients

Authorizations:
trap_auth
query Parameters
Array of Project UUID (strings) or Project UUID (string) (Project UUID)

Only return entities associated with one or more projects.

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Bait Stations Target Species

Get bait station records target species

Authorizations:
trap_auth
query Parameters
Array of Project UUID (strings) or Project UUID (string) (Project UUID)

Only return entities associated with one or more projects.

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Monitoring Stations

Get monitoring stations

Authorizations:
trap_auth
query Parameters
changed_since
string <date-time>

Only return entities changed since this date.

changed_since_uuid
string <uuid>

Only return entities changed since this UUID, if the date is equal to changed_since.

organisation
string <uuid> (Organisation UUID)

Only return entities associated with this organisation.

project
string <uuid> (Project UUID)

Only return entities associated with this project.

date_installed_before
string <date-time>

Only return entities installed before this date.

date_installed_since
string <date-time>

Only return entities installed since this date.

projectNid
integer (Project Node Id)
Deprecated

Only return entities associated with this project.

line
string <uuid> (Line UUID)

Only return entities associated with this line.

limit
integer [ 1 .. 100000 ]
Default: 1000

Only return up to this many entities. Tentatively limited to 100,000.

is_retired
boolean (Retired state)

The entities retired state

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Create monitoring station

Create a new monitoring station

Authorizations:
trap_auth
header Parameters
App-Version
string (App Version)

The app version to record along with a commit ID.

Request Body schema: application/json
name
required
string (Name)
Array of objects (Tags)
date_installed
required
string <date-time> (Date Installed)

The date of installation

installed_by
string (Installed By)

The name of the installer

required
object or object
object (Line)

The line this monitoring station belongs to

required
object (Project)

The project this monitoring station belongs to

required
object (Point)

The location of this monitoring station, as GeoJSON

notes
string (Notes)
Array of objects
is_retired
required
boolean (Is retired?)
object (Contact details)
is_one_off
boolean (Is one-off?)
weight
integer (Weight)

The sort weight for this monitoring station within its line

commit_id
string (commitId)

Responses

Request samples

Content type
application/json
{
  • "name": "string",
  • "tags": [
    ],
  • "date_installed": "2019-08-24T14:15:22Z",
  • "installed_by": "string",
  • "device_model": {
    },
  • "line": {
    },
  • "project": {
    },
  • "location": {
    },
  • "notes": "string",
  • "images": [
    ],
  • "is_retired": true,
  • "contact": {
    },
  • "is_one_off": true,
  • "weight": 0,
  • "commit_id": "string"
}

Response samples

Content type
application/json
{
  • "uuid": "095be615-a8ad-4c33-8e9c-c7612fbf6c9f",
  • "name": "string",
  • "tags": [
    ],
  • "date_installed": "2019-08-24T14:15:22Z",
  • "installed_by": "string",
  • "device_model": {
    },
  • "line": {
    },
  • "project": {
    },
  • "location": {
    },
  • "notes": "string",
  • "images": [
    ],
  • "is_retired": true,
  • "contact": {
    },
  • "is_one_off": true,
  • "weight": 0,
  • "last_record": null,
  • "meta": {
    },
  • "qr_code": "string"
}

Get monitoring station

Get a single monitoring station

Authorizations:
trap_auth
path Parameters
monitoringStationUUID
required
string <uuid>

Responses

Response samples

Content type
application/json
{
  • "uuid": "095be615-a8ad-4c33-8e9c-c7612fbf6c9f",
  • "name": "string",
  • "tags": [
    ],
  • "date_installed": "2019-08-24T14:15:22Z",
  • "installed_by": "string",
  • "device_model": {
    },
  • "line": {
    },
  • "project": {
    },
  • "location": {
    },
  • "notes": "string",
  • "images": [
    ],
  • "is_retired": true,
  • "contact": {
    },
  • "is_one_off": true,
  • "weight": 0,
  • "last_record": null,
  • "meta": {
    },
  • "qr_code": "string"
}

Update monitoring station

Update a single monitoring station

Authorizations:
trap_auth
path Parameters
monitoringStationUUID
required
string <uuid>
header Parameters
App-Version
string (App Version)

The app version to record along with a commit ID.

Request Body schema: application/json
name
string (Name)
date_installed
string <date-time> (Date Installed)

The date of installation

installed_by
string (Installed By)

The name of the installer

object or object
object (Line)

The line this monitoring station belongs to

object (Point)

The location of this monitoring station, as GeoJSON

notes
string (Notes)
Array of objects
is_retired
boolean (Is retired?)
object (Contact details)
is_one_off
boolean (Is one-off?)
weight
integer (Weight)

The sort weight for this monitoring station within its line

Responses

Request samples

Content type
application/json
{
  • "name": "string",
  • "date_installed": "2019-08-24T14:15:22Z",
  • "installed_by": "string",
  • "device_model": {
    },
  • "line": {
    },
  • "location": {
    },
  • "notes": "string",
  • "images": [
    ],
  • "is_retired": true,
  • "contact": {
    },
  • "is_one_off": true,
  • "weight": 0
}

Response samples

Content type
application/json
{
  • "uuid": "095be615-a8ad-4c33-8e9c-c7612fbf6c9f",
  • "name": "string",
  • "tags": [
    ],
  • "date_installed": "2019-08-24T14:15:22Z",
  • "installed_by": "string",
  • "device_model": {
    },
  • "line": {
    },
  • "project": {
    },
  • "location": {
    },
  • "notes": "string",
  • "images": [
    ],
  • "is_retired": true,
  • "contact": {
    },
  • "is_one_off": true,
  • "weight": 0,
  • "last_record": null,
  • "meta": {
    },
  • "qr_code": "string"
}

Delete monitoring station

Deletes the monitoring station. Monitoring records must be deleted first.

Authorizations:
trap_auth
path Parameters
monitoringStationUUID
required
string <uuid>
header Parameters
App-Version
string (App Version)

The app version to record along with a commit ID.

Responses

Response samples

Content type
application/json
{
  • "message": "string",
  • "uuid": "095be615-a8ad-4c33-8e9c-c7612fbf6c9f"
}

Terms

Get global term values

Authorizations:
trap_auth
query Parameters
vocabulary
string (Global vocabulary machine name)
Enum: "bait_active_ingredient" "bait_formulation" "bait_station_type" "bait_target_species" "bird_species" "line_type" "region" "regional_districts" "trap_species_caught" "trap_sensor_provider" "trap_status" "trap_type" "trap_type_all" "control_means"

Only return terms associated with a given vocabulary machine name.

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Get terms for a given projectUUID

Authorizations:
trap_auth
path Parameters
projectUUID
required
string <uuid> (Project UUID)
query Parameters
vocabulary
string (Project vocabulary machine name)
Enum: "bait_station_species_detected" "monitoring_bait" "monitoring_protocol" "monitoring_species" "monitoring_survey_event" "monitoring_type" "poi_type" "project_record_type" "trap_bait_type"

Only return terms associated with a given vocabulary machine name.

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Internal

Submit app log data

Authorizations:
app_auth
Request Body schema: application/json
object

Responses

Request samples

Content type
application/json
{ }

Response samples

Content type
application/json
"string"

Areas

Get work areas by project

Authorizations:
trap_auth
query Parameters
changed_since
string <date-time>

Only return entities changed since this date.

changed_since_uuid
string <uuid>

Only return entities changed since this UUID, if the date is equal to changed_since.

limit
integer [ 1 .. 100000 ]
Default: 1000

Only return up to this many entities. Tentatively limited to 100,000.

Array of Project UUID (strings) or Project UUID (string) (Project UUID)

Only return entities associated with one or more projects.

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Create new area under a project

Authorizations:
trap_auth
Request Body schema: application/json

Work Area to create for a project

name
string (Work Area Name)
project_uuid
required
string <uuid> (Project)

The project which this area belongs to

boundary
required
string <wkt> (wkt_polygon)
review_date
string <date-time> (Work Area review date)
notes
string (Work Area notes)
object

Responses

Request samples

Content type
application/json
{
  • "name": "string",
  • "project_uuid": "1de37675-f868-4726-bb1d-b08d89f463f9",
  • "boundary": "string",
  • "review_date": "2019-08-24T14:15:22Z",
  • "notes": "string",
  • "meta": {
    }
}

Response samples

Content type
application/json
{
  • "message": "string",
  • "area": {
    }
}

Get area

Authorizations:
trap_auth
path Parameters
areaUUID
required
string <uuid> (Work Area UUID)

Responses

Response samples

Content type
application/json
{
  • "name": "string",
  • "uuid": "095be615-a8ad-4c33-8e9c-c7612fbf6c9f",
  • "project_uuid": "1de37675-f868-4726-bb1d-b08d89f463f9",
  • "boundary": "string",
  • "approved": true,
  • "approval_uuid": "d657dcda-a61d-431e-b8b3-61cdd09ef609",
  • "approval_state": "approved",
  • "review_date": "2019-08-24T14:15:22Z",
  • "notes": "string",
  • "meta": {
    }
}

Update area

Authorizations:
trap_auth
path Parameters
areaUUID
required
string <uuid> (Work Area UUID)
Request Body schema: application/json

Work Area to update

name
string (Work Area Name)
boundary
string <wkt> (WKT Polygon)
review_date
string <date-time> (Work Area review date)
notes
string (Work Area notes)

Responses

Request samples

Content type
application/json
{
  • "name": "string",
  • "boundary": "string",
  • "review_date": "2019-08-24T14:15:22Z",
  • "notes": "string"
}

Response samples

Content type
application/json
{
  • "message": "string",
  • "area": {
    }
}

Delete area

Authorizations:
trap_auth
path Parameters
areaUUID
required
string <uuid> (Work Area UUID)

Responses

Response samples

Content type
application/json
{
  • "message": "string",
  • "uuid": "095be615-a8ad-4c33-8e9c-c7612fbf6c9f"
}

Approvals

Get approvals by project

Authorizations:
trap_auth
query Parameters
changed_since
string <date-time>

Only return entities changed since this date.

changed_since_uuid
string <uuid>

Only return entities changed since this UUID, if the date is equal to changed_since.

limit
integer [ 1 .. 100000 ]
Default: 1000

Only return up to this many entities. Tentatively limited to 100,000.

Array of Project UUID (strings) or Project UUID (string) (Project UUID)

Only return entities associated with one or more projects.

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Create new approval under a project

Authorizations:
trap_auth
Request Body schema: application/json

Approval to create for a project

area_uuid
required
string <uuid> (Area)

The area which this approval belongs to

project_uuid
required
string <uuid> (Project)

The project which this approval belongs to

owner_trap_servicing
boolean (Owner trap/install servicing)

Owner will take care of trap/installation servicing

owner_app_usage
boolean (Owner app usage)

Owner will use mobile app

owner_website_usage
boolean (Owner website usage)

Owner will use website

allow_mechanical_traps
boolean (Allow mechanical traps)

Permission to use mechanical traps

allow_camera_traps
boolean (Allow camera traps)

Permission to use camera traps and trail cameras

allow_toxins
boolean (Allow toxins)

Permission to use toxins and bait stations

allow_radio_transmission
boolean (Allow radio transmissions)

Permission to use trap sensors/transmitters on installations

allow_dog_detection
boolean (Allow dog detection)

Permission to use dog detection

allow_property_access
boolean (Allow property access)

Permission for staff to access through the property

allow_vegetation_pruning
boolean (Allow vegetation pruning)

Permission to prune vegetation for access, if required

bait_types
Array of strings (Bait types)

Approved bait type names for use on site

bait_station_types_approved
Array of strings (Bait Station Types Approved)

Approved bait station types (e.g. KK, Striker, Pelgar, Tunnel)

toxin_formulation_preference
string (Toxin Formulation Preference)

Preferred toxin formulation (e.g. pellet, block)

allow_site_photos
boolean (Allow site photos)

Permission to take photos on property

permission_source
string (Permission Source)

How permission was obtained (e.g. online, in person, phone, email)

locked_devices_required
boolean (Locked devices required)

Whether locked devices are required on site

notify_before_arrival
boolean (Notify before arrival)

Whether staff should notify before arrival when visiting

further_updates_or_involvement
boolean (Further updates or involvement)

Whether the owner would like further updates or opportunities for involvement

object (Owner contact phone) non-empty
household_bait_allergy_present
boolean (Bait allergy present in household)

Bait allergy present in household, e.g. use of nut butters in lure/bait is not accepted.

household_bait_allergy_description
string (Bait allergy site description/notes)

Bait allergy site description/notes, type of bait, reaction likelihood etc

dog_onsite
boolean (Dog on site)

Dog on site

dog_onsite_description
string (Dog on site description/notes)

Dog on site description/notes, type of dog, whereabouts, how aggressive etc.

is_owner
boolean (Property owner)

Whether the contact is the property owner

is_owner_desc
string (Owner description)

Description if not owner (e.g. tenant, squatter)

cats_onsite
integer (Cats) >= 0

Number of cats on site

staff_member_name
string (Staff member name)

Name of the staff member associated with this approval

signup_date
string <date> (Date of signup)

Date the landowner signed up

most_recent_reconfirmation_date
string <date> (Most recent reconfirmation date)

Date the approval was most recently reconfirmed

please_knock_on_door
boolean (Please knock on the door)

On each site visit, does the owner want us to knock on the door to announce our arrival?

heard_of_project_beforehand
boolean (heard of project before this engagement)

Has the owner heard of this project before

approval_date
string <date-time> (Approval date)

Date of approval

owner_contact_email
string <email> (Owner contact email)

Owners contact email address

owner_first_names
required
string (Owner first names)

Owners first names

owner_surname
required
string (Owner surname)

Owners surname

potential_hazards
string (Potential Hazards)

Potential hazards onsite

access_security_details
string (Access security details)

Security details for access onsite

street_address
required
string (Street Address)

Address for accessing site

signed_approval
string <byte> (Signed approval)

byte (which is the standard format for a base64 encoded string) array - enforce file size below below 1000KB

approved
boolean (Approved status)

Has the owner explicitly approved this

owner_comms_preference
string (Owner communication preference)

Owner communication preference (email, phone, other?)

notes
string (Notes)

Other notes relating to site and approval (caveats etc)

Responses

Request samples

Content type
application/json
{
  • "area_uuid": "23f67669-918a-4ed0-bb44-b0229619d79c",
  • "project_uuid": "1de37675-f868-4726-bb1d-b08d89f463f9",
  • "owner_trap_servicing": true,
  • "owner_app_usage": true,
  • "owner_website_usage": true,
  • "allow_mechanical_traps": true,
  • "allow_camera_traps": true,
  • "allow_toxins": true,
  • "allow_radio_transmission": true,
  • "allow_dog_detection": true,
  • "allow_property_access": true,
  • "allow_vegetation_pruning": true,
  • "bait_types": [
    ],
  • "bait_station_types_approved": [
    ],
  • "toxin_formulation_preference": "string",
  • "allow_site_photos": true,
  • "permission_source": "string",
  • "locked_devices_required": true,
  • "notify_before_arrival": true,
  • "further_updates_or_involvement": true,
  • "owner_contact_phone": {
    },
  • "household_bait_allergy_present": true,
  • "household_bait_allergy_description": "string",
  • "dog_onsite": true,
  • "dog_onsite_description": "string",
  • "is_owner": true,
  • "is_owner_desc": "string",
  • "cats_onsite": 0,
  • "staff_member_name": "string",
  • "signup_date": "2019-08-24",
  • "most_recent_reconfirmation_date": "2019-08-24",
  • "please_knock_on_door": true,
  • "heard_of_project_beforehand": true,
  • "approval_date": "2019-08-24T14:15:22Z",
  • "owner_contact_email": "[email protected]",
  • "owner_first_names": "string",
  • "owner_surname": "string",
  • "potential_hazards": "string",
  • "access_security_details": "string",
  • "street_address": "string",
  • "signed_approval": "string",
  • "approved": true,
  • "owner_comms_preference": "string",
  • "notes": "string"
}

Response samples

Content type
application/json
{
  • "message": "string",
  • "approval": {
    }
}

Get approval

Authorizations:
trap_auth
path Parameters
approvalUUID
required
string <uuid> (Approval UUID)

Responses

Response samples

Content type
application/json
{
  • "uuid": "095be615-a8ad-4c33-8e9c-c7612fbf6c9f",
  • "area_uuid": "23f67669-918a-4ed0-bb44-b0229619d79c",
  • "project_uuid": "1de37675-f868-4726-bb1d-b08d89f463f9",
  • "owner_trap_servicing": true,
  • "owner_app_usage": true,
  • "owner_website_usage": true,
  • "allow_mechanical_traps": true,
  • "allow_camera_traps": true,
  • "allow_toxins": true,
  • "allow_radio_transmission": true,
  • "allow_dog_detection": true,
  • "allow_property_access": true,
  • "allow_vegetation_pruning": true,
  • "bait_types": [
    ],
  • "bait_station_types_approved": [
    ],
  • "toxin_formulation_preference": "string",
  • "allow_site_photos": true,
  • "permission_source": "string",
  • "locked_devices_required": true,
  • "notify_before_arrival": true,
  • "further_updates_or_involvement": true,
  • "owner_contact_phone": {
    },
  • "household_bait_allergy_present": true,
  • "household_bait_allergy_description": "string",
  • "dog_onsite": true,
  • "dog_onsite_description": "string",
  • "is_owner": true,
  • "is_owner_desc": "string",
  • "cats_onsite": 0,
  • "staff_member_name": "string",
  • "signup_date": "2019-08-24",
  • "most_recent_reconfirmation_date": "2019-08-24",
  • "please_knock_on_door": true,
  • "heard_of_project_beforehand": true,
  • "approval_date": "2019-08-24T14:15:22Z",
  • "owner_contact_email": "[email protected]",
  • "owner_first_names": "string",
  • "owner_surname": "string",
  • "potential_hazards": "string",
  • "access_security_details": "string",
  • "street_address": "string",
  • "signed_approval": "string",
  • "approved": true,
  • "owner_comms_preference": "string",
  • "notes": "string",
  • "meta": {
    }
}

Update approval

Authorizations:
trap_auth
path Parameters
approvalUUID
required
string <uuid> (Approval UUID)
Request Body schema: application/json

Approval to update

area_uuid
string <uuid> (Area)

The area which this approval belongs to

project_uuid
string <uuid> (Project)

The project which this approval belongs to

owner_trap_servicing
boolean (Owner trap/install servicing)

Owner will take care of trap/installation servicing

owner_app_usage
boolean (Owner app usage)

Owner will use mobile app

owner_website_usage
boolean (Owner website usage)

Owner will use website

allow_mechanical_traps
boolean (Allow mechanical traps)

Permission to use mechanical traps

allow_camera_traps
boolean (Allow camera traps)

Permission to use camera traps and trail cameras

allow_toxins
boolean (Allow toxins)

Permission to use toxins and bait stations

allow_radio_transmission
boolean (Allow radio transmissions)

Permission to use trap sensors/transmitters on installations

allow_dog_detection
boolean (Allow dog detection)

Permission to use dog detection

allow_property_access
boolean (Allow property access)

Permission for staff to access through the property

allow_vegetation_pruning
boolean (Allow vegetation pruning)

Permission to prune vegetation for access, if required

bait_types
Array of strings (Bait types)

Approved bait type names for use on site

bait_station_types_approved
Array of strings (Bait Station Types Approved)

Approved bait station types (e.g. KK, Striker, Pelgar, Tunnel)

toxin_formulation_preference
string (Toxin Formulation Preference)

Preferred toxin formulation (e.g. pellet, block)

allow_site_photos
boolean (Allow site photos)

Permission to take photos on property

permission_source
string (Permission Source)

How permission was obtained (e.g. online, in person, phone, email)

locked_devices_required
boolean (Locked devices required)

Whether locked devices are required on site

notify_before_arrival
boolean (Notify before arrival)

Whether staff should notify before arrival when visiting

further_updates_or_involvement
boolean (Further updates or involvement)

Whether the owner would like further updates or opportunities for involvement

object (Owner contact phone) non-empty
household_bait_allergy_present
boolean (Bait allergy present in household)

Bait allergy present in household, e.g. use of nut butters in lure/bait is not accepted.

household_bait_allergy_description
string (Bait allergy site description/notes)

Bait allergy site description/notes, type of bait, reaction likelihood etc

dog_onsite
boolean (Dog on site)

Dog on site

dog_onsite_description
string (Dog on site description/notes)

Dog on site description/notes, type of dog, whereabouts, how aggressive etc.

is_owner
boolean (Property owner)

Whether the contact is the property owner

is_owner_desc
string (Owner description)

Description if not owner (e.g. tenant, squatter)

cats_onsite
integer (Cats) >= 0

Number of cats on site

staff_member_name
string (Staff member name)

Name of the staff member associated with this approval

signup_date
string <date> (Date of signup)

Date the landowner signed up

most_recent_reconfirmation_date
string <date> (Most recent reconfirmation date)

Date the approval was most recently reconfirmed

please_knock_on_door
boolean (Please knock on the door)

On each site visit, does the owner want us to knock on the door to announce our arrival?

heard_of_project_beforehand
boolean (heard of project before this engagement)

Has the owner heard of this project before

approval_date
string <date-time> (Approval date)

Date of approval

owner_contact_email
string <email> (Owner contact email)

Owners contact email address

owner_first_names
string (Owner first names)

Owners first names

owner_surname
string (Owner surname)

Owners surname

potential_hazards
string (Potential Hazards)

Potential hazards onsite

access_security_details
string (Access security details)

Security details for access onsite

street_address
string (Street Address)

Address for accessing site

signed_approval
string <byte> (Signed approval)

byte (which is the standard format for a base64 encoded string) array - enforce file size below below 1000KB

approved
boolean (Approved status)

Has the owner explicitly approved this

owner_comms_preference
string (Owner communication preference)

Owner communication preference (email, phone, other?)

notes
string (Notes)

Other notes relating to site and approval (caveats etc)

Responses

Request samples

Content type
application/json
{
  • "area_uuid": "23f67669-918a-4ed0-bb44-b0229619d79c",
  • "project_uuid": "1de37675-f868-4726-bb1d-b08d89f463f9",
  • "owner_trap_servicing": true,
  • "owner_app_usage": true,
  • "owner_website_usage": true,
  • "allow_mechanical_traps": true,
  • "allow_camera_traps": true,
  • "allow_toxins": true,
  • "allow_radio_transmission": true,
  • "allow_dog_detection": true,
  • "allow_property_access": true,
  • "allow_vegetation_pruning": true,
  • "bait_types": [
    ],
  • "bait_station_types_approved": [
    ],
  • "toxin_formulation_preference": "string",
  • "allow_site_photos": true,
  • "permission_source": "string",
  • "locked_devices_required": true,
  • "notify_before_arrival": true,
  • "further_updates_or_involvement": true,
  • "owner_contact_phone": {
    },
  • "household_bait_allergy_present": true,
  • "household_bait_allergy_description": "string",
  • "dog_onsite": true,
  • "dog_onsite_description": "string",
  • "is_owner": true,
  • "is_owner_desc": "string",
  • "cats_onsite": 0,
  • "staff_member_name": "string",
  • "signup_date": "2019-08-24",
  • "most_recent_reconfirmation_date": "2019-08-24",
  • "please_knock_on_door": true,
  • "heard_of_project_beforehand": true,
  • "approval_date": "2019-08-24T14:15:22Z",
  • "owner_contact_email": "[email protected]",
  • "owner_first_names": "string",
  • "owner_surname": "string",
  • "potential_hazards": "string",
  • "access_security_details": "string",
  • "street_address": "string",
  • "signed_approval": "string",
  • "approved": true,
  • "owner_comms_preference": "string",
  • "notes": "string"
}

Response samples

Content type
application/json
{
  • "message": "string",
  • "approval": {
    }
}

Delete approval

Authorizations:
trap_auth
path Parameters
approvalUUID
required
string <uuid> (Approval UUID)

Responses

Response samples

Content type
application/json
{
  • "message": "string",
  • "uuid": "095be615-a8ad-4c33-8e9c-c7612fbf6c9f"
}

Parcels

Get parcels by project

Authorizations:
trap_auth
query Parameters
limit
integer [ 1 .. 100000 ]
Default: 5000

Only return up to this many parcels. Defaults to 5000. Tentatively limited to 100,000.

project
required
string <uuid> (Project UUID)

Only return entities associated with this project.

bbox
string (Bounding box) ^-?\d+(\.\d+)?,-?\d+(\.\d+)?,-?\d+(\.\d+)?,-?...

Only return parcels intersecting this bounding box, given as minLon,minLat,maxLon,maxLat in WGS84, e.g. 170.48,-45.89,170.52,-45.87. Longitudes can go past ±180 to cross the antimeridian, e.g. 179,-44.5,184,-43.5 for the Chathams.

Responses

Response samples

Content type
application/json
{
  • "items": [
    ],
  • "truncated": true,
  • "attribution": "string"
}

Reachable?

Does nothing and returns No Content

query Parameters
_
any

Optional parameter for avoiding caching

Responses

Work Effort Report

Get Work Effort Report

Authorizations:
trap_auth
query Parameters
changed_since
string <date-time>

Only return entities changed since this date.

changed_before
string <date-time>

Only return entities changed before this date.

limit
integer [ 1 .. 100000 ]
Default: 1000

Only return up to this many entities. Tentatively limited to 100,000.

offset
integer >= 0
Default: 0

Offset the page returned by this many records

sort_order
string
Default: "asc"
Enum: "asc" "desc"

provide a sort order / direction

Array of Project UUID (strings) or Project UUID (string) (Project UUID)

Only return entities associated with one or more projects.

Array of Record type (strings) or string

Only return entities associated with one or more record types

sort_column
string
Default: "username"
Enum: "project" "username" "installs_serviced" "records" "service_time_mins"

provide a field to sort by

Responses

Response samples

Content type
application/json
{
  • "total": 0,
  • "total_installs_serviced": 0,
  • "total_records": 0,
  • "total_service_time_mins": 0,
  • "items": [
    ]
}

Install Service Report

Get Install Service Report

Authorizations:
trap_auth
query Parameters
changed_since
string <date-time>

Only return entities changed since this date.

changed_before
string <date-time>

Only return entities changed before this date.

limit
integer [ 1 .. 100000 ]
Default: 1000

Only return up to this many entities. Tentatively limited to 100,000.

offset
integer >= 0
Default: 0

Offset the page returned by this many records

sort_order
string
Default: "asc"
Enum: "asc" "desc"

provide a sort order / direction

Array of Project UUID (strings) or Project UUID (string) (Project UUID)

Only return entities associated with one or more projects.

Array of Record type (strings) or string

Only return entities associated with one or more installation types

sort_column
string
Default: "line"
Enum: "project" "line" "active" "installed" "retired" "installs_serviced" "avg_service_time_mins"

provide a field to sort by

Responses

Response samples

Content type
application/json
{
  • "total": 0,
  • "total_active": 0,
  • "total_installed": 0,
  • "total_retired": 0,
  • "total_installs_serviced": 0,
  • "agg_avg_service_time_mins": 0,
  • "items": [
    ]
}

Trapping Summary Report

Get Trapping Summary Report

Authorizations:
trap_auth
query Parameters
changed_since
string <date-time>

Only return entities changed since this date.

changed_before
string <date-time>

Only return entities changed before this date.

limit
integer [ 1 .. 100000 ]
Default: 1000

Only return up to this many entities. Tentatively limited to 100,000.

offset
integer >= 0
Default: 0

Offset the page returned by this many records

sort_order
string
Default: "asc"
Enum: "asc" "desc"

provide a sort order / direction

Array of Project UUID (strings) or Project UUID (string) (Project UUID)

Only return entities associated with one or more projects.

Array of Line UUID (strings) or Line UUID (string) (Line UUID)

Only return entities associated with one or more lines.

sort_column
string
Default: "line"
Enum: "project" "line" "active" "trap_nights" "installs_serviced" "avg_service_time_mins" "total_service_time_mins" "catches"

provide a field to sort by

Responses

Response samples

Content type
application/json
{
  • "total": 0,
  • "total_active": 0,
  • "total_installs_serviced": 0,
  • "total_trap_nights": 0,
  • "agg_avg_service_time_mins": 0,
  • "total_total_service_time_mins": 0,
  • "total_catches": 0,
  • "items": [
    ]
}

Trapping Summary Traptype Report

Get Trapping Summary by Trap type Report (Note WIP/experimental)

Authorizations:
trap_auth
query Parameters
changed_since
string <date-time>

Only return entities changed since this date.

changed_before
string <date-time>

Only return entities changed before this date.

limit
integer [ 1 .. 100000 ]
Default: 1000

Only return up to this many entities. Tentatively limited to 100,000.

offset
integer >= 0
Default: 0

Offset the page returned by this many records

sort_order
string
Default: "asc"
Enum: "asc" "desc"

provide a sort order / direction

project_tags
Array of strings (Project tags)

list of free-text tags applied to projects

Array of Project UUID (strings) or Project UUID (string) (Project UUID)

Only return entities associated with one or more projects.

sort_column
string
Default: "trap_type"
Enum: "project" "project_tags" "install_tags" "trap_type" "date_installed" "species_caught" "active" "installed" "retired" "trap_nights" "installs_serviced" "avg_service_time_mins" "total_service_time_mins" "catches"

provide a field to sort by

install_tags
Array of strings (Install tags)

list of free-text tags applied to installations

trap_type
Array of strings (Trap type)

Only return entities associated with one or more trap types.

species_caught
Array of strings (Species caught)

Only return entities associated with one or more species caught.

Responses

Response samples

Content type
application/json
{
  • "total": 0,
  • "total_active": 0,
  • "total_installed": 0,
  • "total_retired": 0,
  • "total_installs_serviced": 0,
  • "total_trap_nights": 0,
  • "agg_avg_service_time_mins": 0,
  • "total_total_service_time_mins": 0,
  • "total_catches": 0,
  • "project_tags_options": [
    ],
  • "install_tags_options": [
    ],
  • "species_caught_options": [
    ],
  • "trap_type_options": [
    ],
  • "items": [
    ]
}

Catch Rate Report

Get Catch Rate Report

Authorizations:
trap_auth
query Parameters
limit
integer [ 1 .. 100000 ]
Default: 1000

Only return up to this many entities. Tentatively limited to 100,000.

offset
integer >= 0
Default: 0

Offset the page returned by this many records

sort_order
string
Default: "asc"
Enum: "asc" "desc"

provide a sort order / direction

Array of Project UUID (strings) or Project UUID (string) (Project UUID)

Only return entities associated with one or more projects.

Array of Line UUID (strings) or Line UUID (string) (Line UUID)

Only return entities associated with one or more lines.

changedFromYear
integer (changed from year) [ 1997 .. 2100 ]

only return entities changed from this year inclusive

changedToYear
integer (changed to year) [ 1997 .. 2100 ]

only return entities changed before this year inclusive

sort_column
string
Default: "line"
Enum: "project" "line" "catch_year" "trap_nights" "installs_serviced" "catches" "catches_per_100_nights"

provide a field to sort by

Responses

Response samples

Content type
application/json
{
  • "total": 0,
  • "total_trap_nights": 0,
  • "total_catches": 0,
  • "agg_avg_catches_per_100_nights": 0,
  • "items": [
    ]
}

Deployment Marker Status Report

Get Deployment Marker Status

Authorizations:
trap_auth
query Parameters
created_since
string <date-time>

Only return entities created after or since this date.

created_before
string <date-time>

Only return entities created before this date.

limit
integer [ 1 .. 100000 ]
Default: 1000

Only return up to this many entities. Tentatively limited to 100,000.

offset
integer >= 0
Default: 0

Offset the page returned by this many records

sort_order
string
Default: "asc"
Enum: "asc" "desc"

provide a sort order / direction

project_tags
Array of strings (Project tags)

list of free-text tags applied to projects

Array of Record type (strings) or string

Only return entities associated with one or more installation types

Array of Project UUID (strings) or Project UUID (string) (Project UUID)

Only return entities associated with one or more projects.

Array of Line UUID (strings) or Line UUID (string) (Line UUID)

Only return entities associated with one or more lines.

Array of Area UUID (strings) or Area UUID (string) (Area UUID)

Only return entities associated with one or more areas.

sort_column
string
Default: "deployment_name"
Enum: "project" "line" "project_tags" "name" "deployment_state" "deployment_id" "planned_installation_type" "install_model_name" "created" "area"

provide a field to sort by

Array of Deployment State (strings) or string

Only return entities associated with one or more deployment states

Array of Install model UUID (strings) or Install model UUID (string) (Install model UUID)

only return records associated with one or more Installation device brands and/or models

Responses

Response samples

Content type
application/json
{
  • "total": 0,
  • "project_tags_options": [
    ],
  • "install_model_options": [
    ],
  • "items": [
    ]
}

Area Approval Report

Get Area Approval Report

Authorizations:
trap_auth
query Parameters
created_since
string <date-time>

Only return entities created after or since this date.

created_before
string <date-time>

Only return entities created before this date.

limit
integer [ 1 .. 100000 ]
Default: 1000

Only return up to this many entities. Tentatively limited to 100,000.

offset
integer >= 0
Default: 0

Offset the page returned by this many records

sort_order
string
Default: "asc"
Enum: "asc" "desc"

provide a sort order / direction

project_tags
Array of strings (Project tags)

list of free-text tags applied to projects

Array of Project UUID (strings) or Project UUID (string) (Project UUID)

Only return entities associated with one or more projects.

Array of Area UUID (strings) or Area UUID (string) (Area UUID)

Only return entities associated with one or more areas.

sort_column
string
Default: "deployment_name"
Enum: "project" "project_tags" "area" "area_created" "approval_created" "owner_first_names" "owner_surname" "owner_contact_email" "owner_contact_phone_home" "owner_contact_phone_mobile" "owner_comms_preference" "owner_trap_servicing" "owner_app_usage" "owner_website_usage" "allow_mechanical_traps" "allow_camera_traps" "allow_toxins" "allow_radio_transmission" "allow_dog_detection" "allow_property_access" "allow_vegetation_pruning" "bait_types" "locked_devices_required" "notify_before_arrival" "further_updates_or_involvement" "household_bait_allergy_present" "dog_onsite" "is_owner" "cats_onsite" "staff_member_name" "signup_date" "most_recent_reconfirmation_date" "please_knock_on_door" "heard_of_project_beforehand" "potential_hazards" "access_security_details" "street_address" "approval_date" "approved" "notes" "approval_state" "parcel_ids" "is_from_linz_parcel"

provide a field to sort by

Array of Approval State (strings) or string

Only return entities associated with one or more approval states

is_from_linz_parcel
boolean (is from LINZ parcel)

only return records with the specified value for is_from_linz_parcel

address_search_term
string (filter by address search term)

only return entities that contain the search term in the street address

owner_first_names_search_term
string (filter by owners first names)

only return entities that contain the search term in the owners first names

owner_surname_search_term
string (filter by owners surname)

only return entities that contain the search term in the owners surname

Responses

Response samples

Content type
application/json
{
  • "total": 0,
  • "project_tags_options": [
    ],
  • "approval_state_options": [
    ],
  • "total_approved": 0,
  • "total_declined": 0,
  • "total_pending": 0,
  • "total_in_progress": 0,
  • "items": [
    ]
}

Telemetry

Get all telemetry

Authorizations:
trap_auth
query Parameters
created_since
string <date-time>

Only return entities created after or since this date.

created_since_uuid
string <uuid>

Only return entities created since this UUID, if the date is equal to created_since.

limit
integer [ 1 .. 100000 ]
Default: 1000

Only return up to this many entities. Tentatively limited to 100,000.

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Create new telemetry record

Authorizations:
trap_auth
Request Body schema: application/json

create a220 telemetry record

uuid
required
string <uuid> (Telemetry UUID)
lora_dev_eui
string (LoRa Dev EUI)

The LoRa Dev EUI from the device

trap_name
string (Trap name)

The name of the trap defined by user via the app

serial_num
string (Serial Number)

Serial number of this AT220 device - if known

ssid_code
string (SSID Code)

The SSID code from the device

mcu_id
string (MCU Id)

The MCU Id from the device

object (Point)
elevation
number (Elevation)

The elevation of the device in metres

last_check
string <date-time> (Last Check)

The date of the last check on this device

last_reset
string <date-time> (Last Reset)
run_time
number (Run Time)

The run time of the AT220 device in seconds

battery_voltage
required
number (Battery Voltage)
bar_state
required
string (Bar state)
Enum: "None" "Off line" "Power on reset" "Fault timeout request" "Fault timeout" "Fault low battery request" "Fault low battery" "Manual operation" "Manual operation ending" "Manual operation request" "Inhibit" "Delay to reset" "Reset start" "Reset driving to microswitch" "Reset driving to cam" "Reset at cam" "Recalibrate run on" "Recalibrate run on ending" "Reset microswitch run on" "Reset stop and wait" "Wait rebaiting" "Wait data logging" "Reset fail small slip" "Reset fail overrun slip" "Delay in setpos" "Reset is good" "Trigger now" "Trigger to clear eye request" "Trigger to clear eye" "Wait for release" "Got release check run mode" "Check release" "Fail release too long" "Trigger run on" "Pest detection is running" "Motor is running" "Reset fail big slip"

One of the possible bar states (open, closed)

eye_1
number (Eye 1)
eye_2
number (Eye 2)
ambient_1
number (Light Level 1)
ambient_2
number (Light Level 2)
life_cycles
number (Life Cycles)
all_cycles
required
number (All Cycles)
cycles_by_eye
required
number (Cycles by Eye)

The number of cycles caused by eye sensor, also called triggers

bait_cycles
required
number (Bait Cycles)

The number of bait (or pump) cycles

possums
required
number (Possums)
days_between_baiting
number (Days Between Baiting)
bait_run_time_seconds
number (Pump Baiting Run Time in Seconds)
set_state
required
boolean (Trap set status)
runon
number (Run On)

Time (mSec) the motor runs after Cam contact occurs.

prefeed_days
number (Prefeed Days)
temp_celsius
number (Temperature in Celsius)

The temperature in Celsius

hard_reboots
number (Reboot)

The number of reboots since the last reset

last_error
string (Last Error)
Enum: "None" "Zero unlock" "Zero lock" "Write unlock" "Write lock" "ADC error" "Log write unlock" "Log write lock" "Log restart" "RTC get time" "RTC get date" "ADC init" "ADC calib" "ADC chnl0" "ADC chnl1" "ADC chnl2" "ADC chnl3" "ADC chnl4" "ADC chnl5" "ADC chnl6" "RTC init" "UART deinit" "UART init" "Latency" "SPI error" "RTC calib" "Connect fail" "Send timeout" "Send overrun" "PC2TRAP state invalid" "TX state invalid"

The last error code

last_error_level
string (Last Error Level)
Enum: "Success" "Danger" "Warning" "Unknown"

The last error level

last_reboot_reason
string (Last Reboot Reason)
Enum: "None" "Hardware" "Software" "Watchdog Timeout"

The last reboot reason

event
required
string (Telemetry Event)
Enum: "app connect" "app disconnect" "rcoms"

The telemetry event

rcoms_reason
string (Remote comms reason)
Enum: "UNKNOWN" "POWER_ON_RESET" "REMOTE_REQUEST" "TEST_FROM_WIFI_MSG" "OPERATOR_INTERVENTION" "RAT_TRIGGER" "POSSUM_TRIGGER" "RESET_IS_GOOD" "FAULT_TIMEOUT" "FAULT_LOW_BATT" "TRAP_SLIPPED" "NIGHT_DETECTED" "DAWN_DETECTED"
long_log
string (Long Log) <= 10000 characters

The long log of the device

short_log
string (Short Log) <= 10000 characters

The short log of the device

diary
string (Diary) <= 100000 characters

The diary of the app conversation with the device

eeprom
string (EEPROM) <= 10000 characters

Copy of what is on the EEPROM of the device

rtcbu
string (Real Time Clock Backup) <= 10000 characters

Content of the real time clock backup registers

extended
object (Extended telemetry data)

extended telemetry data, basically a catch-all for anything additional, like debug info

required
object (meta)

Responses

Request samples

Content type
application/json
{
  • "uuid": "095be615-a8ad-4c33-8e9c-c7612fbf6c9f",
  • "lora_dev_eui": "string",
  • "trap_name": "string",
  • "serial_num": "string",
  • "ssid_code": "string",
  • "mcu_id": "string",
  • "location": {
    },
  • "elevation": 0,
  • "last_check": "2019-08-24T14:15:22Z",
  • "last_reset": "2019-08-24T14:15:22Z",
  • "run_time": 0,
  • "battery_voltage": 0,
  • "bar_state": "None",
  • "eye_1": 0,
  • "eye_2": 0,
  • "ambient_1": 0,
  • "ambient_2": 0,
  • "life_cycles": 0,
  • "all_cycles": 0,
  • "cycles_by_eye": 0,
  • "bait_cycles": 0,
  • "possums": 0,
  • "days_between_baiting": 0,
  • "bait_run_time_seconds": 0,
  • "set_state": true,
  • "runon": 0,
  • "prefeed_days": 0,
  • "temp_celsius": 0,
  • "hard_reboots": 0,
  • "last_error": "None",
  • "last_error_level": "Success",
  • "last_reboot_reason": "None",
  • "event": "app connect",
  • "rcoms_reason": "UNKNOWN",
  • "long_log": "string",
  • "short_log": "string",
  • "diary": "string",
  • "eeprom": "string",
  • "rtcbu": "string",
  • "extended": { },
  • "meta": {
    }
}

Response samples

Content type
application/json
{
  • "message": "string",
  • "telemetry": {
    }
}

Get telemetry

Authorizations:
trap_auth
path Parameters
telemetryUUID
required
string <uuid> (Telemetry UUID)

Responses

Response samples

Content type
application/json
{
  • "uuid": "095be615-a8ad-4c33-8e9c-c7612fbf6c9f",
  • "lora_dev_eui": "string",
  • "trap_name": "string",
  • "serial_num": "string",
  • "ssid_code": "string",
  • "mcu_id": "string",
  • "location": {
    },
  • "elevation": 0,
  • "last_check": "2019-08-24T14:15:22Z",
  • "last_reset": "2019-08-24T14:15:22Z",
  • "run_time": 0,
  • "battery_voltage": 0,
  • "bar_state": "None",
  • "eye_1": 0,
  • "eye_2": 0,
  • "ambient_1": 0,
  • "ambient_2": 0,
  • "life_cycles": 0,
  • "all_cycles": 0,
  • "cycles_by_eye": 0,
  • "bait_cycles": 0,
  • "possums": 0,
  • "days_between_baiting": 0,
  • "bait_run_time_seconds": 0,
  • "set_state": true,
  • "runon": 0,
  • "prefeed_days": 0,
  • "temp_celsius": 0,
  • "hard_reboots": 0,
  • "last_error": "None",
  • "last_error_level": "Success",
  • "last_reboot_reason": "None",
  • "event": "app connect",
  • "rcoms_reason": "UNKNOWN",
  • "long_log": "string",
  • "short_log": "string",
  • "diary": "string",
  • "eeprom": "string",
  • "rtcbu": "string",
  • "extended": { },
  • "meta": {
    }
}

TelemetryReport

Get a report of telemetry

Authorizations:
trap_auth
query Parameters
limit
integer [ 1 .. 100000 ]
Default: 1000

Only return up to this many entities. Tentatively limited to 100,000.

offset
integer >= 0
Default: 0

Offset the page returned by this many records

sort_order
string
Default: "asc"
Enum: "asc" "desc"

provide a sort order / direction

sort_column
string
Default: "collected"
Enum: "serial_num" "trap_name" "ssid_code" "collected" "rcoms_reason" "cycles_by_eye" "possums" "battery_voltage" "overall_health" "created_by_uuid" "image_count" "note_count"

provide a field to sort by

collected_since
string <date-time>

Only return entities collected after or since this date.

collected_before
string <date-time>

Only return entities collected before this date.

battery_voltage_min
number

Only return entities with this battery voltage or higher.

battery_voltage_max
number

Only return entities with this battery voltage or lower.

firmware_version_min
string

Only return entities with this firmware version or higher.

firmware_version_max
string

Only return entities with this firmware version or lower.

app_version_min
string

Only return entities with this app version or higher.

app_version_max
string

Only return entities with this app version or lower.

app_platform
Array of strings
Items Enum: "Android" "iOS"

Only return entities with these app platforms.

last_reboot_reason
Array of strings
Items Enum: "None" "Hardware" "Software" "Watchdog Timeout"

Only return entities with these last reboot reasons.

source
Array of strings
Items Enum: "app" "rcoms" "unknown"

Only return entities with these sources.

rcoms_reason
Array of strings
Items Enum: "UNKNOWN" "POWER_ON_RESET" "REMOTE_REQUEST" "TEST_FROM_WIFI_MSG" "OPERATOR_INTERVENTION" "RAT_TRIGGER" "POSSUM_TRIGGER" "RESET_IS_GOOD" "FAULT_TIMEOUT" "FAULT_LOW_BATT" "TRAP_SLIPPED" "NIGHT_DETECTED" "DAWN_DETECTED"

Only return entities with these rcoms reasons.

at220_event
Array of strings
Items Enum: "app connect" "app disconnect" "rcoms"

Only return entities with these at220 events.

trap_status_reason
Array of strings
Items Enum: "not set" "low battery" "low light signal" "non hardware reboot"

Only return entities with these trap status reasons.

ssid_code
Array of strings

Only return entities with these SSID codes.

trap_name
Array of strings

Only return entities with these trap names.

trap_status
Array of strings
Items Enum: "red" "orange" "green" "unknown"

Only return entities with these trap health status values.

created_by
Array of strings <uuid>

Only return entities created by these users.

only_latest
boolean

Only return the latest records (one for each telemetry_event, meaning you will see recent RCOMS, app connected, and app disconnected) for each trap ssid, for the requesting user. Obeys collection date filters.

has_images
boolean

Only return records with images.

has_notes
boolean

Only return records with notes.

include_logs
boolean
Default: false

Include binary log fields (long_log, short_log, diary, eeprom, rtcbu, extended) on each item. Defaults to false; use GET /at220/telemetry/{uuid} for a single record's logs.

Responses

Response samples

Content type
application/json
{
  • "firmware_options": [
    ],
  • "app_version_options": [
    ],
  • "ssid_code_options": [
    ],
  • "trap_name_options": [
    ],
  • "rcoms_reason_options": [
    ],
  • "created_by_options": [
    ],
  • "total_cycles_by_eye": 0,
  • "total_possums": 0,
  • "total_red_records": 0,
  • "total_orange_records": 0,
  • "total_green_records": 0,
  • "total_unknown_records": 0,
  • "total_traps": 0,
  • "total": 0,
  • "battery_voltage_min": 0,
  • "battery_voltage_max": 0,
  • "firmware_version_min": "string",
  • "firmware_version_max": "string",
  • "app_version_min": "string",
  • "app_version_max": "string",
  • "items": [
    ]
}

Trap Sensor Records Report

Get Trap Sensor Records

Authorizations:
trap_auth
query Parameters
changed_since
string <date-time>

Only return entities changed since this date.

changed_before
string <date-time>

Only return entities changed before this date.

limit
integer [ 1 .. 100000 ]
Default: 1000

Only return up to this many entities. Tentatively limited to 100,000.

offset
integer >= 0
Default: 0

Offset the page returned by this many records

sort_order
string
Default: "asc"
Enum: "asc" "desc"

provide a sort order / direction

organisation
string <uuid> (Organisation UUID)

Only return entities associated with this organisation.

trap
string <uuid> (Trap UUID)

Only return entities associated with this trap.

Array of Project UUID (strings) or Project UUID (string) (Project UUID)

Only return entities associated with one or more projects.

Array of Line UUID (strings) or Line UUID (string) (Line UUID)

Only return entities associated with one or more lines.

sort_column
string
Default: "date"
Enum: "project" "trap" "date" "event" "status" "RSSI" "battery_voltage" "snr" "sensor_id" "sensor_provider"

provide a field to sort by

Array of strings or string

sensor_id to filter by

Array of strings or string

sensor_provider to filter by

battery_voltage_min
number (minimum battery voltage)

minimum battery voltage to filter by

battery_voltage_max
number (maximum battery voltage)

maximum battery voltage to filter by

snr_min
number (minimum signal to noise ratio)

minimum signal to noise ratio to filter by

snr_max
number (maximum signal to noise ratio)

maximum signal to noise ratio to filter by

rssi_min
number (minimum received signal strength indicator)

minimum received signal strength indicator to filter by

rssi_max
number (maximum received signal strength indicator)

maximum received signal strength indicator to filter by

event
Array of strings
Items Enum: "Sprung" "Set" "Vibration" "Heartbeat" "Baitlevel"

event to filter by

status
Array of strings
Items Enum: "Sprung" "Set" "Baitlevel"

status to filter by

Responses

Response samples

Content type
application/json
{
  • "total": 0,
  • "line_options": [
    ],
  • "sensor_id_options": [
    ],
  • "sensor_provider_options": [
    ],
  • "status_options": [
    ],
  • "event_options": [
    ],
  • "battery_voltage_min": 0,
  • "battery_voltage_max": 0,
  • "rssi_min": 0,
  • "rssi_max": 0,
  • "snr_min": 0,
  • "snr_max": 0,
  • "items": [
    ]
}

Image

Create a new image

Authorizations:
trap_auth
Request Body schema: multipart/form-data
uuid
required
string <uuid>
parent_uuid
required
string <uuid>
image
required
string <binary>
image_date
string <date-time>
bundle
required
string
Enum: "AT220-telemetry" "trap_record"

Responses

Response samples

Content type
application/json
{
  • "message": "string",
  • "image": { }
}

Get images for a given node

Authorizations:
trap_auth
query Parameters
limit
integer [ 1 .. 100000 ]
Default: 1000

Only return up to this many entities. Tentatively limited to 100,000.

parent_uuid
required
string <uuid> (Parent UUID)

Only return records associated with this node.

bundle
required
string
Enum: "AT220-telemetry" "trap_record"

Bundle type of the parent node.

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Delete an image

Soft deletes the image. The record is retained and the underlying file is left in S3; the image is simply no longer returned by GET /images.

Authorizations:
trap_auth
path Parameters
imageUUID
required
string <uuid> (Image UUID)

Responses

Response samples

Content type
application/json
{
  • "message": "string",
  • "uuid": "095be615-a8ad-4c33-8e9c-c7612fbf6c9f"
}

Redirect to an image file

Redirects to a freshly presigned S3 URL for the image.

GET /images hands back presigned URLs directly, which is the right shape for a client that is about to display everything it asked for. It is the wrong shape for anything that stores a link: those URLs are signed for an hour, so they cannot be cached, written into a rendered page, or exported to a spreadsheet without going stale.

This endpoint is the durable form of the same thing. The link never expires, nothing is signed until someone follows it, and the permission check happens at that moment rather than at render time -- so a link in a cached page cannot outlive the caller's access to it.

Being a redirect, it can be used anywhere a URL is expected: img src, an anchor, a lightbox gallery, a CSV column. No Content-Disposition is set, so a browser following it displays the image rather than saving it.

Authorizations:
trap_auth
path Parameters
imageUUID
required
string <uuid> (Image UUID)

Responses

Response samples

Content type
application/json
"string"

Note

Create a new note

Authorizations:
trap_auth
Request Body schema: application/json

Create a new note

uuid
required
string <uuid>
parent_uuid
required
string <uuid>
note
required
string
bundle
required
string
Value: "AT220-telemetry"

Responses

Request samples

Content type
application/json
{
  • "uuid": "095be615-a8ad-4c33-8e9c-c7612fbf6c9f",
  • "parent_uuid": "77932ac3-028b-48fa-aaa9-4d11b1d1236a",
  • "note": "string",
  • "bundle": "AT220-telemetry"
}

Response samples

Content type
application/json
{
  • "message": "string",
  • "note": { }
}

Get notes for a given node

Authorizations:
trap_auth
query Parameters
limit
integer [ 1 .. 100000 ]
Default: 1000

Only return up to this many entities. Tentatively limited to 100,000.

parent_uuid
required
string <uuid> (Parent UUID)

Only return records associated with this node.

bundle
required
string
Value: "AT220-telemetry"

Bundle type of the parent node.

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Camera Images

Get camera images map

Get camera images, ordered from least recently changed to most recently changed.

Authorizations:
trap_auth
query Parameters
project
string <uuid> (Project UUID)

Only return entities associated with this project.

Array of Area UUID (strings) or Area UUID (string) (Area UUID)

Only return entities associated with one or more areas.

limit
integer [ 1 .. 100000 ]
Default: 1000

Only return up to this many entities. Tentatively limited to 100,000.

offset
integer >= 0
Default: 0

Offset the page returned by this many records

sort_order
string
Default: "asc"
Enum: "asc" "desc"

provide a sort order / direction

sort_column
string
Default: "image_date"
Enum: "image_date" "monitoring_station_name" "confidence"

provide a field to sort by

monitoring_station
string <uuid> (Monitoring camera UUID)

Only return images associated with this camera.

date_before
string <date-time>

Only return entities with date field before this date.

date_since
string <date-time>

Only return entities with date field since this date.

Array of Species detected (strings) or string

Only return entities associated with one or more species detected.

Array of AI Detection (strings) or string

Only return entities associated with one or more AI detection.

Responses

Response samples

Content type
application/json
{
  • "total": 0,
  • "items": [
    ]
}

Get camera images map

Get camera installations with their image counts.

Authorizations:
trap_auth
query Parameters
project
string <uuid> (Project UUID)

Only return entities associated with this project.

Array of Area UUID (strings) or Area UUID (string) (Area UUID)

Only return entities associated with one or more areas.

date_before
string <date-time>

Only return entities with date field before this date.

date_since
string <date-time>

Only return entities with date field after or since this date.

Array of Species detected (strings) or string

Only return entities associated with one or more species detected.

Array of AI Detection (strings) or string

Only return entities associated with one or more AI detection.

Responses

Response samples

Content type
application/json
{
  • "species_tags_options": [
    ],
  • "ai_tags_options": [
    ],
  • "items": [
    ]
}