Skip to main content
GET
/
devices
/
{device_id}
/
assignments
Assignment history for one device
import requests

url = "https://api.1st.app/v1/devices/{device_id}/assignments"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)
{
  "data": [
    {
      "assignment_id": "f4e9b8d2-1c3a-4f5b-9d6e-2a8b1c4d5e6f",
      "type": "athlete",
      "label": "L. Marchetti",
      "home_or_travel": "home",
      "external_ref": "hudl:player:12345",
      "started_at": "2026-04-15T08:30:00Z",
      "ended_at": null,
      "notes": "Pre-season recovery tracking"
    },
    {
      "assignment_id": "a1b2c3d4-5678-90ab-cdef-1234567890ab",
      "type": "athlete",
      "label": "D. Okonkwo",
      "home_or_travel": "home",
      "external_ref": null,
      "started_at": "2026-02-01T14:00:00Z",
      "ended_at": "2026-04-15T08:29:55Z",
      "notes": null
    }
  ],
  "next_cursor": null
}

Documentation Index

Fetch the complete documentation index at: https://dev.1st.app/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
Authorization
string
header
required

Your API key. Create one at dashboard.1st.app/integrations/api-keys.

Path Parameters

​
device_id
string<uuid>
required

The UUID of the device you want. You get a device's ID from GET /v1/devices (look at the device_id field) or by copying it from the dashboard URL.

Example:

"8a72a1c7-3c91-4f5b-b39e-1d2c4e3f5a7b"

Query Parameters

​
cursor
string

For devices with more than 50 historical assignments. On your first call, leave empty. If the response includes next_cursor, send that value back here for the next page. Repeat until next_cursor is null.

Example:

"eyJ0ZWFtX2lkIjoi..."

Response

An array of assignments (newest-first) and a next_cursor.

​
data
object[]
required
​
next_cursor
string | null

Bookmark for the next page of assignments, or null if you've seen them all.