SIsignalshq
Intake Requests Dashboard
Intake Requests Dashboard

Get Intake Request Details for Dashboard

Get comprehensive details about a specific intake request for dashboard view. Includes client information, completion statistics, and separated document lists.

get/internal/api/intake-requests/{request_id}

Request

  • Base URL
    https://api.signalshq.io (the document declares no server; this is the origin it was published from)
  • Auth
    OAuth 2
    Password
    Token URL: /auth/login

Path parameters

request_idstring uuid required

Response

Successful Response

idstring uuid required

Unique identifier for the upload request

tenant_idstring uuid required

Tenant ID

client_idstring uuid required

Client ID

client_namestring required

Client's full name

client_identifierstring required

Client's readable identifier (e.g., 'AT-23456')

request_titlestring required

Title of the upload request

instructionsstring nullable

General instructions for the client

tax_yearstring nullable

Tax year

recipient_emailstring nullable

Email address where request was sent

recipient_namestring nullable

Name of the recipient

target_folder_idstring uuid nullable

Target folder ID

intake_tokenstring required

Secure intake token

upload_urlstring required

Public upload URL for clients

expires_atstring date-time required

When the upload link expires

status'DRAFT' | 'EMAIL_SENT' | 'ACTIVE' | 'COMPLETED' | 'EXPIRED' | 'REVOKED' required

Enum for intake request status

total_itemsinteger required

Total number of items requested

completed_itemsinteger required

Number of items completed

completion_ratestring required

Completion rate in format 'completed/total' (e.g., '2/8')

completion_statusstring required

Completion status: 'Completed', 'In Progress', or 'Pending'

completed_countinteger required

Number of completed/uploaded items

pending_countinteger required

Number of pending items

rejected_countinteger

Number of rejected items

created_atstring date-time required

When the request was created

updated_atstring date-time required

When the request was last updated

created_bystring required

User who created the request

revoked_atstring date-time nullable

When the request was revoked

revoked_bystring nullable

User who revoked the request

revoked_reasonstring nullable

Reason for revocation

max_edits_per_iteminteger required

Maximum number of edits/reuploads allowed per item

questionnaire_from_pyrstring nullable

Questionnaire processing status for previous year return (if applicable for this intake request)

document_checklist_suggestionstring nullable

Document checklist processing status for previous year return (if applicable for this intake request)

status_labelstring required

Human-readable status for UI display.

Example response

{
  "client_identifier": "AT-23456",
  "completion_rate": "2/8",
  "completion_status": "In Progress",
  "completed_count": 2,
  "pending_count": 6,
  "items": [
    {
      "description": "Please upload all W-2 forms from 2024",
      "notes": "Client mentioned they will upload this next week",
      "tags": [
        "CORP - PERSON_ABC",
        "CHASE BANK"
      ],
      "client_notes": "This is my W-2 from Acme Corporation",
      "document_type_label": "W-2",
      "uploaded_by": "John Doe",
      "can_modify": true,
      "rejection_reason": "Document not available",
      "uploaded_documents": [
        {
          "document_matching": {
            "document_classification": "Form W-2",
            "document_type_identifier": "W2",
            "document_type_display_name": "Form W-2",
            "instance_name": "ACME Corporation",
            "document_classification_status": "COMPLETED"
          }
        }
      ]
    }
  ],
  "additional_documents": [
    {
      "description": "Please upload all W-2 forms from 2024",
      "notes": "Client mentioned they will upload this next week",
      "tags": [
        "CORP - PERSON_ABC",
        "CHASE BANK"
      ],
      "client_notes": "This is my W-2 from Acme Corporation",
      "document_type_label": "W-2",
      "uploaded_by": "John Doe",
      "can_modify": true,
      "rejection_reason": "Document not available",
      "uploaded_documents": [
        {
          "document_matching": {
            "document_classification": "Form W-2",
            "document_type_identifier": "W2",
            "document_type_display_name": "Form W-2",
            "instance_name": "ACME Corporation",
            "document_classification_status": "COMPLETED"
          }
        }
      ]
    }
  ],
  "voluntary_documents": [
    {
      "description": "Please upload all W-2 forms from 2024",
      "notes": "Client mentioned they will upload this next week",
      "tags": [
        "CORP - PERSON_ABC",
        "CHASE BANK"
      ],
      "client_notes": "This is my W-2 from Acme Corporation",
      "document_type_label": "W-2",
      "uploaded_by": "John Doe",
      "can_modify": true,
      "rejection_reason": "Document not available",
      "uploaded_documents": [
        {
          "document_matching": {
            "document_classification": "Form W-2",
            "document_type_identifier": "W2",
            "document_type_display_name": "Form W-2",
            "instance_name": "ACME Corporation",
            "document_classification_status": "COMPLETED"
          }
        }
      ]
    }
  ],
  "questionnaire_from_pyr": "COMPLETED",
  "document_checklist_suggestion": "COMPLETED",
  "previous_year_return": {
    "is_reupload_allowed": true
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.