API Docs / Schemas / ConnectionDto

ConnectionDto

A connection between two CIS Manager tenants (an "Interlink"), seen from the viewing tenant's side. One tenant
initiates it for one of its contacts, giving the other party's email address; the other party accepts it by
creating (or naming) its own contact for the initiator. direction is relative to the viewer: Out means the
viewer is the subcontractor sharing its CIS details to send invoices, In means the viewer is the contractor
receiving them.

Properties

Name Type Description
code*string

The connection's identifier, shared by both sides

The connection's identifier, shared by both sides

direction*enum

The viewer's side: Out = sharing details to send invoices (the viewer is the subcontractor), In = receiving them
(the viewer is the contractor)

In Out

The viewer's side: Out = sharing details to send invoices (the viewer is the subcontractor), In = receiving them
(the viewer is the contractor)

In Out

initiatedByMe*boolean

Whether the viewing tenant initiated the connection

Whether the viewing tenant initiated the connection

status*enum

Pending, Connected or Rejected

Pending Connected Rejected

Pending, Connected or Rejected

Pending Connected Rejected

contactstring

The viewer's contact for the other party (code); null on the receiving side until accepted

The viewer's contact for the other party (code); null on the receiving side until accepted

counterPartyEmailstring

The other party's email address: the one the initiator gave, or the initiating tenant's own

The other party's email address: the one the initiator gave, or the initiating tenant's own

counterPartyConnectionPartyDto

The other party as far as it is known: on a connection sent to the viewer, the initiating tenant's details
(and its CIS details when it is sharing them); on one the viewer initiated, the accepting tenant's name once
accepted

The other party as far as it is known: on a connection sent to the viewer, the initiating tenant's details
(and its CIS details when it is sharing them); on one the viewer initiated, the accepting tenant's name once
accepted

matchedToUser*boolean

Whether the other party was matched to a CIS Manager user by email (rather than, or as well as, to a tenant)

Whether the other party was matched to a CIS Manager user by email (rather than, or as well as, to a tenant)

createdDate*string

When the connection was initiated

When the connection was initiated

updatedDatestring

When it last changed

When it last changed

JSON Example

{
  "code": "00000000-0000-0000-0000-000000000000",
  "direction": "In",
  "initiatedByMe": false,
  "status": "Pending",
  "contact": "string",
  "matchedToUser": false,
  "createdDate": "2024-01-01T00:00:00Z"
}

Used By Operations