GET/workflow/documents/{approvalDocumentId}

決裁文書を取得する。

Authorization

oauth2

Access Token を指定します。
指定の方法や Access Token の取得方法は 共通仕様 を参照してください。

Scope

workflow
workflow.read

HTTP Request

GEThttps://www.worksapis.com/v1.0/workflow/documents/{approvalDocumentId}

Path Parameters

ParameterTypeDescription
approvalDocumentId string 

決裁文書 ID


required 

Header Parameters

HeadertypeDescription
Authorization string 

Bearer {token}


required 

Response

HTTP 200

OK

PropertyTypeDescription
domainId integer 

ドメイン ID


required 
approvalDocumentId integer 

決裁文書 ID


required 
documentFormId string 

申請フォーマット ID


required 
categoryId integer 

カテゴリー ID


required 
documentNumber string 

文書番号

 
title string 

タイトル

 
status string 

ステータス

  • IN-PROGRESS: 進行中
  • APPROVED: 完了
  • REJECTED: 却下
  • CANCELED: 引き戻し

required 
userId string 

申請者 ID

 
userName string 

申請者名

 
orgUnitId string 

申請者の組織 ID

 
orgUnitName string 

申請者の組織名

 
createdTime string 

申請日時（形式:YYYY-MM-DDThh:mm:ssTZD）


required 
completedTime string 

完了日時（形式:YYYY-MM-DDThh:mm:ssTZD）

 
visible boolean 

文書の公開可否

 
viewUrl string 

文書の参照 URL

 
approvalLines array (ApprovalLine) 

決裁ライン情報

 
shareType string 

共有範囲

  • PART_SHARE: メンバー指定
  • ALL_SHARE: すべてのメンバー
 
sharedMembers array (Shared) 

共有範囲情報

 
opinionCount integer 

コメントの数

 
attachmentCount integer 

添付ファイルの数

 
relatedDocumentCount integer 

参考文書の数

 
recipientCount integer 

このPropertyは利用されていません。

 
recipients object 

このPropertyは利用されていません。


nullable : true 
documentBody object 

決裁文書の作成と読み取り を参照する。

 

ApprovalLine

PropertyTypeDescription
sequence integer 

決裁ラインの順序

 
type string 

決裁ラインの決裁タイプ

  • APPROVAL: 承認
  • REFERENCE: 自動承認
  • AGREEMENT: 合意
  • PARALLEL_APPROVAL: 並列承認
  • PARALLEL_AGREEMENT: 並列合意
 
status string 

決裁処理状態

  • UPCOMING: 予定
  • PENDING: 保留
  • APPROVED: 承認
  • REJECTED: 却下
  • DELEGATED_MANAGER: 管理者による委任
  • DELEGATED_USER: 承認者による委任
  • DELEGATED_AUTO: 自動的な委任
 
userId string 

決裁者 ID

 
userName string 

決裁者名

 
orgUnitId string 

決裁者の組織 ID

 
orgUnitName string 

決裁者の組織名

 
approvalTime string 

決裁日時（形式:YYYY-MM-DDThh:mm:ssTZD）

 

Shared

PropertyTypeDescription
type string 

共有先

  • DOMAIN: すべてのメンバー (ドメイン)
  • USER: メンバー
  • ORGUNIT: 組織
  • ORGUNIT_INCLUDE_SUBS: 下位を含む組織

required 
id string 

共有先の ID

  • 共有範囲が「すべてのメンバー」の場合には、ドメイン ID
  • 共有範囲が「メンバー」の場合、ユーザー ID
  • 共有範囲が「組織」または「下位を含む組織」の場合には、組織 ID

required 
name string 

共有先の名前

  • 共有範囲が「すべてのメンバー」の場合には、会社名
  • 共有範囲が「メンバー」の場合、ユーザー名
  • 共有範囲が「組織」または「下位を含む組織」の場合には、組織名
 

Response Example

example

1{2  "domainId": 10000001,3  "approvalDocumentId": 10001,4  "documentFormId": "16d11974-1234-1234-1234-52322ff286ee",5  "categoryId": 10,6  "documentNumber": "2026-CUS001-00001",7  "title": "休暇使用計画書",8  "status": "IN-PROGRESS",9  "userId": "userf7da-1234-1234-1234-030f3b4c756x",10  "userName": "ワークス太郎",11  "orgUnitId": "2c048949-1234-1234-1234-0374dd0b1976",12  "orgUnitName": "人事部",13  "createdTime": "2026-01-01T10:00:00+09:00",14  "completedTime": "",15  "visible": true,16  "viewUrl": "https://flow.worksmobile.com/user/view/doc/10001",17  "approvalLines": [18    {19      "sequence": 1,20      "type": "APPROVAL",21      "status": "PENDING",22      "userId": "20754547-1234-1234-1234-030918f30e4d",23      "userName": "Susan Nielsen",24      "orgUnitId": "2c048949-1234-1234-1234-0374dd0b1976",25      "orgUnitName": "人事部",26      "approvalTime": ""27    },28    {29      "sequence": 2,30      "type": "APPROVAL",31      "status": "UPCOMING",32      "userId": "1a29db81-1234-1234-1234-031ac869197d",33      "userName": "ワークス次郎",34      "orgUnitId": "2c048949-1234-1234-1234-0374dd0b1976",35      "orgUnitName": "総務部",36      "approvalTime": ""37    }38  ],39  "shareType": "PART_SHARE",40  "sharedMembers": [41    {42      "type": "USER",43      "id": "56006105-1234-1234-1234-27c0bde4258c",44      "name": "ワークス花子"45    }46  ],47  "opinionCount": 0,48  "attachmentCount": 0,49  "relatedDocumentCount": 0,50  "recipientCount": 0,51  "documentBody": {}52}