List Participants

GET 
/agreements/:agreement_id/participants

Lists all participants for the agreement. The participants are returned in the order they were created or, if signing order is enabled, the order that is defined.

Request

Path Parameters

agreement_id cuidrequired

GET /agreements/:agreement_id/participants parameter

Responses

200

GET /agreements/:agreement_id/participants 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 participant resource.

resource_type stringrequired

Possible values: [participant]

Data contains the participant resource.

data object[]required

Example (from schema)

{
  "version": "1.0",
  "result_type": "list",
  "resource_type": "participant",
  "data": [
    {
      "id": "c2iegqmnkk5vhpkcia8example",
      "resource_type": "participant",
      "name": "Jane Doe",
      "email": "jane.doe@example.com",
      "status": "draft",
      "order": 1,
      "signing_group": "c6fabfhkpgotv6mfjn4example",
      "agreement": "c2upadvuegkw7msvjsbexample",
      "signing_room_url": "https://www.zigned.se/sign/cqxfd5wjc9gdgwul3cdexample/cchz66ltlex1jjudwrbexample",
      "created_at": "2024-01-01T00:00:00.000Z",
      "updated_at": "2024-01-01T00:00:00.000Z",
      "role": "approver",
      "decision_made_at": "2024-01-01T00:00:00.000Z"
    }
  ]
}

400

GET /agreements/:agreement_id/participants 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"
  }
}

Loading...