List Sign Events

GET 
https://api.zigned.se/rest/v3/agreements/:agreement_id/participants/:participant_id/sign_events

Lists all sign events for the participant. The events are returned in ascending order by creation date. Events are read only.

Request

Path Parameters

agreement_id cuidrequired

GET /agreements/:agreement_id/participants/:participant_id/sign_events parameter

participant_id cuidrequired

GET /agreements/:agreement_id/participants/:participant_id/sign_events parameter

Responses

200

GET /agreements/:agreement_id/participants/:participant_id/sign_events Successful response

application/json

Schema

Schema

version stringrequired

Possible values: [1.0]

The version of the response schema

result_type stringrequired

Possible values: [list]

A non-paginated list of the sign event resource.

resource_type stringrequired

Possible values: [sign_event]

Data contains the sign event resource.

data object[]required
Array [
id cuidrequired
The unique identifier of the sign event
resource_type stringrequired
Possible values: [sign_event]
title stringrequired
The title of the event
description stringrequired
The description of the event
user_agent stringrequired
The user agent of the browser which triggered the event
ip_address stringrequired
The IP address of the request which triggered the event
participant object required
oneOf
MOD1
string
118cb3b11b8a1f3b6b1e60a89f96a8be9da32a0f
version stringrequired
Possible values: [1.0]
The version of the response schema
result_type stringrequired
Possible values: [single]
A single object of the signing_group resource.
resource_type stringrequired
Possible values: [signing_group]
Data contains the signing_group resource.
data objectrequired
The resource data.
id cuidrequired
The unique identifier of the signing group
resource_type stringrequired
Possible values: [signing_group]
name stringrequired
The name of the signing group
status stringrequired
Possible values: [draft, pending, fulfilled]
The status of the signing group
order doublerequired
Possible values: >= 5e-324 and <= 1.7976931348623157e+308
The queue number of the signing group
participants object required
oneOf
MOD1
Array [
string
]
MOD3
string
agreement cuidrequired
The unique identifier of the agreement this signing group belongs to
created_at stringrequired
UTC datetime ISO string
updated_at stringrequired
UTC datetime ISO string
MOD3
string
created_at stringrequired
UTC datetime ISO string
updated_at stringrequired
UTC datetime ISO string
]

Example (from schema)

{
  "version": "1.0",
  "result_type": "list",
  "resource_type": "sign_event",
  "data": [
    {
      "id": "cry7lxonsuqqmrvi6s5example",
      "resource_type": "sign_event",
      "title": "Sign completed",
      "description": "Completed signing of the documment with swedish mobile BankID.",
      "user_agent": "Mozilla/5.0 (Linux; Android 10; SM-G960F) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/90.0.4430.210 Mobile Safari/537.36",
      "ip_address": "192.168.0.1",
      "participant": "cihhe1hpnrouo9k70ksexample",
      "created_at": "2024-01-01T00:00:00.000Z",
      "updated_at": "2024-01-01T00:00:00.000Z"
    }
  ]
}

400

GET /agreements/:agreement_id/participants/:participant_id/sign_events Error response

application/json

Schema

Schema

status stringrequired

Possible values: [error]

error objectrequired
code int64required
Possible values: >= 400 and <= 599
message stringrequired
request_id uuidrequired

Example (from schema)

{
  "status": "error",
  "error": {
    "code": 0,
    "message": "string",
    "request_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6"
  }
}

Authorization: http

name: HTTP_1type: httpscheme: bearer

• curl
• python
• go
• nodejs
• ruby
• csharp
• php
• java
• powershell

• CURL

curl -L -X GET 'https://api.zigned.se/rest/v3/agreements/:agreement_id/participants/:participant_id/sign_events' \
-H 'Accept: application/json' \
-H 'Authorization: Bearer <TOKEN>'

Request Collapse all

Base URL

https://api.zigned.se/rest/v3

Auth

Bearer Token

Parameters

agreement_id — pathrequired

participant_id — pathrequired