Pular para o conteúdo principal

List mobile device information

GET 
/devices

Lists information about mobile devices.

Supports incremental synchronization (Delta Sync) through filters. All parameters are optional to maintain backward compatibility.

📄 Response Limits​

  • Maximum: 500 devices per request
  • Ordering: ID descending (newest first)

🔄 Pagination​

Standard Pagination​

For general listing without filters, use pagination parameters:

GET /v1/devices?since_id=1000
GET /v1/devices?max_id=2000

Delta Sync Pagination​

When using filters (status or updated_since), pagination works differently.

⚠️ IMPORTANT: Use max_id for pagination (NOT since_id)

Why?

Results are ordered by ID descending (2000 → 1999 → 1998...), so:

  • max_id fetches lower IDs (correct direction)
  • since_id fetches higher IDs (wrong direction)

📋 Pagination Workflow​

Step 1: Initial Request

GET /v1/devices?updated_since=2026-02-12T00:00:00Z

Response: 500 devices (IDs: 2000, 1999, ..., 1501)

Step 2: Next Page

GET /v1/devices?updated_since=2026-02-12T00:00:00Z&max_id=1501

Response: 500 devices (IDs: 1500, 1499, ..., 1001)

Step 3: Continue

GET /v1/devices?updated_since=2026-02-12T00:00:00Z&max_id=1001

Response: 200 devices (IDs: 1000, 999, ..., 801)

✅ Pagination complete (fewer than 500 devices)

✅ Key Points​

  • Keep your filter (status or updated_since) in every page request
  • Use the last device ID from previous response as max_id
  • Stop when fewer than 500 devices are returned

Request​

Responses​

OK