Skip to content

ASN_INDEX_UNAVAILABLE

The ASN prefix index has not been built on this server

GET /api/v1/ip/asn/{asn} needs the index `lookup:index-asns` builds from the ASN database, and it is not installed. Nothing is charged.

http status
501
credits
A failure after the lookup ran leaves the credit spent; every other failure bills nothing.

What it means

The ASN database answers "which system does this address belong to"; the ASN endpoint answers the reverse, "which prefixes does this system hold", and that needs the database turned inside out once a month after it syncs. Until that has run there is nothing to answer from, and saying so is more honest than an empty prefix list.

Every address lookup is unaffected: asn and org on an address come straight from the database.

What to do

Retry later. If it persists, the operator has not run lookup:index-asns since the last ASN database sync.

Example response

{
    "success": false,
    "error": {
        "code": "ASN_INDEX_UNAVAILABLE",
        "message": "The ASN prefix index has not been built on this server yet.",
        "request_id": "req_01m1kgdm4xngzmbmff68g94w0c"
    }
}

Every error carries the request_id also sent in the X-Request-Id header; quote it when writing to support.

Related

markdown version: /docs/errors/ASN_INDEX_UNAVAILABLE.md