Get JSON Delta

Returns a JSON object with the changes since the dataset version identified by the session and serial query parameters. If a delta cannot be produced from that version, the full data set is returned and the ‘reset’ field will be true.

GET /json-delta

Get incremental changes to the dataset

cURL

curl --request GET \
  --url https://api.hixbe.com/rpki/json-delta

200

{
  "session": "a1b2c3d4",
  "serial": 43,
  "reset": false,
  "announced": [
    {
      "asn": "AS64496",
      "prefix": "192.0.2.0/24",
      "max_length": 24
    }
  ],
  "withdrawn": [
    {
      "asn": "AS64496",
      "prefix": "192.0.2.0/24",
      "max_length": 24
    }
  ]
}

Returns incremental changes to the RPKI dataset since the specified session and serial. Returns full dataset if delta cannot be produced.

Use Cases:

• Stay synchronized with RPKI data
• Minimize bandwidth usage
• Track ROA changes over time
• Build real-time validation systems

Query Parameters

session · string

Session ID from a previous response

Example:

"a1b2c3d4"

serial · integer

Serial number from a previous response

Example:

42

Response

200

application/json

Successful response with delta or full dataset

session · string · required

Session ID of the current dataset

Example:

"a1b2c3d4"

serial · integer · required

Serial number of the current dataset

Example:

43

reset · boolean

If true, this is a full dataset rather than a delta. The 'withdrawn' field will not be present.

Example:

false

announced · object[]

Route origins that have been announced since the previous version

Show child attributes

withdrawn · object[]

Route origins that have been withdrawn since the previous version. Not present when reset is true.

Show child attributes