Cloudflare API | Botnet Feed › ASN

Gets all the data the botnet tracking database has for a given ASN registered to user account for given date. If no date is given, it will return results for the previous day.

Security

The preferred authorization scheme for interacting with the Cloudflare API. Create a token.

Example: Authorization: Bearer Sn3lZJTBX6kkg7OdcBUAxOO963GEIyGQqnFTOFYY

Accepted Permissions (at least one required)

DDoS Botnet Feed Write DDoS Botnet Feed Read

Parameters

account_id: string

(maxLength: 32)

Identifier

asn_id: number

date: string

Optional

(format: date-time)

Response fields

errors: Array<

ResponseInfo

messages: Array<

ResponseInfo

success: true

Whether the API call was successful

result: { cidr, date, offense_count }

Optional

Request example

curl https://api.cloudflare.com/client/v4/accounts/$ACCOUNT_ID/botnet_feed/asn/$ASN_ID/day_report \
    -H "X-Auth-Email: $CLOUDFLARE_EMAIL" \
    -H "X-Auth-Key: $CLOUDFLARE_API_KEY"

200Example

{
  "errors": [
    {
      "code": 1000,
      "message": "message"
    }
  ],
  "messages": [
    {
      "code": 1000,
      "message": "message"
    }
  ],
  "success": true,
  "result": {
    "cidr": "1.1.1.1/32",
    "date": "2014-01-01T05:20:00.12345Z",
    "offense_count": 1000
  }
}

Get Full Report -> Envelope<{ cidr, date, offense_count }>

get/accounts/{account_id}/botnet_feed/asn/{asn_id}/full_report

Gets all the data the botnet threat feed tracking database has for a given ASN registered to user account.

Botnet Feed

Configs

botnet_feed.configs

Botnet Feed Configs

ASN

botnet_feed.configs.asn

Methods

Delete An ASN -> Envelope<{ asn }>

delete/accounts/{account_id}/botnet_feed/configs/asn/{asn_id}

Delete an ASN from botnet threat feed for a given user.

Get List Of ASNs -> Envelope<{ asn }>

get/accounts/{account_id}/botnet_feed/configs/asn

Gets a list of all ASNs registered for a user for the DDoS Botnet Feed API.