Skip to main content

List all revisions for all Data Disclosure Agreement Records

GET 

/config/data-disclosure-agreement/records/revisions

Lists all revisions of Data Disclosure Agreement Records, optionally filtered by organisation role and/or DDA Template Revision.

Request

Query Parameters

    offset integerrequired

    Requested index for start of resources to be provided in response requested by client

    limit integerrequired

    Default value: 10

    Number of items returned per page. Requested number of resources to be provided in response requested by client.

    organisationRole stringrequired

    Filter by Organisation Role for the Data Disclosure Record, "data_source" or "data_using_service"

    dataDisclosureAgreementTemplateRevisionId stringrequired

    Unique ID of a Data Disclosure Template Revision

Responses

Data Disclosure Agreement Record Revision List

Response Headers
  • Content-Type json

    Content-Type header

Schema
    revisions object[]required
  • Array [
  • id stringrequired

    Revision ID

    schemaName stringrequired

    Possible values: [dataAgreement, policy, dataAgreementRecord]

    Previously "schema" but for technical reasons should be called "schemaName"

    objectId stringrequired

    The PK of the object that was serialised

    objectData stringrequired

    The object that is serialised

    signedWithoutObjectId boolean

    Indicates that objectId was left blank in serizalizedSnapshot when calculating serializedHash. objectId may subsequently be filled in.

    serizalizedSnapshot stringrequired

    Revisioned data (sed as JSON) as a dict. Apply JSON Canonicalization Scheme as per IETF RFC 8785. It contains all the fields of the schema except sucessorId, serializedHash, serializedSnapshot.

    serializedHash stringrequired

    Hash of serizalizedSnapshot (SHA-1)

    timestamp stringrequired

    Timestamp of when revisioning happened. It should be ISO 8601 UTC date time

    authorizedByIndividualId string

    Individual ID

    authorizedByOtherId string

    Reference to an admin user that has created this revision

    successorId string

    If this revision is no longer the latest revision, refer to its successor

    predecessorHash string

    Tamper-resistent artifact from previous record, copied from serializedHash

    predecessorSignature string

    Tamper-resistent artifact from previous record (we don't know if the previous record was signed or not)

  • ]
  • pagination objectrequired
    currentPage integer

    Current page number

    totalItems integer

    Total number of items available

    totalPages integer

    Total number of pages based on limit

    limit integer

    Number of items per page

    hasPrevious boolean

    Indicates if there's a previous page

    hasNext boolean

    Indicates if there's a next page

Loading...