Check Route Validity (Path)

Returns a JSON object describing whether the route announcement given by its origin AS Number and address prefix is RPKI valid, invalid, or not found. A complete list of VRPs that caused the result is included.

GET /validity/{asNumber}/{prefix}

Check validity of a specific route

cURL

curl --request GET \
  --url https://api.hixbe.com/rpki/validity/{asNumber}/{prefix}

200

{
  "validated_route": {
    "route": {
      "origin_asn": "AS64496",
      "prefix": "192.0.2.0/24"
    },
    "validity": {
      "state": "valid",
      "reason": "<string>",
      "description": "<string>"
    },
    "vrps": {
      "matched": [
        {
          "asn": "AS64496",
          "prefix": "192.0.2.0/24",
          "max_length": 24
        }
      ],
      "unmatched_as": [
        {
          "asn": "AS64496",
          "prefix": "192.0.2.0/24",
          "max_length": 24
        }
      ],
      "unmatched_length": [
        {
          "asn": "AS64496",
          "prefix": "192.0.2.0/24",
          "max_length": 24
        }
      ]
    }
  }
}

Returns whether a route announcement is RPKI valid, invalid, or not found. Includes complete list of VRPs that caused the result.

Use Cases:

• Validate BGP route announcements
• Check specific prefix origin authorization
• Verify route legitimacy before accepting
• Detect potential BGP hijacking

Path Parameters

asNumber · string · required

Autonomous System Number (can be in format 'AS64496' or just '64496')

Pattern: ^(AS)?[0-9]+$

Example:

"AS64496"

prefix · string · required

IP prefix in CIDR notation (e.g., 192.0.2.0/24 or 2001:db8::/32)

Example:

"192.0.2.0/24"

Response

200

application/json

Successful response with validity information

validated_route · object · required

Show child attributes