Documents
Retrieve Documents

Discussion

A document is a pdf file related to an event.

The /documents/:session_document_id/session/:sessions_id endpoint is used in conjunction with the /move_ins/review_cost endpoint.
review_cost will return a session_id and a list of Event Documents, each with their own session_document_id.
The "session" associated with these two IDs will expire 24 hours after they have been initialized by the review_cost endpoint.
This session_document_id is NOT the same ID as the document_id used with the /documents/:id endpoint, and any attempt to use it as such will result in a 404.

>>>

GET /v1/:facility_id/documents/:id
Returns a pdf of the specified document

Examples

GET /v1/2c5426c2-fbfd-43b7-813c-c9ba40780a34/documents/4179b504-cf48-481e-a10c-f8c890757c32
204
>>>

GET /v1/:facility_id/documents/:session_document_id/session/:session_id
Returns a pdf of the specifed document for a move in

Examples

GET /v1/4b711006-8091-43dc-9c01-3b9bcf3e1862/documents/cb0986207cada7275e959574067454c6/session/5e05bbdf15c9bf068e448f7e6ce44008
200

Params

Param name Description
session_id
required
Value: Must be a String
session_document_id
required
Value: Must be a String
>>>

GET /v1/:facility_id/events/:event_id/documents
Returns a list of documents and their IDs

The event_id can be a move_in_unit_event, move_out_unit_event, or successful_payment_event id.

Examples

GET /v1/91059f0d-ef4d-494c-a9cd-a4ecd0cb5225/events/fefe4801-ff83-46f1-9e41-73962b03d125/documents
200
{
  "documents": [
    {
      "id": "eefb7f2e-f193-4eaa-8e59-9dfe4be8f45d",
      "description": "Print Doc 2",
      "type": "PrintTemplate",
      "is_relevant": true,
      "created_at": "2022-09-12T22:36:14.948-10:00"
    }
  ],
  "meta": {
    "pagination": {
      "current_page": 1,
      "total_pages": 1,
      "per_page": 100,
      "total_entries": 1,
      "previous_page": null,
      "next_page": null
    },
    "status_code": 200,
    "status_message": "OK",
    "status_cat": "https://http.cat/200",
    "request_method": "GET",
    "request_id": null,
    "parameters": {
      "facility_id": "91059f0d-ef4d-494c-a9cd-a4ecd0cb5225",
      "event_id": "fefe4801-ff83-46f1-9e41-73962b03d125"
    }
  }
}
>>>

POST /v1/:facility_id/documents/:event_id/send_esignable_documents
Send esignable documents for a given event via email or sms to a specifed email address or phone number

Discussion

Given a facility_id and event_id, this endpoint will attempt to deliver any of the event's esignable documents to the specified email address or phone number (via sms).
If there are no esignable documents related to the specified event, a 400 status code will be returned along with an error message.
You should never specify both email and sms_number. If both parameters are provided, an error will be returned.

Examples

POST /v1/6cd66b9b-0270-4c6c-9e4e-d6d98e326f33/documents/5a7d1a95-9238-42d2-b408-09d60ae35165/send_esignable_documents
{
  "email": "mrdinkle@storedge.com"
}
200
{
  "meta": {
    "status_code": 200,
    "status_message": "OK",
    "status_cat": "https://http.cat/200",
    "request_method": "POST",
    "request_id": null,
    "parameters": {
      "email": "mrdinkle@storedge.com",
      "facility_id": "6cd66b9b-0270-4c6c-9e4e-d6d98e326f33",
      "event_id": "5a7d1a95-9238-42d2-b408-09d60ae35165"
    }
  }
}

Params

Param name Description
email
optional

Required to send esignable documents via email


Value: Must be a String
sms_number
optional

Required to send esignable documents via sms


Value: Must be a String