Device API

Smart user device management

Device fingerprinting with account mapping. Get a handle on malicious devices today.

Get https://api.castle.io/v1/users/{:id}/devices
86
Safari on Mac OS X 10.15.7
San Francisco, CA, USA
4
Report
Approve
73
Native app on iOS 14.1
Lund, Sweden
Reported
Approve
The Device Object

The foundation
of account security

Comprehensive device fingerprinting and user meta information.

The /device endpoint provides detailed device information including hardware/software version, location, and user details.

Get https://api.castle.io/v1/devices/{device_token}
Response
{
  "token": "eyJhbGciOiJIUzI1NiJ9.eyJ0b2tlbiI6IlAybGJnOF9VZG5TVFZtSzBnMkRlT2pSRUtjOTEiLCJxdWFsaWZpZXIiOiJBUUlEQ2pFeE5ETTFOekUxTXpBIiwiYW5vbnltb3VzIjpmYWxzZSwidmVyc2lvbiI6MC4zfQ.cM_SgKgLMCRKAhkWJK5YxS3nXP5u47vEnmAD_vjLlI8",
  "created_at": "2021-02-24T21:39:32.729Z",
  "last_seen_at": "2021-02-24T21:39:32.501Z",
  "user_id": "f2dbec55-95f3-4d7a-8d28-f73799f892ed",
  "approved_at": null,
  "escalated_at": null,
  "mitigated_at": null,
  "context": {
    "ip": "180.69.216.170",
    "location": {
      "country_code": "KR",
      "country": "South Korea",
      "region": "Seoul",
      "region_code": "11",
      "city": "Songpa-dong",
      "lat": 37.5079,
      "lon": 127.1177
    },
    "user_agent": {
      "raw": "Mozilla/5.0 (Windows; U; Windows NT 6.0) AppleWebKit/535.1.2 (KHTML, like Gecko) Chrome/24.0.832.0 Safari/535.1.2/807.831",
      "browser": "Chrome",
      "version": "24.0.832",
      "os": "Windows Vista",
      "mobile": false,
      "platform": "Windows Vista",
      "device": "Unknown",
      "family": "Chrome"
    },
    "properties": {},
    "type": "desktop"
  },
  "is_current_device": false
}
{
  "token": "eyJhbGciOiJIUzI1NiJ9.eyJ0b2tlbiI6IlAybGJnOF9VZG5TVFZtSzBnMkRlT2pSRUtjOTEiLCJxdWFsaWZpZXIiOiJBUUlEQ2pFeE5ETTFOekUxTXpBIiwiYW5vbnltb3VzIjpmYWxzZSwidmVyc2lvbiI6MC4zfQ.cM_SgKgLMCRKAhkWJK5YxS3nXP5u47vEnmAD_vjLlI8",
  "created_at": "2021-02-24T21:39:32.729Z",
  "last_seen_at": "2021-02-24T21:39:32.501Z",
  "user_id": "f2dbec55-95f3-4d7a-8d28-f73799f892ed",
  "approved_at": null,
  "escalated_at": null,
  "mitigated_at": null,
  "context": {
    "ip": "180.69.216.170",
    "location": {
      "country_code": "KR",
      "country": "South Korea",
      "region": "Seoul",
      "region_code": "11",
      "city": "Songpa-dong",
      "lat": 37.5079,
      "lon": 127.1177
    },
    "user_agent": {
      "raw": "Mozilla/5.0 (Windows; U; Windows NT 6.0) AppleWebKit/535.1.2 (KHTML, like Gecko) Chrome/24.0.832.0 Safari/535.1.2/807.831",
      "browser": "Chrome",
      "version": "24.0.832",
      "os": "Windows Vista",
      "mobile": false,
      "platform": "Windows Vista",
      "device": "Unknown",
      "family": "Chrome"
    },
    "properties": {},
    "type": "desktop"
  },
  "is_current_device": false
}
{
  "token": "eyJhbGciOiJIUzI1NiJ9.eyJ0b2tlbiI6IlAybGJnOF9VZG5TVFZtSzBnMkRlT2pSRUtjOTEiLCJxdWFsaWZpZXIiOiJBUUlEQ2pFeE5ETTFOekUxTXpBIiwiYW5vbnltb3VzIjpmYWxzZSwidmVyc2lvbiI6MC4zfQ.cM_SgKgLMCRKAhkWJK5YxS3nXP5u47vEnmAD_vjLlI8",
  "created_at": "2021-02-24T21:39:32.729Z",
  "last_seen_at": "2021-02-24T21:39:32.501Z",
  "user_id": "f2dbec55-95f3-4d7a-8d28-f73799f892ed",
  "approved_at": null,
  "escalated_at": null,
  "mitigated_at": null,
  "context": {
    "ip": "180.69.216.170",
    "location": {
      "country_code": "KR",
      "country": "South Korea",
      "region": "Seoul",
      "region_code": "11",
      "city": "Songpa-dong",
      "lat": 37.5079,
      "lon": 127.1177
    },
    "user_agent": {
      "raw": "Mozilla/5.0 (Windows; U; Windows NT 6.0) AppleWebKit/535.1.2 (KHTML, like Gecko) Chrome/24.0.832.0 Safari/535.1.2/807.831",
      "browser": "Chrome",
      "version": "24.0.832",
      "os": "Windows Vista",
      "mobile": false,
      "platform": "Windows Vista",
      "device": "Unknown",
      "family": "Chrome"
    },
    "properties": {},
    "type": "desktop"
  },
  "is_current_device": false
}
{
  "token": "eyJhbGciOiJIUzI1NiJ9.eyJ0b2tlbiI6IlAybGJnOF9VZG5TVFZtSzBnMkRlT2pSRUtjOTEiLCJxdWFsaWZpZXIiOiJBUUlEQ2pFeE5ETTFOekUxTXpBIiwiYW5vbnltb3VzIjpmYWxzZSwidmVyc2lvbiI6MC4zfQ.cM_SgKgLMCRKAhkWJK5YxS3nXP5u47vEnmAD_vjLlI8",
  "created_at": "2021-02-24T21:39:32.729Z",
  "last_seen_at": "2021-02-24T21:39:32.501Z",
  "user_id": "f2dbec55-95f3-4d7a-8d28-f73799f892ed",
  "approved_at": null,
  "escalated_at": null,
  "mitigated_at": null,
  "context": {
    "ip": "180.69.216.170",
    "location": {
      "country_code": "KR",
      "country": "South Korea",
      "region": "Seoul",
      "region_code": "11",
      "city": "Songpa-dong",
      "lat": 37.5079,
      "lon": 127.1177
    },
    "user_agent": {
      "raw": "Mozilla/5.0 (Windows; U; Windows NT 6.0) AppleWebKit/535.1.2 (KHTML, like Gecko) Chrome/24.0.832.0 Safari/535.1.2/807.831",
      "browser": "Chrome",
      "version": "24.0.832",
      "os": "Windows Vista",
      "mobile": false,
      "platform": "Windows Vista",
      "device": "Unknown",
      "family": "Chrome"
    },
    "properties": {},
    "type": "desktop"
  },
  "is_current_device": false
}
{
  "token": "eyJhbGciOiJIUzI1NiJ9.eyJ0b2tlbiI6IlAybGJnOF9VZG5TVFZtSzBnMkRlT2pSRUtjOTEiLCJxdWFsaWZpZXIiOiJBUUlEQ2pFeE5ETTFOekUxTXpBIiwiYW5vbnltb3VzIjpmYWxzZSwidmVyc2lvbiI6MC4zfQ.cM_SgKgLMCRKAhkWJK5YxS3nXP5u47vEnmAD_vjLlI8",
  "created_at": "2021-02-24T21:39:32.729Z",
  "last_seen_at": "2021-02-24T21:39:32.501Z",
  "user_id": "f2dbec55-95f3-4d7a-8d28-f73799f892ed",
  "approved_at": null,
  "escalated_at": null,
  "mitigated_at": null,
  "context": {
    "ip": "180.69.216.170",
    "location": {
      "country_code": "KR",
      "country": "South Korea",
      "region": "Seoul",
      "region_code": "11",
      "city": "Songpa-dong",
      "lat": 37.5079,
      "lon": 127.1177
    },
    "user_agent": {
      "raw": "Mozilla/5.0 (Windows; U; Windows NT 6.0) AppleWebKit/535.1.2 (KHTML, like Gecko) Chrome/24.0.832.0 Safari/535.1.2/807.831",
      "browser": "Chrome",
      "version": "24.0.832",
      "os": "Windows Vista",
      "mobile": false,
      "platform": "Windows Vista",
      "device": "Unknown",
      "family": "Chrome"
    },
    "properties": {},
    "type": "desktop"
  },
  "is_current_device": false
}
{
  "token": "eyJhbGciOiJIUzI1NiJ9.eyJ0b2tlbiI6IlAybGJnOF9VZG5TVFZtSzBnMkRlT2pSRUtjOTEiLCJxdWFsaWZpZXIiOiJBUUlEQ2pFeE5ETTFOekUxTXpBIiwiYW5vbnltb3VzIjpmYWxzZSwidmVyc2lvbiI6MC4zfQ.cM_SgKgLMCRKAhkWJK5YxS3nXP5u47vEnmAD_vjLlI8",
  "created_at": "2021-02-24T21:39:32.729Z",
  "last_seen_at": "2021-02-24T21:39:32.501Z",
  "user_id": "f2dbec55-95f3-4d7a-8d28-f73799f892ed",
  "approved_at": null,
  "escalated_at": null,
  "mitigated_at": null,
  "context": {
    "ip": "180.69.216.170",
    "location": {
      "country_code": "KR",
      "country": "South Korea",
      "region": "Seoul",
      "region_code": "11",
      "city": "Songpa-dong",
      "lat": 37.5079,
      "lon": 127.1177
    },
    "user_agent": {
      "raw": "Mozilla/5.0 (Windows; U; Windows NT 6.0) AppleWebKit/535.1.2 (KHTML, like Gecko) Chrome/24.0.832.0 Safari/535.1.2/807.831",
      "browser": "Chrome",
      "version": "24.0.832",
      "os": "Windows Vista",
      "mobile": false,
      "platform": "Windows Vista",
      "device": "Unknown",
      "family": "Chrome"
    },
    "properties": {},
    "type": "desktop"
  },
  "is_current_device": false
}
{
  "token": "eyJhbGciOiJIUzI1NiJ9.eyJ0b2tlbiI6IlAybGJnOF9VZG5TVFZtSzBnMkRlT2pSRUtjOTEiLCJxdWFsaWZpZXIiOiJBUUlEQ2pFeE5ETTFOekUxTXpBIiwiYW5vbnltb3VzIjpmYWxzZSwidmVyc2lvbiI6MC4zfQ.cM_SgKgLMCRKAhkWJK5YxS3nXP5u47vEnmAD_vjLlI8",
  "created_at": "2021-02-24T21:39:32.729Z",
  "last_seen_at": "2021-02-24T21:39:32.501Z",
  "user_id": "f2dbec55-95f3-4d7a-8d28-f73799f892ed",
  "approved_at": null,
  "escalated_at": null,
  "mitigated_at": null,
  "context": {
    "ip": "180.69.216.170",
    "location": {
      "country_code": "KR",
      "country": "South Korea",
      "region": "Seoul",
      "region_code": "11",
      "city": "Songpa-dong",
      "lat": 37.5079,
      "lon": 127.1177
    },
    "user_agent": {
      "raw": "Mozilla/5.0 (Windows; U; Windows NT 6.0) AppleWebKit/535.1.2 (KHTML, like Gecko) Chrome/24.0.832.0 Safari/535.1.2/807.831",
      "browser": "Chrome",
      "version": "24.0.832",
      "os": "Windows Vista",
      "mobile": false,
      "platform": "Windows Vista",
      "device": "Unknown",
      "family": "Chrome"
    },
    "properties": {},
    "type": "desktop"
  },
  "is_current_device": false
}
Client-Side Integration

Drop-in device fingerprinting

Collects and forwards data from browsers and mobile apps.

100+ device properties

Hardware specs, proxy, headless browser, incognito, emulator, jailbreak, and much more.

Bot and human behavior

Continuous analysis of mouse movements, keystrokes, taps, swipes, and app navigation.

Use Cases

Reduce fraud and abuse

Detect and stop abuse at the device level.

Stop multi-accounting

Uncover multiple accounts used by the same device.

Manage devices

Let your users view, and report suspicious devices.

Review activity

Notify your users about suspicious account activity.

Block devices

Report malicious devices and block future access from the same or similar devices.

Approve devices

Approve devices, based on user feedback, and avoid prompting the user again on the same device.

Verify new devices

Use risk signals and policies to conditionally challenge new devices used for an account.

Professional
$33/mo
per 10,000 good events

No minimum commitment
Start for free
  • Bot Detection
  • Account Takeover Prevention
  • Policy Management
  • Device Management
  • User Behavior Analytics
  • REST API & Webhooks
  • Email & chat support
  • Credit card payments
Enterprise
$28/mo*
per 10,000 good events

$2,800/mo minimum commitment
Get in touch
  • Enterprise SLAs
  • Enterprise support
  •  
  • * Volume discounts available
  • Customizable billing
  • Invoice payments