
                         .,,uod8B8bou,,.
              ..,uod8BBBBBBBBBBBBBBBBRPFT?l!i:.
         ,=m8BBBBBBBBBBBBBBBRPFT?!||||||||||||||
         !...:!TVBBBRPFT||||||||||!!^^""' ' ||||
         !.......:!?|||||!!^^""'            ||||
         !.........||||                     ||||
         !.........||||                     ||||
         !.........||||                     ||||
         !.........||||                     ||||
         !.........||||                     ||||
         !.........||||                     ||||
         `.........||||                    ,||||
          .;.......||||               _.-!!|||||
   .,uodWBBBBb.....||||       _.-!!|||||||||!:'
!YBBBBBBBBBBBBBBb..!|||:,,-!!|||||||!iof68BBBBBb....
!..YBBBBBBBBBBBBBBb!!||||||||!iof68BBBBBBRPFT?!::   `.
!....YBBBBBBBBBBBBBBbaaitf68BBBBBBRPFT?!:::::::::     `.
!......YBBBBBBBBBBBBBBBBBBBRPFT?!::::::;:!^"`;:::       `.
!........YBBBBBBBBBBRPFT?!::::::::::^''...::::::;         iBBbo.
`..........YBRPFT?!::::::::::::::::::::::::;iof68bo.      WBBBBbo.
  `..........:::::::::::::::::::::::;iof688888888888b.     `YBBBP^'
    `........::::::::::::::::;iof688888888888888888888b.     `
      `......:::::::::;iof688888888888888888888888888888b.
        `....:::;iof688888888888888888888888888888888899fT!
          `..::!8888888888888888888888888888888899fT|!^"'
            `' !!988888888888888888888888899fT|!^"'
                `!!8888888888888888899fT|!^"'
                  `!988888888899fT|!^"'
                    `!9899fT|!^"'
                      `!^"'

Getting You Started

Basic Information to Get Started
API Endpoint	`https://api.a1.io`

No Authentication Required.
Response format is JSON.
Maximum 50 items per response.
Datasets available for larger use cases.

Show Me The Code

›₋ Example retrieving Cloudflare's ASN data

curl https://api.a1.io/asn/AS13335

›₋ Example retrieving IP Abuse Contact data for IP address 8.8.8.8

curl https://api.a1.io/ip-abuse-contact/8.8.8.8

Authentication

No authentication is required at the moment. This may change in the future as we get more traffic, but a generous free plans will always be available.

Rate Limiting

There is no hard-set rate limit for the API at the moment. We might return a 429 Too Many Requests error if you do exceed a lot of requests. If that happens, please follow the instructions in the error message.

If you need a higher or predictable rate limit, please contact us at [email protected].

Meta Model

Our APIs return meta data in the response body. It contains error and input information. Actual results are returned in a sibling field.

 1{
 2    "meta": {
 3        "input": "asn:3",
 4        "error": ""
 5    },
 6    "x": {
 7        // Actual results are returned here.
 8        // "x" would be the name of the actual data model ("asn", "ip-abuse-contact", etc.)
 9    }
10}

input - The input query used to generate the response. Possible values are:
- asn:3 for ASN
- ip:8.8.8.8 for IP Address
- domain:a1.io/1.2.3.4 for Domain Name, where 1.2.3.4 is the IP address resolved and used for ASN lookup
- company:spacex for Company Name
- company:spacex for Company Name
- country:us for Country Code
error - The error message if the request failed.
omitempty nullable

APIs Available

Autonomous Systems (ASN) Data IP Abuse Contact Data