Batch

Score up to 500 values in one request

Bills one lookup per item actually scored; rejected items are not billed. More than 500 items is refused, never truncated.

post/v1/batch

Request

  • Base URL: https://www.layercall.com
  • URL: https://www.layercall.com/v1/batch
  • Auth: one of:
    • API key in header x-api-key
    • HTTP bearer

Request body

type'ip' | 'email' | 'domain' | 'phone' required
itemsstring[] required
strictnessinteger
phone_countrystring

Response

Success

billable_lookupsinteger
countinteger
failedinteger
processing_time_secnumber
succeededinteger
typestring

Example response

{
  "billable_lookups": 2,
  "count": 2,
  "processing_time_sec": 4.818,
  "results": [
    {
      "geo": {
        "asn": "AS15169",
        "city": "Mountain View",
        "country": "US",
        "isp": "Google LLC"
      },
      "input": "8.8.8.8",
      "ip": "8.8.8.8",
      "request_id": "req_66397ef9-c023-494f-80d9-6672121b535b",
      "risk_score": 30,
      "signals": {
        "is_datacenter": true
      },
      "times_seen": 1,
      "verdict": "allow"
    }
  ],
  "succeeded": 2,
  "type": "ip"
}

Changes

No recorded changes to this operation across all 1 revision of this API.