Find a guide, feature, or API endpoint. Try “FTP”, “alerts”, or “instruments”.

Browse documentation

Docs/API reference / Instruments

List instruments

Requires `developer_api.instruments.list` on the project-scoped Developer API connection. Use the API origin supplied for your deployment. Unknown query parameters and unexpected request bodies are rejected.

GET/dev-api/v1/p/{project_id}/instrumentsAll endpoints ↗

The request panel saves credentials and API settings in this browser. Privacy details

GET
/dev-api/v1/p/{project_id}/instruments

Authorization

developerApiKey
AuthorizationBearer <token>

Project-scoped Developer API connection key. Grant only the required operation permissions.

In: header

Path Parameters

project_id*string
Match.*\S.*
Length1 <= length <= 128

Query Parameters

q?string

Search text.

Lengthlength <= 256
site_ids?array<>

Comma-separated site identifiers.

Itemsitems <= 100
group_ids?array<>

Comma-separated instrument group identifiers.

Itemsitems <= 100
include_archived?boolean

Include archived resources explicitly. Archived history still requires authorization.

Defaultfalse
limit?integer

Maximum entries to return. Defaults shown are repository defaults; deployed limits may differ.

Range1 <= value <= 100
Default50
cursor?string

Opaque cursor from next_cursor. Keep all filters, resource scope, time range, order, and authorization context unchanged.

Length1 <= length <= 16384

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

bash
curl -X GET "https://example.com/dev-api/v1/p/string/instruments"
json
{
  "request_id": "string",
  "data": [
    {
      "lifecycle_state": "active",
      "archived_at": "2019-08-24T14:15:22Z",
      "archived_by": {
        "type": "user",
        "id": "string"
      },
      "id": "string",
      "name": "string",
      "site_id": "string",
      "site_name": "string",
      "position": {
        "id": "string",
        "crs_code": "string",
        "datum_realization": "string",
        "coordinate_epoch": 0,
        "height_type": "ellipsoidal",
        "geoid_model": "string",
        "x": 0,
        "y": 0,
        "z": 0,
        "positional_quality": "nominal"
      },
      "instrument_groups": [
        {
          "id": "string",
          "name": "string"
        }
      ],
      "created_at": "2019-08-24T14:15:22Z",
      "updated_at": "2019-08-24T14:15:22Z"
    }
  ],
  "next_cursor": "string"
}