curl --request POST \
  --url https://api.pramaan.dev/v1/capabilities/devices.visitor.get \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "ref": "ref_01ARZ3NDEKTSV4RRFFQ69G5FAV"
}
'

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({ref: 'ref_01ARZ3NDEKTSV4RRFFQ69G5FAV'})
};

fetch('https://api.pramaan.dev/v1/capabilities/devices.visitor.get', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://api.pramaan.dev/v1/capabilities/devices.visitor.get"

payload = { "ref": "ref_01ARZ3NDEKTSV4RRFFQ69G5FAV" }
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

{
  "visitor": {
    "ref": "<string>",
    "previouslySeen": true,
    "confidence": 0.5,
    "firstSeenAt": "2023-11-07T05:31:56Z",
    "lastSeenAt": "2023-11-07T05:31:56Z"
  },
  "events": [
    {
      "timestamp": "2023-11-07T05:31:56Z",
      "source": "device",
      "ref": "<string>",
      "visitor": {
        "ref": "<string>",
        "previouslySeen": true,
        "confidence": 0.5,
        "firstSeenAt": "2023-11-07T05:31:56Z",
        "lastSeenAt": "2023-11-07T05:31:56Z"
      },
      "highRecall": {
        "ref": "<string>",
        "previouslySeen": true,
        "confidence": 0.5,
        "firstSeenAt": "2023-11-07T05:31:56Z",
        "lastSeenAt": "2023-11-07T05:31:56Z"
      },
      "environmentRef": "<string>",
      "proximity": {
        "ref": "<string>",
        "precisionRadius": 123,
        "confidence": 0.5
      },
      "incrementalIdentificationStatus": "partially_completed",
      "linkedId": "<string>",
      "tags": {},
      "url": "<string>",
      "appBundle": "<string>",
      "appPackage": "<string>",
      "ipAddress": "<string>",
      "userAgent": "<string>",
      "device": "<string>",
      "os": "<string>",
      "osVersion": "<string>",
      "referrer": "<string>",
      "browserDetails": {
        "browserName": "<string>",
        "browserMajorVersion": "<string>",
        "browserFullVersion": "<string>",
        "os": "<string>",
        "osVersion": "<string>",
        "device": "<string>"
      },
      "deviceDetails": {
        "deviceManufacturer": "<string>",
        "deviceModel": "<string>",
        "osVersion": "<string>"
      },
      "bot": "bad",
      "botType": "<string>",
      "botInfo": {
        "category": "<string>",
        "operator": "<string>",
        "name": "<string>",
        "identity": "verified",
        "confidence": "low"
      },
      "networkInfo": {
        "v4": {
          "address": "<string>",
          "geolocation": {
            "accuracyRadius": 4503599627370495,
            "latitude": 123,
            "longitude": 123,
            "postalCode": "<string>",
            "timezone": "<string>",
            "cityName": "<string>",
            "countryCode": "<string>",
            "countryName": "<string>",
            "continentCode": "<string>",
            "continentName": "<string>",
            "subdivisions": [
              {
                "isoCode": "<string>",
                "name": "<string>"
              }
            ]
          },
          "asn": "<string>",
          "asnName": "<string>",
          "asnNetwork": "<string>",
          "asnType": "<string>",
          "datacenterResult": true,
          "datacenterName": "<string>"
        },
        "v6": {
          "address": "<string>",
          "geolocation": {
            "accuracyRadius": 4503599627370495,
            "latitude": 123,
            "longitude": 123,
            "postalCode": "<string>",
            "timezone": "<string>",
            "cityName": "<string>",
            "countryCode": "<string>",
            "countryName": "<string>",
            "continentCode": "<string>",
            "continentName": "<string>",
            "subdivisions": [
              {
                "isoCode": "<string>",
                "name": "<string>"
              }
            ]
          },
          "asn": "<string>",
          "asnName": "<string>",
          "asnNetwork": "<string>",
          "asnType": "<string>",
          "datacenterResult": true,
          "datacenterName": "<string>"
        }
      },
      "ipBlocklist": {
        "emailSpam": true,
        "attackSource": true,
        "torNode": true
      },
      "proxyConfidence": "low",
      "proxyDetails": {
        "type": "residential",
        "lastSeenAt": "2023-11-07T05:31:56Z"
      },
      "vpnConfidence": "low",
      "vpnOriginTimezone": "<string>",
      "vpnOriginCountry": "<string>",
      "vpnMethods": {
        "timezoneMismatch": true,
        "publicVpn": true,
        "auxiliaryMobile": true,
        "osMismatch": true,
        "relay": true,
        "mlPrediction": true
      },
      "tamperingConfidence": "low",
      "tamperingDetails": {
        "anomalyScore": 123,
        "antiDetectBrowser": true
      },
      "velocity": {
        "distinctIp": {
          "5Minutes": 4503599627370495,
          "1Hour": 4503599627370495,
          "24Hours": 4503599627370495
        },
        "distinctLinkedId": {
          "5Minutes": 4503599627370495,
          "1Hour": 4503599627370495,
          "24Hours": 4503599627370495
        },
        "distinctCountry": {
          "5Minutes": 4503599627370495,
          "1Hour": 4503599627370495,
          "24Hours": 4503599627370495
        },
        "events": {
          "5Minutes": 4503599627370495,
          "1Hour": 4503599627370495,
          "24Hours": 4503599627370495
        },
        "ipEvents": {
          "5Minutes": 4503599627370495,
          "1Hour": 4503599627370495,
          "24Hours": 4503599627370495
        },
        "distinctIpByLinkedId": {
          "5Minutes": 4503599627370495,
          "1Hour": 4503599627370495,
          "24Hours": 4503599627370495
        },
        "distinctVisitorIdByLinkedId": {
          "5Minutes": 4503599627370495,
          "1Hour": 4503599627370495,
          "24Hours": 4503599627370495
        }
      },
      "factoryResetAt": "2023-11-07T05:31:56Z",
      "rareDevicePercentileBucket": "<p95",
      "ruleAction": {
        "type": "allow",
        "statusCode": 349,
        "headers": [
          {
            "name": "<string>",
            "value": "<string>"
          }
        ],
        "body": "<string>",
        "expression": "<string>"
      },
      "deviceAttributes": {
        "fontPreferences": {
          "default": 123,
          "serif": 123,
          "sans": 123,
          "mono": 123,
          "apple": 123,
          "min": 123,
          "system": 123
        },
        "emoji": {
          "font": "<string>",
          "width": 123,
          "height": 123,
          "top": 123,
          "bottom": 123,
          "left": 123,
          "right": 123,
          "x": 123,
          "y": 123
        },
        "fonts": [
          "<string>"
        ],
        "deviceMemory": 4503599627370495,
        "timezone": "<string>",
        "canvas": {
          "winding": true,
          "geometry": "<string>",
          "text": "<string>"
        },
        "languages": [
          [
            "<string>"
          ]
        ],
        "webglExtensions": {
          "contextAttributes": "<string>",
          "parameters": "<string>",
          "shaderPrecisions": "<string>",
          "extensions": "<string>",
          "extensionParameters": "<string>",
          "unsupportedExtensions": [
            "<string>"
          ]
        },
        "webglBasics": {
          "version": "<string>",
          "vendor": "<string>",
          "vendorUnmasked": "<string>",
          "renderer": "<string>",
          "rendererUnmasked": "<string>",
          "shadingLanguageVersion": "<string>"
        },
        "screenResolution": [
          4503599627370495
        ],
        "touchSupport": {
          "touchEvent": true,
          "touchStart": true,
          "maxTouchPoints": 4503599627370495
        },
        "oscpu": "<string>",
        "architecture": 0,
        "cookiesEnabled": true,
        "hardwareConcurrency": 4503599627370495,
        "dateTimeLocale": "<string>",
        "vendor": "<string>",
        "colorDepth": 4503599627370495,
        "platform": "<string>",
        "sessionStorage": true,
        "localStorage": true,
        "audio": 123,
        "plugins": [
          {
            "name": "<string>",
            "description": "<string>",
            "mimeTypes": [
              {
                "type": "<string>",
                "suffixes": "<string>",
                "description": "<string>"
              }
            ]
          }
        ],
        "indexedDb": true,
        "math": "<string>",
        "deviceModel": "<string>",
        "deviceManufacturer": "<string>",
        "fontHash": "<string>",
        "timezoneOffset": "<string>",
        "batteryLevel": 4503599627370495,
        "batteryCharging": true,
        "batteryLowPowerMode": true,
        "keyboardLayoutHash": "<string>",
        "keyboardLayoutName": "<string>"
      },
      "labels": [
        {
          "label": "<string>",
          "prediction": true,
          "modelScore": 0.5
        }
      ],
      "suspect": true,
      "replayed": true,
      "activeCall": true,
      "clonedApp": true,
      "developerTools": true,
      "emulator": true,
      "instrumentation": true,
      "proxy": true,
      "incognito": true,
      "jailbroken": true,
      "locationSpoofing": true,
      "mitmAttack": true,
      "privacySettings": true,
      "rootApps": true,
      "simulator": true,
      "tampering": true,
      "virtualMachine": true,
      "vpn": true,
      "highActivityDevice": true,
      "rareDevice": true,
      "suspectScore": 1,
      "proxyModelScore": 1,
      "vpnModelScore": 1,
      "tamperingModelScore": 1,
      "virtualMachineModelScore": 1
    }
  ],
  "nextCursor": "<string>"
}

{
  "error": {
    "code": "addendum_required",
    "message": "<string>",
    "next": "<string>",
    "request_id": "<string>",
    "retryable": true,
    "effect": "none",
    "slot": "<string>",
    "required_micro": 123,
    "reason": "balance",
    "plan": "<string>",
    "needs": [
      {
        "kind": "approval",
        "detail": "<string>",
        "step": "<string>"
      }
    ]
  }
}