Device API

Smart user device management

Device fingerprinting coupled with account mapping.

Start for free or Request a demo
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 key to stopping
fraud

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
}
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 malicious devices.

Review activity

Notify your users about malicious 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.