API reference: devices and security gaps
List and read your devices and the security gaps found on them. Read only. Never keys or passwords.
Last updated
Device and security gap endpoints need devices:read, and they only read: nothing here changes a device or a gap. They never return a key, a password, a tool's raw data or the note written when a gap was ignored. In a gap about a person, a label that holds an email address shows only that address, masked (for example j***@example.test). A label of one word shows only its first letter or digit, then ***. A label of two or more words is shown as it is. Device names and host names are shown as they are named, so a device named after a person shows that name. Check the labels before you send them to another tool. Every sample reads the key from CURRENT_API_KEY and calls https://api.current.day/v1.
/v1/devicesNeeds the devices:read scope. Pages with a cursor.
Lists the devices this key can see, newest first, by company, by words in the name or hostname, or by status, with type, maker, model, operating system, company, warranty end and when it was last seen. It changes nothing and never shows a serial number, a key, a password or money. Pages with a cursor, at most 100 a page.
Parameters
Query parameters
- company_iduuidOptional
- Only this company's devices.
- querytext, up to 200 charactersOptional
- Words in the device's name or hostname, 2 characters or more.
- statusone of the values listedOptional
activespareretiredlostin_transitreceived- limitinteger, 1 to 100Optional
- Rows per page, 1 to 100. 25 when left out.
- cursorcursorOptional
- next_cursor from the previous page.
Errors
| Status | Code and meaning |
|---|---|
| 400 | bad_requestThe request was not in the expected shape. |
| 401 | unauthorizedThis token was not accepted. |
| 403 | not_allowed, frozen, module_offThis key is not allowed to do that. This workspace is read only right now, so nothing can be changed. This area or operation is not switched on for this workspace. |
| 404 | not_foundNothing was found with that id, or this key cannot see it. |
| 405 | bad_request (method_not_allowed)That address does not accept this method. The Allow header lists the ones it does. |
| 429 | rate_limited, send_cappedToo many requests from this token. Wait, then try again. This token has sent its limit of customer emails for now. Try again later. |
| 503 | degradedCurrent is busy. Try again in a minute. |
curl -sS --fail-with-body "https://api.current.day/v1/devices?company_id=c2e9a0f4-1b7d-4c35-a8e6-5d3f7b1c9e02&status=active&limit=10" \
-H "Authorization: Bearer $CURRENT_API_KEY"
# A refusal exits non-zero and prints the error: read .error.code and .error.reason,
# for example with jq -r '.error.code, .error.reason'{
"data": [
{
"id": "7c4e1a9d-2b58-4f36-8a0e-5d9c3b7f1e24",
"name": {
"untrusted_text": "FRONTDESK-01",
"source": "customer"
},
"hostname": {
"untrusted_text": "frontdesk-01",
"source": "customer"
},
"asset_type": {
"untrusted_text": "workstation",
"source": "customer"
},
"manufacturer": {
"untrusted_text": "Example Systems",
"source": "customer"
},
"model": {
"untrusted_text": "ProDesk 400",
"source": "customer"
},
"status": "active",
"lifecycle_stage": {
"untrusted_text": "in_use",
"source": "customer"
},
"os": {
"untrusted_text": "Windows 11 Pro",
"source": "customer"
},
"os_version": {
"untrusted_text": "23H2",
"source": "customer"
},
"company": {
"id": "c2e9a0f4-1b7d-4c35-a8e6-5d3f7b1c9e02",
"name": {
"untrusted_text": "Lakeshore Dental",
"source": "customer"
}
},
"warranty_expires_at": "2027-03-31",
"last_seen_at": "2026-11-12T08:14:03.000Z",
"created_at": "2025-02-10T16:20:00.000Z",
"updated_at": "2026-11-12T08:14:03.000Z"
}
],
"next_cursor": null,
"has_more": false
}/v1/devices/{device_id}Needs the devices:read scope.
Reads one device with its serial number, the tools that report it (each with its match state, when it last saw the device and the state Current last cached: online, patches, antivirus, restart) and how many open security gaps name it. It changes nothing, asks no vendor anything, and never shows a key, a password, who last signed in or money.
Parameters
Path parameters
- device_iduuidRequired
- The device's id (read it with GET /v1/devices).
Errors
| Status | Code and meaning |
|---|---|
| 400 | bad_requestThe request was not in the expected shape. |
| 401 | unauthorizedThis token was not accepted. |
| 403 | not_allowed, frozen, module_offThis key is not allowed to do that. This workspace is read only right now, so nothing can be changed. This area or operation is not switched on for this workspace. |
| 404 | not_foundNothing was found with that id, or this key cannot see it. |
| 405 | bad_request (method_not_allowed)That address does not accept this method. The Allow header lists the ones it does. |
| 429 | rate_limited, send_cappedToo many requests from this token. Wait, then try again. This token has sent its limit of customer emails for now. Try again later. |
| 503 | degradedCurrent is busy. Try again in a minute. |
curl -sS --fail-with-body "https://api.current.day/v1/devices/7c4e1a9d-2b58-4f36-8a0e-5d9c3b7f1e24" \
-H "Authorization: Bearer $CURRENT_API_KEY"
# A refusal exits non-zero and prints the error: read .error.code and .error.reason,
# for example with jq -r '.error.code, .error.reason'{
"data": {
"device": {
"id": "7c4e1a9d-2b58-4f36-8a0e-5d9c3b7f1e24",
"name": {
"untrusted_text": "FRONTDESK-01",
"source": "customer"
},
"hostname": {
"untrusted_text": "frontdesk-01",
"source": "customer"
},
"asset_type": {
"untrusted_text": "workstation",
"source": "customer"
},
"manufacturer": {
"untrusted_text": "Example Systems",
"source": "customer"
},
"model": {
"untrusted_text": "ProDesk 400",
"source": "customer"
},
"status": "active",
"lifecycle_stage": {
"untrusted_text": "in_use",
"source": "customer"
},
"os": {
"untrusted_text": "Windows 11 Pro",
"source": "customer"
},
"os_version": {
"untrusted_text": "23H2",
"source": "customer"
},
"company": {
"id": "c2e9a0f4-1b7d-4c35-a8e6-5d3f7b1c9e02",
"name": {
"untrusted_text": "Lakeshore Dental",
"source": "customer"
}
},
"warranty_expires_at": "2027-03-31",
"last_seen_at": "2026-11-12T08:14:03.000Z",
"created_at": "2025-02-10T16:20:00.000Z",
"updated_at": "2026-11-12T08:14:03.000Z",
"serial": {
"untrusted_text": "EXA1234567",
"source": "customer"
},
"sources": [
{
"source": "datto_rmm",
"match_state": "matched",
"last_seen_at": "2026-11-12T08:14:03.000Z",
"state": {
"online": true,
"patch_status": {
"untrusted_text": "up_to_date",
"source": "customer"
},
"patches_pending": 0,
"av_status": {
"untrusted_text": "protected",
"source": "customer"
},
"av_product": {
"untrusted_text": "Example Antivirus",
"source": "customer"
},
"reboot_required": false,
"last_reboot_at": "2026-11-10T02:00:00.000Z",
"fetched_at": "2026-11-12T08:14:03.000Z"
}
}
],
"open_gaps": 1
}
}
}/v1/security-gapsNeeds the devices:read scope. Pages with a cursor.
Lists the security gaps this key can see, newest first: open, ignored or resolved in the last 30 days, by company, family, severity or lane, each with its rule, subject (a name; a person's one-word or email label is masked), device, company and facts. It changes nothing and never shows what someone wrote when ignoring a gap, AI text, a key, a password or money. Pages with a cursor, at most 100 a page.
Parameters
Query parameters
- company_iduuidOptional
- Only this company's security gaps.
- stateone of the values listedOptional
- open (the default), ignored, or resolved (the last 30 days).
openignoredresolved- familyone of the values listedOptional
deviceidentitypatchingdrift- severityone of the values listedOptional
criticalhighmediumlow- laneone of the values listedOptional
- desk: work for the service desk. recommend: a service the company does not have yet.
deskrecommend- limitinteger, 1 to 100Optional
- Rows per page, 1 to 100. 50 when left out.
- cursorcursorOptional
- next_cursor from the previous page.
Errors
| Status | Code and meaning |
|---|---|
| 400 | bad_requestThe request was not in the expected shape. |
| 401 | unauthorizedThis token was not accepted. |
| 403 | not_allowed, frozen, module_offThis key is not allowed to do that. This workspace is read only right now, so nothing can be changed. This area or operation is not switched on for this workspace. |
| 404 | not_foundNothing was found with that id, or this key cannot see it. |
| 405 | bad_request (method_not_allowed)That address does not accept this method. The Allow header lists the ones it does. |
| 429 | rate_limited, send_cappedToo many requests from this token. Wait, then try again. This token has sent its limit of customer emails for now. Try again later. |
| 503 | degradedCurrent is busy. Try again in a minute. |
curl -sS --fail-with-body "https://api.current.day/v1/security-gaps?state=open&severity=high&limit=10" \
-H "Authorization: Bearer $CURRENT_API_KEY"
# A refusal exits non-zero and prints the error: read .error.code and .error.reason,
# for example with jq -r '.error.code, .error.reason'{
"data": [
{
"id": "e1c7a3f9-4d82-4b60-a5e2-9c3f7d1b8a46",
"gap_key": "admin_no_mfa",
"family": "identity",
"subject_kind": "person",
"subject_label": {
"untrusted_text": "Front Desk Admin",
"source": "customer"
},
"device_id": null,
"company": {
"id": "c2e9a0f4-1b7d-4c35-a8e6-5d3f7b1c9e02",
"name": {
"untrusted_text": "Lakeshore Dental",
"source": "customer"
}
},
"severity": "critical",
"lane": "desk",
"contract_state": "included",
"facts": {
"admin_roles": [
{
"untrusted_text": "Global Administrator",
"source": "customer"
}
],
"mfa_methods": [],
"sources_seen": [
{
"untrusted_text": "m365",
"source": "customer"
}
]
},
"state": "open",
"ignored": null,
"ticket_id": null,
"first_seen_at": "2026-11-03T06:00:00.000Z",
"last_seen_at": "2026-11-12T06:00:00.000Z",
"resolved_at": null
},
{
"id": "0b9e4d6a-3f15-4c87-9a2d-6e1b8c5f7a30",
"gap_key": "admin_no_mfa",
"family": "identity",
"subject_kind": "person",
"subject_label": {
"untrusted_text": "j***@example.test",
"source": "customer"
},
"device_id": null,
"company": {
"id": "c2e9a0f4-1b7d-4c35-a8e6-5d3f7b1c9e02",
"name": {
"untrusted_text": "Lakeshore Dental",
"source": "customer"
}
},
"severity": "critical",
"lane": "desk",
"contract_state": "included",
"facts": {
"admin_roles": [
{
"untrusted_text": "Global Administrator",
"source": "customer"
}
],
"mfa_methods": [],
"sources_seen": [
{
"untrusted_text": "m365",
"source": "customer"
}
]
},
"state": "open",
"ignored": null,
"ticket_id": null,
"first_seen_at": "2026-11-03T06:00:00.000Z",
"last_seen_at": "2026-11-12T06:00:00.000Z",
"resolved_at": null
},
{
"id": "b6d2f9a4-1c73-4e58-9b0a-3f8e6c2d7a15",
"gap_key": "device_missing_backup",
"family": "device",
"subject_kind": "device",
"subject_label": {
"untrusted_text": "FRONTDESK-01",
"source": "customer"
},
"device_id": "7c4e1a9d-2b58-4f36-8a0e-5d9c3b7f1e24",
"company": {
"id": "c2e9a0f4-1b7d-4c35-a8e6-5d3f7b1c9e02",
"name": {
"untrusted_text": "Lakeshore Dental",
"source": "customer"
}
},
"severity": "high",
"lane": "desk",
"contract_state": "included",
"facts": {
"peers_with": 11,
"peers_total": 12,
"sources_seen": [
{
"untrusted_text": "datto_rmm",
"source": "customer"
}
],
"sources_missing": [
{
"untrusted_text": "msp360",
"source": "customer"
}
],
"last_seen": [
{
"source": "datto_rmm",
"at": "2026-11-12"
}
]
},
"state": "open",
"ignored": null,
"ticket_id": null,
"first_seen_at": "2026-11-03T06:00:00.000Z",
"last_seen_at": "2026-11-12T06:00:00.000Z",
"resolved_at": null
}
],
"next_cursor": null,
"has_more": false
}/v1/security-gaps/{gap_id}Needs the devices:read scope.
Reads one security gap: its rule, what it is about (a name; a person's one-word or email label is masked), its device and company, severity, lane, whether the service is in the company's agreement, state and facts (facts.last_seen is a list of { source, at }). An ignored gap carries its category and the date the ignore ends, never what a person wrote about it. It changes nothing.
Parameters
Path parameters
- gap_iduuidRequired
- The security gap's id (read it with GET /v1/security-gaps).
Errors
| Status | Code and meaning |
|---|---|
| 400 | bad_requestThe request was not in the expected shape. |
| 401 | unauthorizedThis token was not accepted. |
| 403 | not_allowed, frozen, module_offThis key is not allowed to do that. This workspace is read only right now, so nothing can be changed. This area or operation is not switched on for this workspace. |
| 404 | not_foundNothing was found with that id, or this key cannot see it. |
| 405 | bad_request (method_not_allowed)That address does not accept this method. The Allow header lists the ones it does. |
| 429 | rate_limited, send_cappedToo many requests from this token. Wait, then try again. This token has sent its limit of customer emails for now. Try again later. |
| 503 | degradedCurrent is busy. Try again in a minute. |
curl -sS --fail-with-body "https://api.current.day/v1/security-gaps/b6d2f9a4-1c73-4e58-9b0a-3f8e6c2d7a15" \
-H "Authorization: Bearer $CURRENT_API_KEY"
# A refusal exits non-zero and prints the error: read .error.code and .error.reason,
# for example with jq -r '.error.code, .error.reason'{
"data": {
"gap": {
"id": "b6d2f9a4-1c73-4e58-9b0a-3f8e6c2d7a15",
"gap_key": "device_missing_backup",
"family": "device",
"subject_kind": "device",
"subject_label": {
"untrusted_text": "FRONTDESK-01",
"source": "customer"
},
"device_id": "7c4e1a9d-2b58-4f36-8a0e-5d9c3b7f1e24",
"company": {
"id": "c2e9a0f4-1b7d-4c35-a8e6-5d3f7b1c9e02",
"name": {
"untrusted_text": "Lakeshore Dental",
"source": "customer"
}
},
"severity": "high",
"lane": "desk",
"contract_state": "included",
"facts": {
"peers_with": 11,
"peers_total": 12,
"sources_seen": [
{
"untrusted_text": "datto_rmm",
"source": "customer"
}
],
"sources_missing": [
{
"untrusted_text": "msp360",
"source": "customer"
}
],
"last_seen": [
{
"source": "datto_rmm",
"at": "2026-11-12"
}
]
},
"state": "open",
"ignored": null,
"ticket_id": null,
"first_seen_at": "2026-11-03T06:00:00.000Z",
"last_seen_at": "2026-11-12T06:00:00.000Z",
"resolved_at": null
}
}
}