Back to top

API Documentation

Envelope

Overview

All the above helps us to generate a PDF File. But the PDF files are legal documents. And therefore, must be signed. Rechat helps brokers to collect necessary signatures for a generated PDF File.

In order to do this, Rechat connects to a third party service called Docusign.

Docusign is a well-known service that allows anyone to collect signatures for legal documents. Most brokers already have Docusign accounts.

Therefore, in order for Rechat to be able to do anything in this section, the user would have to authenticate with his Docusign credentials.

An Envelope is a collection of PDF Files which have been sent to be signed.

So an envelope has the following attributes:

  • title (String) The title of the envelope which will appear in recipients’ email subject

  • status (Enum) Which can be: Sent,Delivered,Completed,Declined,Voided

  • recipients (Array) An array of EnvelopeRecipient, each one including information about a recipient and his signature

  • documents (Array) An array of EnvelopeDocument, each one including information about a document that we’ve tried to collect signatures fo

Authentication

Any of the endpoints in below might return HTTP 412. That would mean we do not have authentication for this user on Docusign or the Tokens we have for this user have been expired.

As a result of this, the authentication process described below must be restarted. If successful, the original action must be tried again.

The process of authenticating a user is as follows:

  1. User’s browser will be opened to /users/self/docusign/auth

  2. User’s browser will be redirected to Docusign

  3. User logs in and authorizes Rechat

  4. User’s browser will be redirected back to Rechat

  5. Control is given back to client (either using Browser’s postMessage mechanism or redirecting him to rechat:// on phones)

  6. Client tries again the initial action

Create a new Envelope without authentication

Create a new Envelope without authentication
POST/envelopes

In this example user has no Docusign authentication. Therefore will receicve a 412 error.

Example URI

POST /envelopes
Request
HideShow
Body
{
  "deal": "2abb9da7-986f-4c60-bc83-fed1af825d34",
  "title": "This envelope is sent automatically from our test suite",
  "documents": [
    {
      "revision": null,
      "task": "e3df15b2-65e4-4c7b-9fc0-ea749ba5a4e0"
    }
  ],
  "recipients": [
    {
      "role": "669e8975-49a1-4067-95eb-56fc856a9506",
      "envelope_recipient_type": "Signer"
    },
    {
      "role": "9df49e31-f6de-4fe0-95fc-e7ef96b9d2aa",
      "envelope_recipient_type": "CarbonCopy"
    }
  ],
  "created_by": "03da4ffa-beb9-49bd-b44e-7c07ab5e9f3e",
  "owner": "03da4ffa-beb9-49bd-b44e-7c07ab5e9f3e"
}
Response  412
HideShow
Body
{
  "trace": true,
  "http": 412,
  "message": "Invalid docusign authorization",
  "code": "DocusignAuthenticationRequired",
  "slack": false
}

Start authentication

Start authentication
GET/users/self/docusign/auth

Example URI

GET /users/self/docusign/auth

Create Envelope

Create Envelope
POST/envelopes

Example URI

POST /envelopes
Request
HideShow
Body
{
  "deal": "2abb9da7-986f-4c60-bc83-fed1af825d34",
  "title": "This envelope is sent automatically from our test suite",
  "documents": [
    {
      "revision": null,
      "task": "e3df15b2-65e4-4c7b-9fc0-ea749ba5a4e0"
    }
  ],
  "recipients": [
    {
      "role": "669e8975-49a1-4067-95eb-56fc856a9506",
      "envelope_recipient_type": "Signer"
    },
    {
      "role": "9df49e31-f6de-4fe0-95fc-e7ef96b9d2aa",
      "envelope_recipient_type": "CarbonCopy"
    },
    {
      "role": "669e8975-49a1-4067-95eb-56fc856a9506",
      "envelope_recipient_type": "Signer"
    },
    {
      "role": "9df49e31-f6de-4fe0-95fc-e7ef96b9d2aa",
      "envelope_recipient_type": "CarbonCopy"
    }
  ],
  "created_by": "03da4ffa-beb9-49bd-b44e-7c07ab5e9f3e",
  "owner": "03da4ffa-beb9-49bd-b44e-7c07ab5e9f3e"
}
Response  200
HideShow
Body
{
  "code": "OK",
  "data": {
    "id": "2d133a41-0fe6-49a0-b48b-7295c22bd425",
    "created_at": 1787792065.237569,
    "updated_at": 1787792066.073809,
    "created_by": "03da4ffa-beb9-49bd-b44e-7c07ab5e9f3e",
    "deal": "2abb9da7-986f-4c60-bc83-fed1af825d34",
    "docusign_id": "0bd9ee91-0146-4268-8230-f8f4094935b5",
    "status": "Sent",
    "title": "This envelope is sent automatically from our test suite",
    "webhook_token": "d94ff932-a1b1-11f1-af40-ae8942de711b",
    "auto_notify": true,
    "owner": "03da4ffa-beb9-49bd-b44e-7c07ab5e9f3e",
    "type": "envelope",
    "recipients": [
      {
        "id": "f38fe6c7-a663-4bda-a191-b9b2ce960b5f",
        "created_at": 1787792065.249771,
        "updated_at": 1787792065.249771,
        "signed_at": null,
        "envelope": "2d133a41-0fe6-49a0-b48b-7295c22bd425",
        "status": "Created",
        "role": {
          "id": "669e8975-49a1-4067-95eb-56fc856a9506",
          "created_at": 1787792064.805231,
          "updated_at": 1787792064.805231,
          "deleted_at": null,
          "created_by": "03da4ffa-beb9-49bd-b44e-7c07ab5e9f3e",
          "role": "BuyerAgent",
          "deal": "2abb9da7-986f-4c60-bc83-fed1af825d34",
          "user": {
            "type": "user",
            "username": null,
            "first_name": "Unit",
            "last_name": "Test",
            "email": "[email protected]",
            "phone_number": "+4368120265807",
            "created_at": 1493115498.770362,
            "id": "80a227b2-29a0-11e7-b636-e4a7a08e15d4",
            "address_id": null,
            "cover_image_url": null,
            "profile_image_url": null,
            "updated_at": 1493115498.770744,
            "user_status": "Active",
            "profile_image_thumbnail_url": null,
            "cover_image_thumbnail_url": null,
            "email_confirmed": true,
            "timezone": "America/Chicago",
            "user_type": "Admin",
            "deleted_at": null,
            "phone_confirmed": false,
            "is_shadow": false,
            "personal_room": null,
            "brand": null,
            "fake_email": false,
            "features": [
              "Deals"
            ],
            "last_seen_at": null,
            "email_signature": null,
            "daily_enabled": false,
            "email_quota": 30000,
            "website": null,
            "instagram": null,
            "twitter": null,
            "linkedin": null,
            "youtube": null,
            "facebook": null,
            "designation": null,
            "tiktok": null,
            "mfa_enabled": false,
            "xpressdocs_user_id": "80a227b2-29a0-11e7-b636-e4a7a08e15d4",
            "bio": null,
            "current_time": "7:54 PM - Wednesday Aug 26, 2026",
            "push_allowed": true,
            "agents": null,
            "last_seen_type": null,
            "active_brand": null,
            "display_name": "Unit Test",
            "abbreviated_display_name": "Unit",
            "online_state": "Offline",
            "has_password": true
          },
          "commission_dollar": null,
          "brokerwolf_id": null,
          "brokerwolf_row_version": null,
          "legal_prefix": null,
          "legal_first_name": "Wile",
          "legal_middle_name": "E.",
          "legal_last_name": "Coyote",
          "company_title": "ACME",
          "commission_percentage": 3,
          "email": "[email protected]",
          "phone_number": null,
          "checklist": null,
          "role_type": "Person",
          "agent": null,
          "old_current_address": null,
          "old_future_address": null,
          "office_name": null,
          "office_email": null,
          "office_phone": null,
          "office_fax": null,
          "office_license_number": null,
          "office_mls_id": null,
          "office_address": {
            "city": "Los Angeles",
            "full": "11687 Bellagio Rd, Los Angeles CA 90049",
            "name": "Bellagio",
            "type": "stdaddr",
            "line1": "11687 Bellagio Rd",
            "line2": "Los Angeles CA 90049",
            "state": "CA",
            "country": "USA",
            "suftype": "Rd",
            "postcode": "90049",
            "house_num": "11687"
          },
          "searchable": "'acm':1 'coyot':4 'e':3 '[email protected]':5 'wile':2",
          "current_address": null,
          "future_address": null,
          "type": "deal_role",
          "mlsid": null,
          "legal_full_name": "Wile E. Coyote"
        },
        "order": 1,
        "envelope_recipient_type": "Signer",
        "type": "envelope_recipient"
      },
      {
        "id": "4d47ac09-e321-4e79-8b9f-f55d54fcaab1",
        "created_at": 1787792065.251909,
        "updated_at": 1787792065.251909,
        "signed_at": null,
        "envelope": "2d133a41-0fe6-49a0-b48b-7295c22bd425",
        "status": "Created",
        "role": {
          "id": "9df49e31-f6de-4fe0-95fc-e7ef96b9d2aa",
          "created_at": 1787792064.807591,
          "updated_at": 1787792064.807591,
          "deleted_at": null,
          "created_by": "03da4ffa-beb9-49bd-b44e-7c07ab5e9f3e",
          "role": "SellerAgent",
          "deal": "2abb9da7-986f-4c60-bc83-fed1af825d34",
          "user": {
            "type": "user",
            "username": null,
            "first_name": "Unit",
            "last_name": "Test",
            "email": "[email protected]",
            "phone_number": "+4368120265807",
            "created_at": 1493115498.770362,
            "id": "80a227b2-29a0-11e7-b636-e4a7a08e15d4",
            "address_id": null,
            "cover_image_url": null,
            "profile_image_url": null,
            "updated_at": 1493115498.770744,
            "user_status": "Active",
            "profile_image_thumbnail_url": null,
            "cover_image_thumbnail_url": null,
            "email_confirmed": true,
            "timezone": "America/Chicago",
            "user_type": "Admin",
            "deleted_at": null,
            "phone_confirmed": false,
            "is_shadow": false,
            "personal_room": null,
            "brand": null,
            "fake_email": false,
            "features": [
              "Deals"
            ],
            "last_seen_at": null,
            "email_signature": null,
            "daily_enabled": false,
            "email_quota": 30000,
            "website": null,
            "instagram": null,
            "twitter": null,
            "linkedin": null,
            "youtube": null,
            "facebook": null,
            "designation": null,
            "tiktok": null,
            "mfa_enabled": false,
            "xpressdocs_user_id": "80a227b2-29a0-11e7-b636-e4a7a08e15d4",
            "bio": null,
            "current_time": "7:54 PM - Wednesday Aug 26, 2026",
            "push_allowed": true,
            "agents": null,
            "last_seen_type": null,
            "active_brand": null,
            "display_name": "Unit Test",
            "abbreviated_display_name": "Unit",
            "online_state": "Offline",
            "has_password": true
          },
          "commission_dollar": 20000,
          "brokerwolf_id": null,
          "brokerwolf_row_version": null,
          "legal_prefix": null,
          "legal_first_name": "Imaginary",
          "legal_middle_name": null,
          "legal_last_name": "Agent",
          "company_title": null,
          "commission_percentage": null,
          "email": "[email protected]",
          "phone_number": null,
          "checklist": null,
          "role_type": "Person",
          "agent": null,
          "old_current_address": null,
          "old_future_address": null,
          "office_name": null,
          "office_email": null,
          "office_phone": null,
          "office_fax": null,
          "office_license_number": null,
          "office_mls_id": null,
          "office_address": null,
          "searchable": "'agent':2 'imaginari':1 '[email protected]':3",
          "current_address": null,
          "future_address": null,
          "type": "deal_role",
          "mlsid": null,
          "legal_full_name": "Imaginary Agent"
        },
        "order": 1,
        "envelope_recipient_type": "CarbonCopy",
        "type": "envelope_recipient"
      },
      {
        "id": "5abd3eb5-8fe8-4086-aab2-6913a34f4528",
        "created_at": 1787792065.252755,
        "updated_at": 1787792065.252755,
        "signed_at": null,
        "envelope": "2d133a41-0fe6-49a0-b48b-7295c22bd425",
        "status": "Created",
        "role": {
          "id": "669e8975-49a1-4067-95eb-56fc856a9506",
          "created_at": 1787792064.805231,
          "updated_at": 1787792064.805231,
          "deleted_at": null,
          "created_by": "03da4ffa-beb9-49bd-b44e-7c07ab5e9f3e",
          "role": "BuyerAgent",
          "deal": "2abb9da7-986f-4c60-bc83-fed1af825d34",
          "user": {
            "type": "user",
            "username": null,
            "first_name": "Unit",
            "last_name": "Test",
            "email": "[email protected]",
            "phone_number": "+4368120265807",
            "created_at": 1493115498.770362,
            "id": "80a227b2-29a0-11e7-b636-e4a7a08e15d4",
            "address_id": null,
            "cover_image_url": null,
            "profile_image_url": null,
            "updated_at": 1493115498.770744,
            "user_status": "Active",
            "profile_image_thumbnail_url": null,
            "cover_image_thumbnail_url": null,
            "email_confirmed": true,
            "timezone": "America/Chicago",
            "user_type": "Admin",
            "deleted_at": null,
            "phone_confirmed": false,
            "is_shadow": false,
            "personal_room": null,
            "brand": null,
            "fake_email": false,
            "features": [
              "Deals"
            ],
            "last_seen_at": null,
            "email_signature": null,
            "daily_enabled": false,
            "email_quota": 30000,
            "website": null,
            "instagram": null,
            "twitter": null,
            "linkedin": null,
            "youtube": null,
            "facebook": null,
            "designation": null,
            "tiktok": null,
            "mfa_enabled": false,
            "xpressdocs_user_id": "80a227b2-29a0-11e7-b636-e4a7a08e15d4",
            "bio": null,
            "current_time": "7:54 PM - Wednesday Aug 26, 2026",
            "push_allowed": true,
            "agents": null,
            "last_seen_type": null,
            "active_brand": null,
            "display_name": "Unit Test",
            "abbreviated_display_name": "Unit",
            "online_state": "Offline",
            "has_password": true
          },
          "commission_dollar": null,
          "brokerwolf_id": null,
          "brokerwolf_row_version": null,
          "legal_prefix": null,
          "legal_first_name": "Wile",
          "legal_middle_name": "E.",
          "legal_last_name": "Coyote",
          "company_title": "ACME",
          "commission_percentage": 3,
          "email": "[email protected]",
          "phone_number": null,
          "checklist": null,
          "role_type": "Person",
          "agent": null,
          "old_current_address": null,
          "old_future_address": null,
          "office_name": null,
          "office_email": null,
          "office_phone": null,
          "office_fax": null,
          "office_license_number": null,
          "office_mls_id": null,
          "office_address": {
            "city": "Los Angeles",
            "full": "11687 Bellagio Rd, Los Angeles CA 90049",
            "name": "Bellagio",
            "type": "stdaddr",
            "line1": "11687 Bellagio Rd",
            "line2": "Los Angeles CA 90049",
            "state": "CA",
            "country": "USA",
            "suftype": "Rd",
            "postcode": "90049",
            "house_num": "11687"
          },
          "searchable": "'acm':1 'coyot':4 'e':3 '[email protected]':5 'wile':2",
          "current_address": null,
          "future_address": null,
          "type": "deal_role",
          "mlsid": null,
          "legal_full_name": "Wile E. Coyote"
        },
        "order": 1,
        "envelope_recipient_type": "Signer",
        "type": "envelope_recipient"
      },
      {
        "id": "c7c862ad-0f12-47a0-bf81-c5e80cf360bf",
        "created_at": 1787792065.253477,
        "updated_at": 1787792065.253477,
        "signed_at": null,
        "envelope": "2d133a41-0fe6-49a0-b48b-7295c22bd425",
        "status": "Created",
        "role": {
          "id": "9df49e31-f6de-4fe0-95fc-e7ef96b9d2aa",
          "created_at": 1787792064.807591,
          "updated_at": 1787792064.807591,
          "deleted_at": null,
          "created_by": "03da4ffa-beb9-49bd-b44e-7c07ab5e9f3e",
          "role": "SellerAgent",
          "deal": "2abb9da7-986f-4c60-bc83-fed1af825d34",
          "user": {
            "type": "user",
            "username": null,
            "first_name": "Unit",
            "last_name": "Test",
            "email": "[email protected]",
            "phone_number": "+4368120265807",
            "created_at": 1493115498.770362,
            "id": "80a227b2-29a0-11e7-b636-e4a7a08e15d4",
            "address_id": null,
            "cover_image_url": null,
            "profile_image_url": null,
            "updated_at": 1493115498.770744,
            "user_status": "Active",
            "profile_image_thumbnail_url": null,
            "cover_image_thumbnail_url": null,
            "email_confirmed": true,
            "timezone": "America/Chicago",
            "user_type": "Admin",
            "deleted_at": null,
            "phone_confirmed": false,
            "is_shadow": false,
            "personal_room": null,
            "brand": null,
            "fake_email": false,
            "features": [
              "Deals"
            ],
            "last_seen_at": null,
            "email_signature": null,
            "daily_enabled": false,
            "email_quota": 30000,
            "website": null,
            "instagram": null,
            "twitter": null,
            "linkedin": null,
            "youtube": null,
            "facebook": null,
            "designation": null,
            "tiktok": null,
            "mfa_enabled": false,
            "xpressdocs_user_id": "80a227b2-29a0-11e7-b636-e4a7a08e15d4",
            "bio": null,
            "current_time": "7:54 PM - Wednesday Aug 26, 2026",
            "push_allowed": true,
            "agents": null,
            "last_seen_type": null,
            "active_brand": null,
            "display_name": "Unit Test",
            "abbreviated_display_name": "Unit",
            "online_state": "Offline",
            "has_password": true
          },
          "commission_dollar": 20000,
          "brokerwolf_id": null,
          "brokerwolf_row_version": null,
          "legal_prefix": null,
          "legal_first_name": "Imaginary",
          "legal_middle_name": null,
          "legal_last_name": "Agent",
          "company_title": null,
          "commission_percentage": null,
          "email": "[email protected]",
          "phone_number": null,
          "checklist": null,
          "role_type": "Person",
          "agent": null,
          "old_current_address": null,
          "old_future_address": null,
          "office_name": null,
          "office_email": null,
          "office_phone": null,
          "office_fax": null,
          "office_license_number": null,
          "office_mls_id": null,
          "office_address": null,
          "searchable": "'agent':2 'imaginari':1 '[email protected]':3",
          "current_address": null,
          "future_address": null,
          "type": "deal_role",
          "mlsid": null,
          "legal_full_name": "Imaginary Agent"
        },
        "order": 1,
        "envelope_recipient_type": "CarbonCopy",
        "type": "envelope_recipient"
      }
    ],
    "documents": [
      {
        "id": "56c56d7a-9c9b-45d2-90cf-971cb44ab6f6",
        "envelope": "2d133a41-0fe6-49a0-b48b-7295c22bd425",
        "title": "Addendum for Back-Up Contract.pdf",
        "document_id": 1,
        "submission_revision": "efc5d213-5461-4a67-bd99-31ce72e7de3f",
        "file": null,
        "task": "e3df15b2-65e4-4c7b-9fc0-ea749ba5a4e0",
        "submission": "f78c012a-b9f5-4832-9c4b-ad590cec4987",
        "type": "envelope_document",
        "pdf": {
          "id": "7778f9bb-ba2a-46f0-bcfc-a7bae55c0dcf",
          "created_at": 1787792066.102697,
          "updated_at": 1787792066.102697,
          "deleted_at": null,
          "created_by": "03da4ffa-beb9-49bd-b44e-7c07ab5e9f3e",
          "path": "2abb9da7-986f-4c60-bc83-fed1af825d34/d9d38f40-a1b1-11f1-811e-f93126d9eb55.pdf",
          "name": "Addendum for Back-Up Contract.pdf.pdf",
          "public": false,
          "type": "file",
          "url": "https://private-cdn.irish.rechat.com/2abb9da7-986f-4c60-bc83-fed1af825d34/d9d38f40-a1b1-11f1-811e-f93126d9eb55.pdf?Expires=1787878466106&Key-Pair-Id=APKAIIRG223GKFAC4MHA&Signature=W5mylqh~4Z8~GXM5FhJnUPTm5d385AHi4I1rJComWtHAwWhTzMED~sNgpU8H-coK4Pos3GcImYrDOROpCqKThFzrkwYVux8VLkVziJMjXSvLwWdN-Tj5PdWsANPWW7W1Zh~8EBKKDAPaIorQraBTXJmz5lh0SkN~5b8rAP0wJX9pPxuoUwNkFWzXVU3clPlAGycLeA1ReXqV9zFByX~LMk~QYjYJkvqr5RHk-y1R-AV-EsodTQilCwVDt-F5b6TN51-l9tPYQCV7TCUt~gmm7ymXa7EkxVS1ZTFEq7ArREfwfRb9yo5nNYk9ZXzYsUqANuTFppB~3QmUo87ZxJhyFg__",
          "preview_url": "http://assets.rechat.com/mimes/application-pdf.png",
          "mime": "application/pdf"
        }
      }
    ]
  }
}

Get Envelope

Get Envelope
GET/envelopes/:id

Example URI

GET /envelopes/:id
URI Parameters
HideShow
id
string (required) Example: 2d133a41-0fe6-49a0-b48b-7295c22bd425
Response  200
HideShow
Body
{
  "code": "OK",
  "data": {
    "id": "2d133a41-0fe6-49a0-b48b-7295c22bd425",
    "created_at": 1787792065.237569,
    "updated_at": 1787792066.073809,
    "created_by": "03da4ffa-beb9-49bd-b44e-7c07ab5e9f3e",
    "deal": "2abb9da7-986f-4c60-bc83-fed1af825d34",
    "docusign_id": "0bd9ee91-0146-4268-8230-f8f4094935b5",
    "status": "Sent",
    "title": "This envelope is sent automatically from our test suite",
    "webhook_token": "d94ff932-a1b1-11f1-af40-ae8942de711b",
    "auto_notify": true,
    "owner": "03da4ffa-beb9-49bd-b44e-7c07ab5e9f3e",
    "type": "envelope",
    "recipients": [
      {
        "id": "f38fe6c7-a663-4bda-a191-b9b2ce960b5f",
        "created_at": 1787792065.249771,
        "updated_at": 1787792065.249771,
        "signed_at": null,
        "envelope": "2d133a41-0fe6-49a0-b48b-7295c22bd425",
        "status": "Created",
        "role": {
          "id": "669e8975-49a1-4067-95eb-56fc856a9506",
          "created_at": 1787792064.805231,
          "updated_at": 1787792064.805231,
          "deleted_at": null,
          "created_by": "03da4ffa-beb9-49bd-b44e-7c07ab5e9f3e",
          "role": "BuyerAgent",
          "deal": "2abb9da7-986f-4c60-bc83-fed1af825d34",
          "user": {
            "type": "user",
            "username": null,
            "first_name": "Unit",
            "last_name": "Test",
            "email": "[email protected]",
            "phone_number": "+4368120265807",
            "created_at": 1493115498.770362,
            "id": "80a227b2-29a0-11e7-b636-e4a7a08e15d4",
            "address_id": null,
            "cover_image_url": null,
            "profile_image_url": null,
            "updated_at": 1493115498.770744,
            "user_status": "Active",
            "profile_image_thumbnail_url": null,
            "cover_image_thumbnail_url": null,
            "email_confirmed": true,
            "timezone": "America/Chicago",
            "user_type": "Admin",
            "deleted_at": null,
            "phone_confirmed": false,
            "is_shadow": false,
            "personal_room": null,
            "brand": null,
            "fake_email": false,
            "features": [
              "Deals"
            ],
            "last_seen_at": null,
            "email_signature": null,
            "daily_enabled": false,
            "email_quota": 30000,
            "website": null,
            "instagram": null,
            "twitter": null,
            "linkedin": null,
            "youtube": null,
            "facebook": null,
            "designation": null,
            "tiktok": null,
            "mfa_enabled": false,
            "xpressdocs_user_id": "80a227b2-29a0-11e7-b636-e4a7a08e15d4",
            "bio": null,
            "current_time": "7:54 PM - Wednesday Aug 26, 2026",
            "push_allowed": true,
            "agents": null,
            "last_seen_type": null,
            "active_brand": null,
            "display_name": "Unit Test",
            "abbreviated_display_name": "Unit",
            "online_state": "Offline",
            "has_password": true
          },
          "commission_dollar": null,
          "brokerwolf_id": null,
          "brokerwolf_row_version": null,
          "legal_prefix": null,
          "legal_first_name": "Wile",
          "legal_middle_name": "E.",
          "legal_last_name": "Coyote",
          "company_title": "ACME",
          "commission_percentage": 3,
          "email": "[email protected]",
          "phone_number": null,
          "checklist": null,
          "role_type": "Person",
          "agent": null,
          "old_current_address": null,
          "old_future_address": null,
          "office_name": null,
          "office_email": null,
          "office_phone": null,
          "office_fax": null,
          "office_license_number": null,
          "office_mls_id": null,
          "office_address": {
            "city": "Los Angeles",
            "full": "11687 Bellagio Rd, Los Angeles CA 90049",
            "name": "Bellagio",
            "type": "stdaddr",
            "line1": "11687 Bellagio Rd",
            "line2": "Los Angeles CA 90049",
            "state": "CA",
            "country": "USA",
            "suftype": "Rd",
            "postcode": "90049",
            "house_num": "11687"
          },
          "searchable": "'acm':1 'coyot':4 'e':3 '[email protected]':5 'wile':2",
          "current_address": null,
          "future_address": null,
          "type": "deal_role",
          "mlsid": null,
          "legal_full_name": "Wile E. Coyote"
        },
        "order": 1,
        "envelope_recipient_type": "Signer",
        "type": "envelope_recipient"
      },
      {
        "id": "4d47ac09-e321-4e79-8b9f-f55d54fcaab1",
        "created_at": 1787792065.251909,
        "updated_at": 1787792065.251909,
        "signed_at": null,
        "envelope": "2d133a41-0fe6-49a0-b48b-7295c22bd425",
        "status": "Created",
        "role": {
          "id": "9df49e31-f6de-4fe0-95fc-e7ef96b9d2aa",
          "created_at": 1787792064.807591,
          "updated_at": 1787792064.807591,
          "deleted_at": null,
          "created_by": "03da4ffa-beb9-49bd-b44e-7c07ab5e9f3e",
          "role": "SellerAgent",
          "deal": "2abb9da7-986f-4c60-bc83-fed1af825d34",
          "user": {
            "type": "user",
            "username": null,
            "first_name": "Unit",
            "last_name": "Test",
            "email": "[email protected]",
            "phone_number": "+4368120265807",
            "created_at": 1493115498.770362,
            "id": "80a227b2-29a0-11e7-b636-e4a7a08e15d4",
            "address_id": null,
            "cover_image_url": null,
            "profile_image_url": null,
            "updated_at": 1493115498.770744,
            "user_status": "Active",
            "profile_image_thumbnail_url": null,
            "cover_image_thumbnail_url": null,
            "email_confirmed": true,
            "timezone": "America/Chicago",
            "user_type": "Admin",
            "deleted_at": null,
            "phone_confirmed": false,
            "is_shadow": false,
            "personal_room": null,
            "brand": null,
            "fake_email": false,
            "features": [
              "Deals"
            ],
            "last_seen_at": null,
            "email_signature": null,
            "daily_enabled": false,
            "email_quota": 30000,
            "website": null,
            "instagram": null,
            "twitter": null,
            "linkedin": null,
            "youtube": null,
            "facebook": null,
            "designation": null,
            "tiktok": null,
            "mfa_enabled": false,
            "xpressdocs_user_id": "80a227b2-29a0-11e7-b636-e4a7a08e15d4",
            "bio": null,
            "current_time": "7:54 PM - Wednesday Aug 26, 2026",
            "push_allowed": true,
            "agents": null,
            "last_seen_type": null,
            "active_brand": null,
            "display_name": "Unit Test",
            "abbreviated_display_name": "Unit",
            "online_state": "Offline",
            "has_password": true
          },
          "commission_dollar": 20000,
          "brokerwolf_id": null,
          "brokerwolf_row_version": null,
          "legal_prefix": null,
          "legal_first_name": "Imaginary",
          "legal_middle_name": null,
          "legal_last_name": "Agent",
          "company_title": null,
          "commission_percentage": null,
          "email": "[email protected]",
          "phone_number": null,
          "checklist": null,
          "role_type": "Person",
          "agent": null,
          "old_current_address": null,
          "old_future_address": null,
          "office_name": null,
          "office_email": null,
          "office_phone": null,
          "office_fax": null,
          "office_license_number": null,
          "office_mls_id": null,
          "office_address": null,
          "searchable": "'agent':2 'imaginari':1 '[email protected]':3",
          "current_address": null,
          "future_address": null,
          "type": "deal_role",
          "mlsid": null,
          "legal_full_name": "Imaginary Agent"
        },
        "order": 1,
        "envelope_recipient_type": "CarbonCopy",
        "type": "envelope_recipient"
      },
      {
        "id": "5abd3eb5-8fe8-4086-aab2-6913a34f4528",
        "created_at": 1787792065.252755,
        "updated_at": 1787792065.252755,
        "signed_at": null,
        "envelope": "2d133a41-0fe6-49a0-b48b-7295c22bd425",
        "status": "Created",
        "role": {
          "id": "669e8975-49a1-4067-95eb-56fc856a9506",
          "created_at": 1787792064.805231,
          "updated_at": 1787792064.805231,
          "deleted_at": null,
          "created_by": "03da4ffa-beb9-49bd-b44e-7c07ab5e9f3e",
          "role": "BuyerAgent",
          "deal": "2abb9da7-986f-4c60-bc83-fed1af825d34",
          "user": {
            "type": "user",
            "username": null,
            "first_name": "Unit",
            "last_name": "Test",
            "email": "[email protected]",
            "phone_number": "+4368120265807",
            "created_at": 1493115498.770362,
            "id": "80a227b2-29a0-11e7-b636-e4a7a08e15d4",
            "address_id": null,
            "cover_image_url": null,
            "profile_image_url": null,
            "updated_at": 1493115498.770744,
            "user_status": "Active",
            "profile_image_thumbnail_url": null,
            "cover_image_thumbnail_url": null,
            "email_confirmed": true,
            "timezone": "America/Chicago",
            "user_type": "Admin",
            "deleted_at": null,
            "phone_confirmed": false,
            "is_shadow": false,
            "personal_room": null,
            "brand": null,
            "fake_email": false,
            "features": [
              "Deals"
            ],
            "last_seen_at": null,
            "email_signature": null,
            "daily_enabled": false,
            "email_quota": 30000,
            "website": null,
            "instagram": null,
            "twitter": null,
            "linkedin": null,
            "youtube": null,
            "facebook": null,
            "designation": null,
            "tiktok": null,
            "mfa_enabled": false,
            "xpressdocs_user_id": "80a227b2-29a0-11e7-b636-e4a7a08e15d4",
            "bio": null,
            "current_time": "7:54 PM - Wednesday Aug 26, 2026",
            "push_allowed": true,
            "agents": null,
            "last_seen_type": null,
            "active_brand": null,
            "display_name": "Unit Test",
            "abbreviated_display_name": "Unit",
            "online_state": "Offline",
            "has_password": true
          },
          "commission_dollar": null,
          "brokerwolf_id": null,
          "brokerwolf_row_version": null,
          "legal_prefix": null,
          "legal_first_name": "Wile",
          "legal_middle_name": "E.",
          "legal_last_name": "Coyote",
          "company_title": "ACME",
          "commission_percentage": 3,
          "email": "[email protected]",
          "phone_number": null,
          "checklist": null,
          "role_type": "Person",
          "agent": null,
          "old_current_address": null,
          "old_future_address": null,
          "office_name": null,
          "office_email": null,
          "office_phone": null,
          "office_fax": null,
          "office_license_number": null,
          "office_mls_id": null,
          "office_address": {
            "city": "Los Angeles",
            "full": "11687 Bellagio Rd, Los Angeles CA 90049",
            "name": "Bellagio",
            "type": "stdaddr",
            "line1": "11687 Bellagio Rd",
            "line2": "Los Angeles CA 90049",
            "state": "CA",
            "country": "USA",
            "suftype": "Rd",
            "postcode": "90049",
            "house_num": "11687"
          },
          "searchable": "'acm':1 'coyot':4 'e':3 '[email protected]':5 'wile':2",
          "current_address": null,
          "future_address": null,
          "type": "deal_role",
          "mlsid": null,
          "legal_full_name": "Wile E. Coyote"
        },
        "order": 1,
        "envelope_recipient_type": "Signer",
        "type": "envelope_recipient"
      },
      {
        "id": "c7c862ad-0f12-47a0-bf81-c5e80cf360bf",
        "created_at": 1787792065.253477,
        "updated_at": 1787792065.253477,
        "signed_at": null,
        "envelope": "2d133a41-0fe6-49a0-b48b-7295c22bd425",
        "status": "Created",
        "role": {
          "id": "9df49e31-f6de-4fe0-95fc-e7ef96b9d2aa",
          "created_at": 1787792064.807591,
          "updated_at": 1787792064.807591,
          "deleted_at": null,
          "created_by": "03da4ffa-beb9-49bd-b44e-7c07ab5e9f3e",
          "role": "SellerAgent",
          "deal": "2abb9da7-986f-4c60-bc83-fed1af825d34",
          "user": {
            "type": "user",
            "username": null,
            "first_name": "Unit",
            "last_name": "Test",
            "email": "[email protected]",
            "phone_number": "+4368120265807",
            "created_at": 1493115498.770362,
            "id": "80a227b2-29a0-11e7-b636-e4a7a08e15d4",
            "address_id": null,
            "cover_image_url": null,
            "profile_image_url": null,
            "updated_at": 1493115498.770744,
            "user_status": "Active",
            "profile_image_thumbnail_url": null,
            "cover_image_thumbnail_url": null,
            "email_confirmed": true,
            "timezone": "America/Chicago",
            "user_type": "Admin",
            "deleted_at": null,
            "phone_confirmed": false,
            "is_shadow": false,
            "personal_room": null,
            "brand": null,
            "fake_email": false,
            "features": [
              "Deals"
            ],
            "last_seen_at": null,
            "email_signature": null,
            "daily_enabled": false,
            "email_quota": 30000,
            "website": null,
            "instagram": null,
            "twitter": null,
            "linkedin": null,
            "youtube": null,
            "facebook": null,
            "designation": null,
            "tiktok": null,
            "mfa_enabled": false,
            "xpressdocs_user_id": "80a227b2-29a0-11e7-b636-e4a7a08e15d4",
            "bio": null,
            "current_time": "7:54 PM - Wednesday Aug 26, 2026",
            "push_allowed": true,
            "agents": null,
            "last_seen_type": null,
            "active_brand": null,
            "display_name": "Unit Test",
            "abbreviated_display_name": "Unit",
            "online_state": "Offline",
            "has_password": true
          },
          "commission_dollar": 20000,
          "brokerwolf_id": null,
          "brokerwolf_row_version": null,
          "legal_prefix": null,
          "legal_first_name": "Imaginary",
          "legal_middle_name": null,
          "legal_last_name": "Agent",
          "company_title": null,
          "commission_percentage": null,
          "email": "[email protected]",
          "phone_number": null,
          "checklist": null,
          "role_type": "Person",
          "agent": null,
          "old_current_address": null,
          "old_future_address": null,
          "office_name": null,
          "office_email": null,
          "office_phone": null,
          "office_fax": null,
          "office_license_number": null,
          "office_mls_id": null,
          "office_address": null,
          "searchable": "'agent':2 'imaginari':1 '[email protected]':3",
          "current_address": null,
          "future_address": null,
          "type": "deal_role",
          "mlsid": null,
          "legal_full_name": "Imaginary Agent"
        },
        "order": 1,
        "envelope_recipient_type": "CarbonCopy",
        "type": "envelope_recipient"
      }
    ],
    "documents": [
      {
        "id": "56c56d7a-9c9b-45d2-90cf-971cb44ab6f6",
        "envelope": "2d133a41-0fe6-49a0-b48b-7295c22bd425",
        "title": "Addendum for Back-Up Contract.pdf",
        "document_id": 1,
        "submission_revision": "efc5d213-5461-4a67-bd99-31ce72e7de3f",
        "file": null,
        "task": "e3df15b2-65e4-4c7b-9fc0-ea749ba5a4e0",
        "submission": "f78c012a-b9f5-4832-9c4b-ad590cec4987",
        "type": "envelope_document",
        "pdf": {
          "id": "7778f9bb-ba2a-46f0-bcfc-a7bae55c0dcf",
          "created_at": 1787792066.102697,
          "updated_at": 1787792066.102697,
          "deleted_at": null,
          "created_by": "03da4ffa-beb9-49bd-b44e-7c07ab5e9f3e",
          "path": "2abb9da7-986f-4c60-bc83-fed1af825d34/d9d38f40-a1b1-11f1-811e-f93126d9eb55.pdf",
          "name": "Addendum for Back-Up Contract.pdf.pdf",
          "public": false,
          "type": "file",
          "url": "https://private-cdn.irish.rechat.com/2abb9da7-986f-4c60-bc83-fed1af825d34/d9d38f40-a1b1-11f1-811e-f93126d9eb55.pdf?Expires=1787878466106&Key-Pair-Id=APKAIIRG223GKFAC4MHA&Signature=W5mylqh~4Z8~GXM5FhJnUPTm5d385AHi4I1rJComWtHAwWhTzMED~sNgpU8H-coK4Pos3GcImYrDOROpCqKThFzrkwYVux8VLkVziJMjXSvLwWdN-Tj5PdWsANPWW7W1Zh~8EBKKDAPaIorQraBTXJmz5lh0SkN~5b8rAP0wJX9pPxuoUwNkFWzXVU3clPlAGycLeA1ReXqV9zFByX~LMk~QYjYJkvqr5RHk-y1R-AV-EsodTQilCwVDt-F5b6TN51-l9tPYQCV7TCUt~gmm7ymXa7EkxVS1ZTFEq7ArREfwfRb9yo5nNYk9ZXzYsUqANuTFppB~3QmUo87ZxJhyFg__",
          "preview_url": "http://assets.rechat.com/mimes/application-pdf.png",
          "mime": "application/pdf"
        }
      }
    ]
  }
}

Get Envelopes of a deal

Get Envelopes of a deal
GET/deals/:deal/envelopes

Example URI

GET /deals/:deal/envelopes
URI Parameters
HideShow
deal
string (required) Example: 2abb9da7-986f-4c60-bc83-fed1af825d34
Response  200
HideShow
Body
{
  "code": "OK",
  "data": [
    {
      "id": "2d133a41-0fe6-49a0-b48b-7295c22bd425",
      "created_at": 1787792065.237569,
      "updated_at": 1787792066.073809,
      "created_by": "03da4ffa-beb9-49bd-b44e-7c07ab5e9f3e",
      "deal": "2abb9da7-986f-4c60-bc83-fed1af825d34",
      "docusign_id": "0bd9ee91-0146-4268-8230-f8f4094935b5",
      "status": "Sent",
      "title": "This envelope is sent automatically from our test suite",
      "webhook_token": "d94ff932-a1b1-11f1-af40-ae8942de711b",
      "auto_notify": true,
      "owner": "03da4ffa-beb9-49bd-b44e-7c07ab5e9f3e",
      "type": "envelope",
      "recipients": [
        {
          "id": "f38fe6c7-a663-4bda-a191-b9b2ce960b5f",
          "created_at": 1787792065.249771,
          "updated_at": 1787792065.249771,
          "signed_at": null,
          "envelope": "2d133a41-0fe6-49a0-b48b-7295c22bd425",
          "status": "Created",
          "role": {
            "id": "669e8975-49a1-4067-95eb-56fc856a9506",
            "created_at": 1787792064.805231,
            "updated_at": 1787792064.805231,
            "deleted_at": null,
            "created_by": "03da4ffa-beb9-49bd-b44e-7c07ab5e9f3e",
            "role": "BuyerAgent",
            "deal": "2abb9da7-986f-4c60-bc83-fed1af825d34",
            "user": {
              "type": "user",
              "username": null,
              "first_name": "Unit",
              "last_name": "Test",
              "email": "[email protected]",
              "phone_number": "+4368120265807",
              "created_at": 1493115498.770362,
              "id": "80a227b2-29a0-11e7-b636-e4a7a08e15d4",
              "address_id": null,
              "cover_image_url": null,
              "profile_image_url": null,
              "updated_at": 1493115498.770744,
              "user_status": "Active",
              "profile_image_thumbnail_url": null,
              "cover_image_thumbnail_url": null,
              "email_confirmed": true,
              "timezone": "America/Chicago",
              "user_type": "Admin",
              "deleted_at": null,
              "phone_confirmed": false,
              "is_shadow": false,
              "personal_room": null,
              "brand": null,
              "fake_email": false,
              "features": [
                "Deals"
              ],
              "last_seen_at": null,
              "email_signature": null,
              "daily_enabled": false,
              "email_quota": 30000,
              "website": null,
              "instagram": null,
              "twitter": null,
              "linkedin": null,
              "youtube": null,
              "facebook": null,
              "designation": null,
              "tiktok": null,
              "mfa_enabled": false,
              "xpressdocs_user_id": "80a227b2-29a0-11e7-b636-e4a7a08e15d4",
              "bio": null,
              "current_time": "7:54 PM - Wednesday Aug 26, 2026",
              "push_allowed": true,
              "agents": null,
              "last_seen_type": null,
              "active_brand": null,
              "display_name": "Unit Test",
              "abbreviated_display_name": "Unit",
              "online_state": "Offline",
              "has_password": true
            },
            "commission_dollar": null,
            "brokerwolf_id": null,
            "brokerwolf_row_version": null,
            "legal_prefix": null,
            "legal_first_name": "Wile",
            "legal_middle_name": "E.",
            "legal_last_name": "Coyote",
            "company_title": "ACME",
            "commission_percentage": 3,
            "email": "[email protected]",
            "phone_number": null,
            "checklist": null,
            "role_type": "Person",
            "agent": null,
            "old_current_address": null,
            "old_future_address": null,
            "office_name": null,
            "office_email": null,
            "office_phone": null,
            "office_fax": null,
            "office_license_number": null,
            "office_mls_id": null,
            "office_address": {
              "city": "Los Angeles",
              "full": "11687 Bellagio Rd, Los Angeles CA 90049",
              "name": "Bellagio",
              "type": "stdaddr",
              "line1": "11687 Bellagio Rd",
              "line2": "Los Angeles CA 90049",
              "state": "CA",
              "country": "USA",
              "suftype": "Rd",
              "postcode": "90049",
              "house_num": "11687"
            },
            "searchable": "'acm':1 'coyot':4 'e':3 '[email protected]':5 'wile':2",
            "current_address": null,
            "future_address": null,
            "type": "deal_role",
            "mlsid": null,
            "legal_full_name": "Wile E. Coyote"
          },
          "order": 1,
          "envelope_recipient_type": "Signer",
          "type": "envelope_recipient"
        },
        {
          "id": "4d47ac09-e321-4e79-8b9f-f55d54fcaab1",
          "created_at": 1787792065.251909,
          "updated_at": 1787792065.251909,
          "signed_at": null,
          "envelope": "2d133a41-0fe6-49a0-b48b-7295c22bd425",
          "status": "Created",
          "role": {
            "id": "9df49e31-f6de-4fe0-95fc-e7ef96b9d2aa",
            "created_at": 1787792064.807591,
            "updated_at": 1787792064.807591,
            "deleted_at": null,
            "created_by": "03da4ffa-beb9-49bd-b44e-7c07ab5e9f3e",
            "role": "SellerAgent",
            "deal": "2abb9da7-986f-4c60-bc83-fed1af825d34",
            "user": {
              "type": "user",
              "username": null,
              "first_name": "Unit",
              "last_name": "Test",
              "email": "[email protected]",
              "phone_number": "+4368120265807",
              "created_at": 1493115498.770362,
              "id": "80a227b2-29a0-11e7-b636-e4a7a08e15d4",
              "address_id": null,
              "cover_image_url": null,
              "profile_image_url": null,
              "updated_at": 1493115498.770744,
              "user_status": "Active",
              "profile_image_thumbnail_url": null,
              "cover_image_thumbnail_url": null,
              "email_confirmed": true,
              "timezone": "America/Chicago",
              "user_type": "Admin",
              "deleted_at": null,
              "phone_confirmed": false,
              "is_shadow": false,
              "personal_room": null,
              "brand": null,
              "fake_email": false,
              "features": [
                "Deals"
              ],
              "last_seen_at": null,
              "email_signature": null,
              "daily_enabled": false,
              "email_quota": 30000,
              "website": null,
              "instagram": null,
              "twitter": null,
              "linkedin": null,
              "youtube": null,
              "facebook": null,
              "designation": null,
              "tiktok": null,
              "mfa_enabled": false,
              "xpressdocs_user_id": "80a227b2-29a0-11e7-b636-e4a7a08e15d4",
              "bio": null,
              "current_time": "7:54 PM - Wednesday Aug 26, 2026",
              "push_allowed": true,
              "agents": null,
              "last_seen_type": null,
              "active_brand": null,
              "display_name": "Unit Test",
              "abbreviated_display_name": "Unit",
              "online_state": "Offline",
              "has_password": true
            },
            "commission_dollar": 20000,
            "brokerwolf_id": null,
            "brokerwolf_row_version": null,
            "legal_prefix": null,
            "legal_first_name": "Imaginary",
            "legal_middle_name": null,
            "legal_last_name": "Agent",
            "company_title": null,
            "commission_percentage": null,
            "email": "[email protected]",
            "phone_number": null,
            "checklist": null,
            "role_type": "Person",
            "agent": null,
            "old_current_address": null,
            "old_future_address": null,
            "office_name": null,
            "office_email": null,
            "office_phone": null,
            "office_fax": null,
            "office_license_number": null,
            "office_mls_id": null,
            "office_address": null,
            "searchable": "'agent':2 'imaginari':1 '[email protected]':3",
            "current_address": null,
            "future_address": null,
            "type": "deal_role",
            "mlsid": null,
            "legal_full_name": "Imaginary Agent"
          },
          "order": 1,
          "envelope_recipient_type": "CarbonCopy",
          "type": "envelope_recipient"
        },
        {
          "id": "5abd3eb5-8fe8-4086-aab2-6913a34f4528",
          "created_at": 1787792065.252755,
          "updated_at": 1787792065.252755,
          "signed_at": null,
          "envelope": "2d133a41-0fe6-49a0-b48b-7295c22bd425",
          "status": "Created",
          "role": {
            "id": "669e8975-49a1-4067-95eb-56fc856a9506",
            "created_at": 1787792064.805231,
            "updated_at": 1787792064.805231,
            "deleted_at": null,
            "created_by": "03da4ffa-beb9-49bd-b44e-7c07ab5e9f3e",
            "role": "BuyerAgent",
            "deal": "2abb9da7-986f-4c60-bc83-fed1af825d34",
            "user": {
              "type": "user",
              "username": null,
              "first_name": "Unit",
              "last_name": "Test",
              "email": "[email protected]",
              "phone_number": "+4368120265807",
              "created_at": 1493115498.770362,
              "id": "80a227b2-29a0-11e7-b636-e4a7a08e15d4",
              "address_id": null,
              "cover_image_url": null,
              "profile_image_url": null,
              "updated_at": 1493115498.770744,
              "user_status": "Active",
              "profile_image_thumbnail_url": null,
              "cover_image_thumbnail_url": null,
              "email_confirmed": true,
              "timezone": "America/Chicago",
              "user_type": "Admin",
              "deleted_at": null,
              "phone_confirmed": false,
              "is_shadow": false,
              "personal_room": null,
              "brand": null,
              "fake_email": false,
              "features": [
                "Deals"
              ],
              "last_seen_at": null,
              "email_signature": null,
              "daily_enabled": false,
              "email_quota": 30000,
              "website": null,
              "instagram": null,
              "twitter": null,
              "linkedin": null,
              "youtube": null,
              "facebook": null,
              "designation": null,
              "tiktok": null,
              "mfa_enabled": false,
              "xpressdocs_user_id": "80a227b2-29a0-11e7-b636-e4a7a08e15d4",
              "bio": null,
              "current_time": "7:54 PM - Wednesday Aug 26, 2026",
              "push_allowed": true,
              "agents": null,
              "last_seen_type": null,
              "active_brand": null,
              "display_name": "Unit Test",
              "abbreviated_display_name": "Unit",
              "online_state": "Offline",
              "has_password": true
            },
            "commission_dollar": null,
            "brokerwolf_id": null,
            "brokerwolf_row_version": null,
            "legal_prefix": null,
            "legal_first_name": "Wile",
            "legal_middle_name": "E.",
            "legal_last_name": "Coyote",
            "company_title": "ACME",
            "commission_percentage": 3,
            "email": "[email protected]",
            "phone_number": null,
            "checklist": null,
            "role_type": "Person",
            "agent": null,
            "old_current_address": null,
            "old_future_address": null,
            "office_name": null,
            "office_email": null,
            "office_phone": null,
            "office_fax": null,
            "office_license_number": null,
            "office_mls_id": null,
            "office_address": {
              "city": "Los Angeles",
              "full": "11687 Bellagio Rd, Los Angeles CA 90049",
              "name": "Bellagio",
              "type": "stdaddr",
              "line1": "11687 Bellagio Rd",
              "line2": "Los Angeles CA 90049",
              "state": "CA",
              "country": "USA",
              "suftype": "Rd",
              "postcode": "90049",
              "house_num": "11687"
            },
            "searchable": "'acm':1 'coyot':4 'e':3 '[email protected]':5 'wile':2",
            "current_address": null,
            "future_address": null,
            "type": "deal_role",
            "mlsid": null,
            "legal_full_name": "Wile E. Coyote"
          },
          "order": 1,
          "envelope_recipient_type": "Signer",
          "type": "envelope_recipient"
        },
        {
          "id": "c7c862ad-0f12-47a0-bf81-c5e80cf360bf",
          "created_at": 1787792065.253477,
          "updated_at": 1787792065.253477,
          "signed_at": null,
          "envelope": "2d133a41-0fe6-49a0-b48b-7295c22bd425",
          "status": "Created",
          "role": {
            "id": "9df49e31-f6de-4fe0-95fc-e7ef96b9d2aa",
            "created_at": 1787792064.807591,
            "updated_at": 1787792064.807591,
            "deleted_at": null,
            "created_by": "03da4ffa-beb9-49bd-b44e-7c07ab5e9f3e",
            "role": "SellerAgent",
            "deal": "2abb9da7-986f-4c60-bc83-fed1af825d34",
            "user": {
              "type": "user",
              "username": null,
              "first_name": "Unit",
              "last_name": "Test",
              "email": "[email protected]",
              "phone_number": "+4368120265807",
              "created_at": 1493115498.770362,
              "id": "80a227b2-29a0-11e7-b636-e4a7a08e15d4",
              "address_id": null,
              "cover_image_url": null,
              "profile_image_url": null,
              "updated_at": 1493115498.770744,
              "user_status": "Active",
              "profile_image_thumbnail_url": null,
              "cover_image_thumbnail_url": null,
              "email_confirmed": true,
              "timezone": "America/Chicago",
              "user_type": "Admin",
              "deleted_at": null,
              "phone_confirmed": false,
              "is_shadow": false,
              "personal_room": null,
              "brand": null,
              "fake_email": false,
              "features": [
                "Deals"
              ],
              "last_seen_at": null,
              "email_signature": null,
              "daily_enabled": false,
              "email_quota": 30000,
              "website": null,
              "instagram": null,
              "twitter": null,
              "linkedin": null,
              "youtube": null,
              "facebook": null,
              "designation": null,
              "tiktok": null,
              "mfa_enabled": false,
              "xpressdocs_user_id": "80a227b2-29a0-11e7-b636-e4a7a08e15d4",
              "bio": null,
              "current_time": "7:54 PM - Wednesday Aug 26, 2026",
              "push_allowed": true,
              "agents": null,
              "last_seen_type": null,
              "active_brand": null,
              "display_name": "Unit Test",
              "abbreviated_display_name": "Unit",
              "online_state": "Offline",
              "has_password": true
            },
            "commission_dollar": 20000,
            "brokerwolf_id": null,
            "brokerwolf_row_version": null,
            "legal_prefix": null,
            "legal_first_name": "Imaginary",
            "legal_middle_name": null,
            "legal_last_name": "Agent",
            "company_title": null,
            "commission_percentage": null,
            "email": "[email protected]",
            "phone_number": null,
            "checklist": null,
            "role_type": "Person",
            "agent": null,
            "old_current_address": null,
            "old_future_address": null,
            "office_name": null,
            "office_email": null,
            "office_phone": null,
            "office_fax": null,
            "office_license_number": null,
            "office_mls_id": null,
            "office_address": null,
            "searchable": "'agent':2 'imaginari':1 '[email protected]':3",
            "current_address": null,
            "future_address": null,
            "type": "deal_role",
            "mlsid": null,
            "legal_full_name": "Imaginary Agent"
          },
          "order": 1,
          "envelope_recipient_type": "CarbonCopy",
          "type": "envelope_recipient"
        }
      ],
      "documents": [
        {
          "id": "56c56d7a-9c9b-45d2-90cf-971cb44ab6f6",
          "envelope": "2d133a41-0fe6-49a0-b48b-7295c22bd425",
          "title": "Addendum for Back-Up Contract.pdf",
          "document_id": 1,
          "submission_revision": "efc5d213-5461-4a67-bd99-31ce72e7de3f",
          "file": null,
          "task": "e3df15b2-65e4-4c7b-9fc0-ea749ba5a4e0",
          "submission": "f78c012a-b9f5-4832-9c4b-ad590cec4987",
          "type": "envelope_document",
          "pdf": {
            "id": "7778f9bb-ba2a-46f0-bcfc-a7bae55c0dcf",
            "created_at": 1787792066.102697,
            "updated_at": 1787792066.102697,
            "deleted_at": null,
            "created_by": "03da4ffa-beb9-49bd-b44e-7c07ab5e9f3e",
            "path": "2abb9da7-986f-4c60-bc83-fed1af825d34/d9d38f40-a1b1-11f1-811e-f93126d9eb55.pdf",
            "name": "Addendum for Back-Up Contract.pdf.pdf",
            "public": false,
            "type": "file",
            "url": "https://private-cdn.irish.rechat.com/2abb9da7-986f-4c60-bc83-fed1af825d34/d9d38f40-a1b1-11f1-811e-f93126d9eb55.pdf?Expires=1787878466106&Key-Pair-Id=APKAIIRG223GKFAC4MHA&Signature=W5mylqh~4Z8~GXM5FhJnUPTm5d385AHi4I1rJComWtHAwWhTzMED~sNgpU8H-coK4Pos3GcImYrDOROpCqKThFzrkwYVux8VLkVziJMjXSvLwWdN-Tj5PdWsANPWW7W1Zh~8EBKKDAPaIorQraBTXJmz5lh0SkN~5b8rAP0wJX9pPxuoUwNkFWzXVU3clPlAGycLeA1ReXqV9zFByX~LMk~QYjYJkvqr5RHk-y1R-AV-EsodTQilCwVDt-F5b6TN51-l9tPYQCV7TCUt~gmm7ymXa7EkxVS1ZTFEq7ArREfwfRb9yo5nNYk9ZXzYsUqANuTFppB~3QmUo87ZxJhyFg__",
            "preview_url": "http://assets.rechat.com/mimes/application-pdf.png",
            "mime": "application/pdf"
          }
        }
      ]
    }
  ],
  "info": {
    "count": 1,
    "total": 0
  }
}

Sign an Envelope

Sign an Envelope
GET/envelopes/:id:/sign/:recipient

If the current user is among envelope.recipients, it means he should be able to sign it as well.

The process of signing is as follows:

  1. User’s browser will be opened to /envelopes/:id/sign/:recipient

  2. User’s browser will be redirected to a page on Docusign where he can sign the document

  3. User’s browser will be sent back to Rechat

  4. Rechat updates the Envelope information

  5. Control is given back to client (either using Browser’s postMessage mechanism or redirecting him to rechat:// on phones)

  6. Client updates the envelope information

Example URI

GET /envelopes/:id:/sign/:recipient

Void an Envelope

Void an Envelope
PATCH/envelopes/:id:/status

If for any reason (for example presence of an error in the legal documents) the agent decides that the envelope must not be legally binded, he can Void (Cancel) it.

If any of the recipients Voids the contract, that means he refuses to sign it. The envelope in question and all of its documents will not be legally binded and nobody can sign it anymore.

Example URI

PATCH /envelopes/:id:/status
URI Parameters
HideShow
id
string (required) Example: 2d133a41-0fe6-49a0-b48b-7295c22bd425
Request
HideShow
Body
{
  "status": "Voided"
}
Response  200
HideShow
Body
{
  "code": "OK",
  "data": {
    "id": "2d133a41-0fe6-49a0-b48b-7295c22bd425",
    "created_at": 1787792065.237569,
    "updated_at": 1787792066.322942,
    "created_by": "03da4ffa-beb9-49bd-b44e-7c07ab5e9f3e",
    "deal": "2abb9da7-986f-4c60-bc83-fed1af825d34",
    "docusign_id": "0bd9ee91-0146-4268-8230-f8f4094935b5",
    "status": "Voided",
    "title": "This envelope is sent automatically from our test suite",
    "webhook_token": "d94ff932-a1b1-11f1-af40-ae8942de711b",
    "auto_notify": true,
    "owner": "03da4ffa-beb9-49bd-b44e-7c07ab5e9f3e",
    "type": "envelope",
    "recipients": [
      {
        "id": "f38fe6c7-a663-4bda-a191-b9b2ce960b5f",
        "created_at": 1787792065.249771,
        "updated_at": 1787792065.249771,
        "signed_at": null,
        "envelope": "2d133a41-0fe6-49a0-b48b-7295c22bd425",
        "status": "Created",
        "role": {
          "id": "669e8975-49a1-4067-95eb-56fc856a9506",
          "created_at": 1787792064.805231,
          "updated_at": 1787792064.805231,
          "deleted_at": null,
          "created_by": "03da4ffa-beb9-49bd-b44e-7c07ab5e9f3e",
          "role": "BuyerAgent",
          "deal": "2abb9da7-986f-4c60-bc83-fed1af825d34",
          "user": {
            "type": "user",
            "username": null,
            "first_name": "Unit",
            "last_name": "Test",
            "email": "[email protected]",
            "phone_number": "+4368120265807",
            "created_at": 1493115498.770362,
            "id": "80a227b2-29a0-11e7-b636-e4a7a08e15d4",
            "address_id": null,
            "cover_image_url": null,
            "profile_image_url": null,
            "updated_at": 1493115498.770744,
            "user_status": "Active",
            "profile_image_thumbnail_url": null,
            "cover_image_thumbnail_url": null,
            "email_confirmed": true,
            "timezone": "America/Chicago",
            "user_type": "Admin",
            "deleted_at": null,
            "phone_confirmed": false,
            "is_shadow": false,
            "personal_room": null,
            "brand": null,
            "fake_email": false,
            "features": [
              "Deals"
            ],
            "last_seen_at": null,
            "email_signature": null,
            "daily_enabled": false,
            "email_quota": 30000,
            "website": null,
            "instagram": null,
            "twitter": null,
            "linkedin": null,
            "youtube": null,
            "facebook": null,
            "designation": null,
            "tiktok": null,
            "mfa_enabled": false,
            "xpressdocs_user_id": "80a227b2-29a0-11e7-b636-e4a7a08e15d4",
            "bio": null,
            "current_time": "7:54 PM - Wednesday Aug 26, 2026",
            "push_allowed": true,
            "agents": null,
            "last_seen_type": null,
            "active_brand": null,
            "display_name": "Unit Test",
            "abbreviated_display_name": "Unit",
            "online_state": "Offline",
            "has_password": true
          },
          "commission_dollar": null,
          "brokerwolf_id": null,
          "brokerwolf_row_version": null,
          "legal_prefix": null,
          "legal_first_name": "Wile",
          "legal_middle_name": "E.",
          "legal_last_name": "Coyote",
          "company_title": "ACME",
          "commission_percentage": 3,
          "email": "[email protected]",
          "phone_number": null,
          "checklist": null,
          "role_type": "Person",
          "agent": null,
          "old_current_address": null,
          "old_future_address": null,
          "office_name": null,
          "office_email": null,
          "office_phone": null,
          "office_fax": null,
          "office_license_number": null,
          "office_mls_id": null,
          "office_address": {
            "city": "Los Angeles",
            "full": "11687 Bellagio Rd, Los Angeles CA 90049",
            "name": "Bellagio",
            "type": "stdaddr",
            "line1": "11687 Bellagio Rd",
            "line2": "Los Angeles CA 90049",
            "state": "CA",
            "country": "USA",
            "suftype": "Rd",
            "postcode": "90049",
            "house_num": "11687"
          },
          "searchable": "'acm':1 'coyot':4 'e':3 '[email protected]':5 'wile':2",
          "current_address": null,
          "future_address": null,
          "type": "deal_role",
          "mlsid": null,
          "legal_full_name": "Wile E. Coyote"
        },
        "order": 1,
        "envelope_recipient_type": "Signer",
        "type": "envelope_recipient"
      },
      {
        "id": "4d47ac09-e321-4e79-8b9f-f55d54fcaab1",
        "created_at": 1787792065.251909,
        "updated_at": 1787792065.251909,
        "signed_at": null,
        "envelope": "2d133a41-0fe6-49a0-b48b-7295c22bd425",
        "status": "Created",
        "role": {
          "id": "9df49e31-f6de-4fe0-95fc-e7ef96b9d2aa",
          "created_at": 1787792064.807591,
          "updated_at": 1787792064.807591,
          "deleted_at": null,
          "created_by": "03da4ffa-beb9-49bd-b44e-7c07ab5e9f3e",
          "role": "SellerAgent",
          "deal": "2abb9da7-986f-4c60-bc83-fed1af825d34",
          "user": {
            "type": "user",
            "username": null,
            "first_name": "Unit",
            "last_name": "Test",
            "email": "[email protected]",
            "phone_number": "+4368120265807",
            "created_at": 1493115498.770362,
            "id": "80a227b2-29a0-11e7-b636-e4a7a08e15d4",
            "address_id": null,
            "cover_image_url": null,
            "profile_image_url": null,
            "updated_at": 1493115498.770744,
            "user_status": "Active",
            "profile_image_thumbnail_url": null,
            "cover_image_thumbnail_url": null,
            "email_confirmed": true,
            "timezone": "America/Chicago",
            "user_type": "Admin",
            "deleted_at": null,
            "phone_confirmed": false,
            "is_shadow": false,
            "personal_room": null,
            "brand": null,
            "fake_email": false,
            "features": [
              "Deals"
            ],
            "last_seen_at": null,
            "email_signature": null,
            "daily_enabled": false,
            "email_quota": 30000,
            "website": null,
            "instagram": null,
            "twitter": null,
            "linkedin": null,
            "youtube": null,
            "facebook": null,
            "designation": null,
            "tiktok": null,
            "mfa_enabled": false,
            "xpressdocs_user_id": "80a227b2-29a0-11e7-b636-e4a7a08e15d4",
            "bio": null,
            "current_time": "7:54 PM - Wednesday Aug 26, 2026",
            "push_allowed": true,
            "agents": null,
            "last_seen_type": null,
            "active_brand": null,
            "display_name": "Unit Test",
            "abbreviated_display_name": "Unit",
            "online_state": "Offline",
            "has_password": true
          },
          "commission_dollar": 20000,
          "brokerwolf_id": null,
          "brokerwolf_row_version": null,
          "legal_prefix": null,
          "legal_first_name": "Imaginary",
          "legal_middle_name": null,
          "legal_last_name": "Agent",
          "company_title": null,
          "commission_percentage": null,
          "email": "[email protected]",
          "phone_number": null,
          "checklist": null,
          "role_type": "Person",
          "agent": null,
          "old_current_address": null,
          "old_future_address": null,
          "office_name": null,
          "office_email": null,
          "office_phone": null,
          "office_fax": null,
          "office_license_number": null,
          "office_mls_id": null,
          "office_address": null,
          "searchable": "'agent':2 'imaginari':1 '[email protected]':3",
          "current_address": null,
          "future_address": null,
          "type": "deal_role",
          "mlsid": null,
          "legal_full_name": "Imaginary Agent"
        },
        "order": 1,
        "envelope_recipient_type": "CarbonCopy",
        "type": "envelope_recipient"
      },
      {
        "id": "5abd3eb5-8fe8-4086-aab2-6913a34f4528",
        "created_at": 1787792065.252755,
        "updated_at": 1787792065.252755,
        "signed_at": null,
        "envelope": "2d133a41-0fe6-49a0-b48b-7295c22bd425",
        "status": "Created",
        "role": {
          "id": "669e8975-49a1-4067-95eb-56fc856a9506",
          "created_at": 1787792064.805231,
          "updated_at": 1787792064.805231,
          "deleted_at": null,
          "created_by": "03da4ffa-beb9-49bd-b44e-7c07ab5e9f3e",
          "role": "BuyerAgent",
          "deal": "2abb9da7-986f-4c60-bc83-fed1af825d34",
          "user": {
            "type": "user",
            "username": null,
            "first_name": "Unit",
            "last_name": "Test",
            "email": "[email protected]",
            "phone_number": "+4368120265807",
            "created_at": 1493115498.770362,
            "id": "80a227b2-29a0-11e7-b636-e4a7a08e15d4",
            "address_id": null,
            "cover_image_url": null,
            "profile_image_url": null,
            "updated_at": 1493115498.770744,
            "user_status": "Active",
            "profile_image_thumbnail_url": null,
            "cover_image_thumbnail_url": null,
            "email_confirmed": true,
            "timezone": "America/Chicago",
            "user_type": "Admin",
            "deleted_at": null,
            "phone_confirmed": false,
            "is_shadow": false,
            "personal_room": null,
            "brand": null,
            "fake_email": false,
            "features": [
              "Deals"
            ],
            "last_seen_at": null,
            "email_signature": null,
            "daily_enabled": false,
            "email_quota": 30000,
            "website": null,
            "instagram": null,
            "twitter": null,
            "linkedin": null,
            "youtube": null,
            "facebook": null,
            "designation": null,
            "tiktok": null,
            "mfa_enabled": false,
            "xpressdocs_user_id": "80a227b2-29a0-11e7-b636-e4a7a08e15d4",
            "bio": null,
            "current_time": "7:54 PM - Wednesday Aug 26, 2026",
            "push_allowed": true,
            "agents": null,
            "last_seen_type": null,
            "active_brand": null,
            "display_name": "Unit Test",
            "abbreviated_display_name": "Unit",
            "online_state": "Offline",
            "has_password": true
          },
          "commission_dollar": null,
          "brokerwolf_id": null,
          "brokerwolf_row_version": null,
          "legal_prefix": null,
          "legal_first_name": "Wile",
          "legal_middle_name": "E.",
          "legal_last_name": "Coyote",
          "company_title": "ACME",
          "commission_percentage": 3,
          "email": "[email protected]",
          "phone_number": null,
          "checklist": null,
          "role_type": "Person",
          "agent": null,
          "old_current_address": null,
          "old_future_address": null,
          "office_name": null,
          "office_email": null,
          "office_phone": null,
          "office_fax": null,
          "office_license_number": null,
          "office_mls_id": null,
          "office_address": {
            "city": "Los Angeles",
            "full": "11687 Bellagio Rd, Los Angeles CA 90049",
            "name": "Bellagio",
            "type": "stdaddr",
            "line1": "11687 Bellagio Rd",
            "line2": "Los Angeles CA 90049",
            "state": "CA",
            "country": "USA",
            "suftype": "Rd",
            "postcode": "90049",
            "house_num": "11687"
          },
          "searchable": "'acm':1 'coyot':4 'e':3 '[email protected]':5 'wile':2",
          "current_address": null,
          "future_address": null,
          "type": "deal_role",
          "mlsid": null,
          "legal_full_name": "Wile E. Coyote"
        },
        "order": 1,
        "envelope_recipient_type": "Signer",
        "type": "envelope_recipient"
      },
      {
        "id": "c7c862ad-0f12-47a0-bf81-c5e80cf360bf",
        "created_at": 1787792065.253477,
        "updated_at": 1787792065.253477,
        "signed_at": null,
        "envelope": "2d133a41-0fe6-49a0-b48b-7295c22bd425",
        "status": "Created",
        "role": {
          "id": "9df49e31-f6de-4fe0-95fc-e7ef96b9d2aa",
          "created_at": 1787792064.807591,
          "updated_at": 1787792064.807591,
          "deleted_at": null,
          "created_by": "03da4ffa-beb9-49bd-b44e-7c07ab5e9f3e",
          "role": "SellerAgent",
          "deal": "2abb9da7-986f-4c60-bc83-fed1af825d34",
          "user": {
            "type": "user",
            "username": null,
            "first_name": "Unit",
            "last_name": "Test",
            "email": "[email protected]",
            "phone_number": "+4368120265807",
            "created_at": 1493115498.770362,
            "id": "80a227b2-29a0-11e7-b636-e4a7a08e15d4",
            "address_id": null,
            "cover_image_url": null,
            "profile_image_url": null,
            "updated_at": 1493115498.770744,
            "user_status": "Active",
            "profile_image_thumbnail_url": null,
            "cover_image_thumbnail_url": null,
            "email_confirmed": true,
            "timezone": "America/Chicago",
            "user_type": "Admin",
            "deleted_at": null,
            "phone_confirmed": false,
            "is_shadow": false,
            "personal_room": null,
            "brand": null,
            "fake_email": false,
            "features": [
              "Deals"
            ],
            "last_seen_at": null,
            "email_signature": null,
            "daily_enabled": false,
            "email_quota": 30000,
            "website": null,
            "instagram": null,
            "twitter": null,
            "linkedin": null,
            "youtube": null,
            "facebook": null,
            "designation": null,
            "tiktok": null,
            "mfa_enabled": false,
            "xpressdocs_user_id": "80a227b2-29a0-11e7-b636-e4a7a08e15d4",
            "bio": null,
            "current_time": "7:54 PM - Wednesday Aug 26, 2026",
            "push_allowed": true,
            "agents": null,
            "last_seen_type": null,
            "active_brand": null,
            "display_name": "Unit Test",
            "abbreviated_display_name": "Unit",
            "online_state": "Offline",
            "has_password": true
          },
          "commission_dollar": 20000,
          "brokerwolf_id": null,
          "brokerwolf_row_version": null,
          "legal_prefix": null,
          "legal_first_name": "Imaginary",
          "legal_middle_name": null,
          "legal_last_name": "Agent",
          "company_title": null,
          "commission_percentage": null,
          "email": "[email protected]",
          "phone_number": null,
          "checklist": null,
          "role_type": "Person",
          "agent": null,
          "old_current_address": null,
          "old_future_address": null,
          "office_name": null,
          "office_email": null,
          "office_phone": null,
          "office_fax": null,
          "office_license_number": null,
          "office_mls_id": null,
          "office_address": null,
          "searchable": "'agent':2 'imaginari':1 '[email protected]':3",
          "current_address": null,
          "future_address": null,
          "type": "deal_role",
          "mlsid": null,
          "legal_full_name": "Imaginary Agent"
        },
        "order": 1,
        "envelope_recipient_type": "CarbonCopy",
        "type": "envelope_recipient"
      }
    ],
    "documents": [
      {
        "id": "56c56d7a-9c9b-45d2-90cf-971cb44ab6f6",
        "envelope": "2d133a41-0fe6-49a0-b48b-7295c22bd425",
        "title": "Addendum for Back-Up Contract.pdf",
        "document_id": 1,
        "submission_revision": "efc5d213-5461-4a67-bd99-31ce72e7de3f",
        "file": null,
        "task": "e3df15b2-65e4-4c7b-9fc0-ea749ba5a4e0",
        "submission": "f78c012a-b9f5-4832-9c4b-ad590cec4987",
        "type": "envelope_document",
        "pdf": {
          "id": "7778f9bb-ba2a-46f0-bcfc-a7bae55c0dcf",
          "created_at": 1787792066.102697,
          "updated_at": 1787792066.102697,
          "deleted_at": null,
          "created_by": "03da4ffa-beb9-49bd-b44e-7c07ab5e9f3e",
          "path": "2abb9da7-986f-4c60-bc83-fed1af825d34/d9d38f40-a1b1-11f1-811e-f93126d9eb55.pdf",
          "name": "Addendum for Back-Up Contract.pdf.pdf",
          "public": false,
          "type": "file",
          "url": "https://private-cdn.irish.rechat.com/2abb9da7-986f-4c60-bc83-fed1af825d34/d9d38f40-a1b1-11f1-811e-f93126d9eb55.pdf?Expires=1787878466106&Key-Pair-Id=APKAIIRG223GKFAC4MHA&Signature=W5mylqh~4Z8~GXM5FhJnUPTm5d385AHi4I1rJComWtHAwWhTzMED~sNgpU8H-coK4Pos3GcImYrDOROpCqKThFzrkwYVux8VLkVziJMjXSvLwWdN-Tj5PdWsANPWW7W1Zh~8EBKKDAPaIorQraBTXJmz5lh0SkN~5b8rAP0wJX9pPxuoUwNkFWzXVU3clPlAGycLeA1ReXqV9zFByX~LMk~QYjYJkvqr5RHk-y1R-AV-EsodTQilCwVDt-F5b6TN51-l9tPYQCV7TCUt~gmm7ymXa7EkxVS1ZTFEq7ArREfwfRb9yo5nNYk9ZXzYsUqANuTFppB~3QmUo87ZxJhyFg__",
          "preview_url": "http://assets.rechat.com/mimes/application-pdf.png",
          "mime": "application/pdf"
        }
      }
    ]
  }
}

Generated by aglio on 27 Aug 2026