GET/paperon/projects/{projectId}/files/{fileId}

PaperOn ファイルの情報を取得します。

Authorization

oauth2

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

Scope

paperon
paperon.read

HTTP Request

GEThttps://www.worksapis.com/v1.0/paperon/projects/{projectId}/files/{fileId}

Path Parameters

ParameterTypeDescription
projectId string 

プロジェクト ID


required
example : 550e8400-e29b-41d4-a716-446655440000 
fileId string 

ファイル ID


required
example : 550e8400-e29b-41d4-a716-446655440000 

Header Parameters

HeadertypeDescription
Authorization string 

Bearer {token}


required 

Response

HTTP 200

OK

PropertyTypeDescription
fileId string 

ファイル ID


example : 550e8400-e29b-41d4-a716-446655440000 
fileName string 

ファイル名

 
approvalStatus string 

ファイルステータス

  • extraction_processing : OCR 読み取り中の状態。この状態のファイルは、ファイルの取得、部分更新、原本ファイルのダウンロード、読み取り結果の取得はできません。
  • new : 新規。ファイルが登録され、OCR 読み取りが完了した状態。
  • extraction_failed : 失敗。(読み取り失敗や読み取り回数の不足)
  • pending : 承認申請。ユーザーが読み取り結果を修正し、承認をリクエストした状態。
  • approved : 承認。
  • rejected : 差し戻し。承認リクエストされたファイルについて再確認が求められている状態、
  • completed : 完了。

Allowed values : extraction_processing, new, extraction_failed, pending, approved, rejected, completed 
uploaderId string 

アップロード ユーザー ID
削除されたユーザーや、外部からのメールによるアップロードなど、アップロード ユーザー情報が特定できない場合には null


nullable : true 
uploaderName string 

アップロード ユーザー名。メールによるアップロードの場合には 'Upload by email' と記載される。

 
modifiedTime string 

更新日時 (ISO 8601)


example : 2026-04-09T14:20:30+09:00
format : date-time 
createdTime string 

作成日時 (ISO 8601)


example : 2026-04-09T14:20:30+09:00
format : date-time 

Response Example

example

1{2  "fileId": "550e8400-e29b-41d4-a716-446655440000",3  "fileName": "example.pdf",4  "approvalStatus": "approved",5  "uploaderId": null,6  "uploaderName": "Upload by email",7  "modifiedTime": "2026-04-09T14:20:30+09:00",8  "createdTime": "2026-04-09T12:00:00+09:00"9}