> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xerobi.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 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.

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


## OpenAPI

````yaml GET /json-delta
openapi: 3.0.3
info:
  title: Routinator HTTP API
  description: >-
    HTTP API for Routinator - RPKI validation and Route Origin Authorization
    (ROA) service. Provides endpoints for checking route validity, monitoring
    RPKI infrastructure, and receiving real-time updates.
  version: 0.15.0
  contact:
    name: Routinator Support
    url: https://github.com/NLnetLabs/routinator
  license:
    name: BSD-3-Clause
    url: https://opensource.org/licenses/BSD-3-Clause
servers:
  - url: https://api.hixbe.com/rpki
    description: Production server
security: []
tags:
  - name: Validity
    description: Route validity checking endpoints
  - name: Status
    description: Service status and monitoring
  - name: Delta
    description: Incremental updates and notifications
  - name: Monitoring
    description: Logging and metrics endpoints
paths:
  /json-delta:
    get:
      tags:
        - Delta
      summary: Get incremental changes to the dataset
      description: >-
        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.
      operationId: getJsonDelta
      parameters:
        - name: session
          in: query
          description: Session ID from a previous response
          required: false
          schema:
            type: string
            example: a1b2c3d4
        - name: serial
          in: query
          description: Serial number from a previous response
          required: false
          schema:
            type: integer
            example: 42
      responses:
        '200':
          description: Successful response with delta or full dataset
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/JsonDeltaResponse'
        '400':
          description: Invalid session or serial parameter
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '500':
          description: Internal server error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
components:
  schemas:
    JsonDeltaResponse:
      type: object
      required:
        - session
        - serial
      properties:
        session:
          type: string
          description: Session ID of the current dataset
          example: a1b2c3d4
        serial:
          type: integer
          description: Serial number of the current dataset
          example: 43
        reset:
          type: boolean
          description: >-
            If true, this is a full dataset rather than a delta. The 'withdrawn'
            field will not be present.
          example: false
        announced:
          type: array
          description: Route origins that have been announced since the previous version
          items:
            $ref: '#/components/schemas/RouteOrigin'
        withdrawn:
          type: array
          description: >-
            Route origins that have been withdrawn since the previous version.
            Not present when reset is true.
          items:
            $ref: '#/components/schemas/RouteOrigin'
    Error:
      type: object
      properties:
        error:
          type: string
          description: Error message
        code:
          type: string
          description: Error code
    RouteOrigin:
      type: object
      required:
        - asn
        - prefix
        - max_length
      properties:
        asn:
          type: string
          pattern: ^AS[0-9]+$
          example: AS64496
        prefix:
          type: string
          example: 192.0.2.0/24
        max_length:
          type: integer
          minimum: 0
          maximum: 128
          example: 24

````

## Related topics

- [Get Delta Notification](https://docs.xerobi.com/rpki-api/endpoint/get-delta-notify.md)
- [RPKI API](https://docs.xerobi.com/rpki-api/introduction.md)
- [Get Version](https://docs.xerobi.com/rpki-api/endpoint/get-version.md)
- [Get Statistics](https://docs.xerobi.com/speed-api/endpoint/get-statistics.md)
- [Get Status](https://docs.xerobi.com/rpki-api/endpoint/get-status.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.