API リファレンス

REST API のエンドポイント、必要な権限、入力・応答と Webhook のスキーマを確認できます。

開発者ドキュメント

cart:write はカートの参照も含みます。カートは購入前の下書きのため、参照と編集を同じ権限で扱います。

エンドポイント

社名から法人番号を調べる

GET/api/v1/companies/search

basic は有効な API キーの基本権限を表し、追加のスコープ指定は不要です。

必要な権限:基本権限(追加指定不要)

パラメータ

q(クエリ・必須)

string 1〜200 文字。社名または法人番号。

最小文字数:1

最大文字数:200

limit(クエリ・任意)

integer 1〜50、既定 20

最小値:1

最大値:50

cursor(クエリ・任意)

string 前回の nextCursor(数字のみ)

パターン:^[0-9]+$

応答

200

companies: Company[]・nextCursor: string | null。続きがなければ null。

application/json

object

companies 任意

array

配列の要素

参照先:Company

object

cn 任意

string 13 桁の法人番号(先頭 0 不可)

name 任意

string 社名

closed 任意

boolean 閉鎖法人か

prefecture 任意

string | null 都道府県

city 任意

string | null 市区町村

industry 任意

string | null 業種

capital 任意

string 資本金の表示値(未取得は —)

founded 任意

string 設立日または —

archiveDate 任意

string | null 提供できる履歴事項アーカイブの取得日時

recentArchive 任意

object | null 直近取得済みの場合の案内

reasonCode 任意

string recent_archive

acquiredOn 任意

string 取得日

message 任意

string 案内文

registrationReasonCode 任意

string | null registration_blocked:本日の取得が保留

registrationBlockedOn 任意

string | null 保留日

registrationWarning 任意

string | null 登記手続きに関する案内

signal 任意

object 登記受付の観測情報

state 任意

string | null receipt_after・receipt_near・no_receipt_in_covered・unverified

bureau 任意

string 局名の表示値

coveredThrough 任意

string 観測範囲の終了日または空文字

last_receipt_on 任意

string | null 観測した最新の登記受付日

acquiredByOwnOrg 任意

boolean 所属法人が最新取得した履歴があるか

reason 任意

string not_available・not_registered_corporation

entrustable 任意

boolean Web の取得代行を案内できるか

nextCursor 任意

string | null

400

400:検索語が空・長すぎる、limit・cursor が不正。検索機能が利用できない場合は 503。

application/json

参照先:Error

object

error 必須

string

403

API キーの認証・認可を通らない、または Origin ヘッダ付きの呼び出し

application/json

参照先:Error

object

error 必須

string

429

頻度上限。Retry-After に従って再試行。

ヘッダ

Retry-After

integer

application/json

参照先:Error

object

error 必須

string

503

サービスを利用できない

application/json

参照先:Error

object

error 必須

string

法人情報・アーカイブの有無を確認する

GET/api/v1/companies/{cn}

basic は有効な API キーの基本権限を表し、追加のスコープ指定は不要です。

必要な権限:基本権限(追加指定不要)

パラメータ

cn(パス・必須)

string 13 桁の法人番号(パス)

パターン:^[1-9][0-9]{12}$

応答

200

company: Company | null。該当する法人がなければ null。

application/json

object

company 任意

いずれかの型

参照先:Company

object

cn 任意

string 13 桁の法人番号(先頭 0 不可)

name 任意

string 社名

closed 任意

boolean 閉鎖法人か

prefecture 任意

string | null 都道府県

city 任意

string | null 市区町村

industry 任意

string | null 業種

capital 任意

string 資本金の表示値(未取得は —)

founded 任意

string 設立日または —

archiveDate 任意

string | null 提供できる履歴事項アーカイブの取得日時

recentArchive 任意

object | null 直近取得済みの場合の案内

reasonCode 任意

string recent_archive

acquiredOn 任意

string 取得日

message 任意

string 案内文

registrationReasonCode 任意

string | null registration_blocked:本日の取得が保留

registrationBlockedOn 任意

string | null 保留日

registrationWarning 任意

string | null 登記手続きに関する案内

signal 任意

object 登記受付の観測情報

state 任意

string | null receipt_after・receipt_near・no_receipt_in_covered・unverified

bureau 任意

string 局名の表示値

coveredThrough 任意

string 観測範囲の終了日または空文字

last_receipt_on 任意

string | null 観測した最新の登記受付日

acquiredByOwnOrg 任意

boolean 所属法人が最新取得した履歴があるか

reason 任意

string not_available・not_registered_corporation

entrustable 任意

boolean Web の取得代行を案内できるか

null

400

400:法人番号の形式が不正。

application/json

参照先:Error

object

error 必須

string

403

API キーの認証・認可を通らない、または Origin ヘッダ付きの呼び出し

application/json

参照先:Error

object

error 必須

string

429

頻度上限。Retry-After に従って再試行。

ヘッダ

Retry-After

integer

application/json

参照先:Error

object

error 必須

string

503

サービスを利用できない

application/json

参照先:Error

object

error 必須

string

見積を確認する

POST/api/v1/quote

basic は有効な API キーの基本権限を表し、追加のスコープ指定は不要です。

必要な権限:基本権限(追加指定不要)

リクエスト本文(必須)

application/json

object

cart 必須

array 最大 50 件

最大要素数:50

配列の要素

object

cn 必須

string 法人番号

choice 必須

string latest または new・archive。応答は new・archive・redownload

選択値:new・latest・archive

manual 任意

boolean 取得方法を明示指定するなら true

docType 任意

string history・closed。既定 history

documentId 任意

string 過去時点・閉鎖事項を選ぶ文書 UUID

forceNewClosed 任意

boolean 閉鎖事項を新規取得するか

track 任意

string provision・entrusted。購入申請は provision のみ。

settings 必須

object 見積条件

maxAgeDays 任意

number 30・90・180・365

unverified 任意

string archive・new

entrustedDeclaration 任意

object 取得代行の同意情報

termsVersion 任意

string 同意した取得代行約款の版

applyVouchers 任意

boolean 引換券を使う。既定 true

応答

200

Quote(下の見積の項目)。購入は実行しません。

application/json

参照先:Quote

object

lines 任意

array 見積明細

配列の要素

object

company 任意

上の法人情報 参照先:Company

object

cn 任意

string 13 桁の法人番号(先頭 0 不可)

name 任意

string 社名

closed 任意

boolean 閉鎖法人か

prefecture 任意

string | null 都道府県

city 任意

string | null 市区町村

industry 任意

string | null 業種

capital 任意

string 資本金の表示値(未取得は —)

founded 任意

string 設立日または —

archiveDate 任意

string | null 提供できる履歴事項アーカイブの取得日時

recentArchive 任意

object | null 直近取得済みの場合の案内

reasonCode 任意

string recent_archive

acquiredOn 任意

string 取得日

message 任意

string 案内文

registrationReasonCode 任意

string | null registration_blocked:本日の取得が保留

registrationBlockedOn 任意

string | null 保留日

registrationWarning 任意

string | null 登記手続きに関する案内

signal 任意

object 登記受付の観測情報

state 任意

string | null receipt_after・receipt_near・no_receipt_in_covered・unverified

bureau 任意

string 局名の表示値

coveredThrough 任意

string 観測範囲の終了日または空文字

last_receipt_on 任意

string | null 観測した最新の登記受付日

acquiredByOwnOrg 任意

boolean 所属法人が最新取得した履歴があるか

reason 任意

string not_available・not_registered_corporation

entrustable 任意

boolean Web の取得代行を案内できるか

choice 任意

string new・archive・redownload

選択値:new・archive・redownload

manual 任意

boolean 取得方法を明示指定したか

reason 任意

string 選定理由

reasonCode 任意

string | null recent_archive・registration_blocked・already_owned などの選定理由

acquiredOn 任意

string | null アーカイブ取得日

voucher 任意

boolean 引換券を使うか

amount 任意

number 明細金額(円)

unitAmount 任意

number 1 文書の単価(円)

authorizationAmount 任意

number | null 与信の上限額(円)

docType 任意

string history・closed

closedRecordRef 任意

string | null 閉鎖事項の参照値

quantityUncertain 任意

boolean 文書数が未確定か

track 任意

string provision・entrusted

freeRedownload 任意

boolean 権利があり無料で再取得できるか

documentId 任意

string | null 選択した文書 ID。archive・redownload の場合に返る。

timepointKind 任意

string | null latest・past・closed

headOffice 任意

string | null 選択時点の本店

requestedDocumentId 任意

string | null 指定された文書 ID

newCount 任意

number 最新取得件数

archiveCount 任意

number アーカイブ件数

vouchersUsed 任意

number 使用引換券数

total 任意

number 合計額(円)

authorizationTotal 任意

number 与信上限額(円)

estimatedVouchers 任意

number 発行見込みの引換券数

taxAmount 任意

number 内消費税(円)

consent 任意

object 承認時の見積照合値

authorizationTotal 任意

number 確認した与信上限額

linesHash 任意

string 確認した明細のハッシュ

monthly_remaining 任意

number 月間の残り取得可能数

monthly_reserved 任意

number 予約中の取得数

base_cap 任意

number 基本の月間上限

monthly_used 任意

number 月間使用済み数

monthly_cap 任意

number 月間上限数

prepaid_remaining 任意

number 現在有効な月間加算件数

entrustedSalesOpen 任意

boolean 取得代行の受付可否

entrustedSalesTestAllowed 任意

boolean 取得代行のテスト受付可否

400

400:cart が配列でない・50 件を超える、settings がオブジェクトでない、applyVouchers が boolean でない。

application/json

参照先:Error

object

error 必須

string

403

API キーの認証・認可を通らない、または Origin ヘッダ付きの呼び出し

application/json

参照先:Error

object

error 必須

string

429

頻度上限。Retry-After に従って再試行。

ヘッダ

Retry-After

integer

application/json

参照先:Error

object

error 必須

string

503

サービスを利用できない

application/json

参照先:Error

object

error 必須

string

API カートを取得する

GET/api/v1/cart

cart:write はカートの参照も含みます。カートは購入前の下書きのため、参照と編集を同じ権限で扱います。

必要な権限:cart:write

パラメータ・リクエスト本文はありません。

応答

200

items: object[](cn: string・kind: new | archive・added_via_key_id: string・added_at: string・quote: Quote | null・error: string | null)。quote: Quote | null はカート全体の見積。提供できない明細は error=not_available。

application/json

参照先:Cart

object

items 任意

array API カートの品目

配列の要素

object

cn 任意

string 法人番号

kind 任意

string new・archive

added_via_key_id 任意

string 追加した API キーの UUID

added_at 任意

string 追加日時

quote 任意

この品目の見積

いずれかの型

参照先:Quote

object

lines 任意

array 見積明細

配列の要素

object

company 任意

上の法人情報 参照先:Company

object

cn 任意

string 13 桁の法人番号(先頭 0 不可)

name 任意

string 社名

closed 任意

boolean 閉鎖法人か

prefecture 任意

string | null 都道府県

city 任意

string | null 市区町村

industry 任意

string | null 業種

capital 任意

string 資本金の表示値(未取得は —)

founded 任意

string 設立日または —

archiveDate 任意

string | null 提供できる履歴事項アーカイブの取得日時

recentArchive 任意

object | null 直近取得済みの場合の案内

reasonCode 任意

string recent_archive

acquiredOn 任意

string 取得日

message 任意

string 案内文

registrationReasonCode 任意

string | null registration_blocked:本日の取得が保留

registrationBlockedOn 任意

string | null 保留日

registrationWarning 任意

string | null 登記手続きに関する案内

signal 任意

object 登記受付の観測情報

state 任意

string | null receipt_after・receipt_near・no_receipt_in_covered・unverified

bureau 任意

string 局名の表示値

coveredThrough 任意

string 観測範囲の終了日または空文字

last_receipt_on 任意

string | null 観測した最新の登記受付日

acquiredByOwnOrg 任意

boolean 所属法人が最新取得した履歴があるか

reason 任意

string not_available・not_registered_corporation

entrustable 任意

boolean Web の取得代行を案内できるか

choice 任意

string new・archive・redownload

選択値:new・archive・redownload

manual 任意

boolean 取得方法を明示指定したか

reason 任意

string 選定理由

reasonCode 任意

string | null recent_archive・registration_blocked・already_owned などの選定理由

acquiredOn 任意

string | null アーカイブ取得日

voucher 任意

boolean 引換券を使うか

amount 任意

number 明細金額(円)

unitAmount 任意

number 1 文書の単価(円)

authorizationAmount 任意

number | null 与信の上限額(円)

docType 任意

string history・closed

closedRecordRef 任意

string | null 閉鎖事項の参照値

quantityUncertain 任意

boolean 文書数が未確定か

track 任意

string provision・entrusted

freeRedownload 任意

boolean 権利があり無料で再取得できるか

documentId 任意

string | null 選択した文書 ID。archive・redownload の場合に返る。

timepointKind 任意

string | null latest・past・closed

headOffice 任意

string | null 選択時点の本店

requestedDocumentId 任意

string | null 指定された文書 ID

newCount 任意

number 最新取得件数

archiveCount 任意

number アーカイブ件数

vouchersUsed 任意

number 使用引換券数

total 任意

number 合計額(円)

authorizationTotal 任意

number 与信上限額(円)

estimatedVouchers 任意

number 発行見込みの引換券数

taxAmount 任意

number 内消費税(円)

consent 任意

object 承認時の見積照合値

authorizationTotal 任意

number 確認した与信上限額

linesHash 任意

string 確認した明細のハッシュ

monthly_remaining 任意

number 月間の残り取得可能数

monthly_reserved 任意

number 予約中の取得数

base_cap 任意

number 基本の月間上限

monthly_used 任意

number 月間使用済み数

monthly_cap 任意

number 月間上限数

prepaid_remaining 任意

number 現在有効な月間加算件数

entrustedSalesOpen 任意

boolean 取得代行の受付可否

entrustedSalesTestAllowed 任意

boolean 取得代行のテスト受付可否

null

error 任意

string | null 見積できない場合は not_available

quote 任意

カート全体の見積。見積できない場合は null

いずれかの型

参照先:Quote

object

lines 任意

array 見積明細

配列の要素

object

company 任意

上の法人情報 参照先:Company

object

cn 任意

string 13 桁の法人番号(先頭 0 不可)

name 任意

string 社名

closed 任意

boolean 閉鎖法人か

prefecture 任意

string | null 都道府県

city 任意

string | null 市区町村

industry 任意

string | null 業種

capital 任意

string 資本金の表示値(未取得は —)

founded 任意

string 設立日または —

archiveDate 任意

string | null 提供できる履歴事項アーカイブの取得日時

recentArchive 任意

object | null 直近取得済みの場合の案内

reasonCode 任意

string recent_archive

acquiredOn 任意

string 取得日

message 任意

string 案内文

registrationReasonCode 任意

string | null registration_blocked:本日の取得が保留

registrationBlockedOn 任意

string | null 保留日

registrationWarning 任意

string | null 登記手続きに関する案内

signal 任意

object 登記受付の観測情報

state 任意

string | null receipt_after・receipt_near・no_receipt_in_covered・unverified

bureau 任意

string 局名の表示値

coveredThrough 任意

string 観測範囲の終了日または空文字

last_receipt_on 任意

string | null 観測した最新の登記受付日

acquiredByOwnOrg 任意

boolean 所属法人が最新取得した履歴があるか

reason 任意

string not_available・not_registered_corporation

entrustable 任意

boolean Web の取得代行を案内できるか

choice 任意

string new・archive・redownload

選択値:new・archive・redownload

manual 任意

boolean 取得方法を明示指定したか

reason 任意

string 選定理由

reasonCode 任意

string | null recent_archive・registration_blocked・already_owned などの選定理由

acquiredOn 任意

string | null アーカイブ取得日

voucher 任意

boolean 引換券を使うか

amount 任意

number 明細金額(円)

unitAmount 任意

number 1 文書の単価(円)

authorizationAmount 任意

number | null 与信の上限額(円)

docType 任意

string history・closed

closedRecordRef 任意

string | null 閉鎖事項の参照値

quantityUncertain 任意

boolean 文書数が未確定か

track 任意

string provision・entrusted

freeRedownload 任意

boolean 権利があり無料で再取得できるか

documentId 任意

string | null 選択した文書 ID。archive・redownload の場合に返る。

timepointKind 任意

string | null latest・past・closed

headOffice 任意

string | null 選択時点の本店

requestedDocumentId 任意

string | null 指定された文書 ID

newCount 任意

number 最新取得件数

archiveCount 任意

number アーカイブ件数

vouchersUsed 任意

number 使用引換券数

total 任意

number 合計額(円)

authorizationTotal 任意

number 与信上限額(円)

estimatedVouchers 任意

number 発行見込みの引換券数

taxAmount 任意

number 内消費税(円)

consent 任意

object 承認時の見積照合値

authorizationTotal 任意

number 確認した与信上限額

linesHash 任意

string 確認した明細のハッシュ

monthly_remaining 任意

number 月間の残り取得可能数

monthly_reserved 任意

number 予約中の取得数

base_cap 任意

number 基本の月間上限

monthly_used 任意

number 月間使用済み数

monthly_cap 任意

number 月間上限数

prepaid_remaining 任意

number 現在有効な月間加算件数

entrustedSalesOpen 任意

boolean 取得代行の受付可否

entrustedSalesTestAllowed 任意

boolean 取得代行のテスト受付可否

null

403

API キーの認証・認可を通らない、または Origin ヘッダ付きの呼び出し

application/json

参照先:Error

object

error 必須

string

429

頻度上限。Retry-After に従って再試行。

ヘッダ

Retry-After

integer

application/json

参照先:Error

object

error 必須

string

503

サービスを利用できない

application/json

参照先:Error

object

error 必須

string

カートを空にする

DELETE/api/v1/cart

cart:write はカートの参照も含みます。カートは購入前の下書きのため、参照と編集を同じ権限で扱います。

必要な権限:cart:write

パラメータ・リクエスト本文はありません。

応答

200

removed: number(削除した件数)。

application/json

object

removed 任意

integer

403

API キーの認証・認可を通らない、または Origin ヘッダ付きの呼び出し

application/json

参照先:Error

object

error 必須

string

429

頻度上限。Retry-After に従って再試行。

ヘッダ

Retry-After

integer

application/json

参照先:Error

object

error 必須

string

503

サービスを利用できない

application/json

参照先:Error

object

error 必須

string

カートに追加する

POST/api/v1/cart/items

cart:write はカートの参照も含みます。カートは購入前の下書きのため、参照と編集を同じ権限で扱います。

必要な権限:cart:write

リクエスト本文(必須)

application/json

object

items 必須

array 1〜50 件

最小要素数:1

最大要素数:50

配列の要素

object

cn 必須

string 13 桁の法人番号

kind 必須

string latest または new・archive。latest は new の別名、応答は new

選択値:new・latest・archive

track 任意

string provision。取得代行は対象外。

応答

200

results: object[]。各要素は cn: string | null・kind: string | null・ok: boolean・status: added | already_in_cart | rejected・error: string | null(already_in_cart では省略)。error は invalid_item・entrusted_requires_web_terms・not_available・order_limit・monthly_cap。

application/json

参照先:CartResult

object

results 任意

array 指定品目ごとの追加結果

配列の要素

object

cn 任意

string | null 法人番号。不正入力では null の場合あり。

kind 任意

string | null 受理した種別。latest は new に正規化。

ok 任意

boolean 追加済み・すでに登録済みなら true

status 任意

string added・already_in_cart・rejected

error 任意

string | null invalid_item・entrusted_requires_web_terms・not_available・order_limit・monthly_cap。already_in_cart では項目なし。

400

400:items が配列でない・件数が範囲外。個別の追加結果は HTTP 200 の results で確認。

application/json

参照先:Error

object

error 必須

string

403

API キーの認証・認可を通らない、または Origin ヘッダ付きの呼び出し

application/json

参照先:Error

object

error 必須

string

429

頻度上限。Retry-After に従って再試行。

ヘッダ

Retry-After

integer

application/json

参照先:Error

object

error 必須

string

503

サービスを利用できない

application/json

参照先:Error

object

error 必須

string

カートから法人を削除する

DELETE/api/v1/cart/items/{cn}

cart:write はカートの参照も含みます。カートは購入前の下書きのため、参照と編集を同じ権限で扱います。

必要な権限:cart:write

パラメータ

cn(パス・必須)

string 法人番号(パス)

パターン:^[1-9][0-9]{12}$

kind(クエリ・任意)

string クエリ。new・archive。省略で両方削除。

応答

200

removed: number(削除した件数)。

application/json

object

removed 任意

integer

400

400:cn・kind の形式が不正。

application/json

参照先:Error

object

error 必須

string

403

API キーの認証・認可を通らない、または Origin ヘッダ付きの呼び出し

application/json

参照先:Error

object

error 必須

string

429

頻度上限。Retry-After に従って再試行。

ヘッダ

Retry-After

integer

application/json

参照先:Error

object

error 必須

string

503

サービスを利用できない

application/json

参照先:Error

object

error 必須

string

法人番号から購入申請する

POST/api/v1/purchase-requests

必要な権限:purchase

パラメータ

Idempotency-Key(ヘッダ・必須)

string ヘッダ。空白のみ不可、最大 200 文字。

パターン:\S

最小文字数:1

最大文字数:200

リクエスト本文(必須)

application/json

object

追加項目:false

items 任意

array 1〜50 件。from_cart と排他。

最小要素数:1

最大要素数:50

配列の要素

object

cn 必須

string 13 桁の法人番号

kind 必須

string latest・archive

選択値:latest・archive

track 任意

string provision のみ

from_cart 任意

boolean true で API カートを固定して申請。items は指定しない。

固定値:true

いずれか一つの型

必須:items

必須:from_cart

応答

200

request_id: string・status: pending_approval | ordered | cancelled・order_ids: string[](ordered のみ)・reason: string(値があるときのみ)。HTTP 200。

application/json

参照先:PurchaseCreated

object

request_id 必須

string

形式:uuid

status 必須

string

選択値:pending_approval・ordered・cancelled

order_ids 任意

array

配列の要素

string

形式:uuid

reason 任意

string

選択値:expired・terms_changed・auto_approval_not_retried・entrusted_requires_web_terms・auto_setting_owner_inactive・auto_purchase_disabled・auto_saved_card_required・auto_limit_exceeded・auto_payment_requires_action・auto_payment_declined・permission_required

400

400:冪等キーなし・空入力・未知のトップレベル項目・items と from_cart の併用。409:同じキーで別の内容。422:items_rejected。

application/json

参照先:Error

object

error 必須

string

403

API キーの認証・認可を通らない、または Origin ヘッダ付きの呼び出し

application/json

参照先:Error

object

error 必須

string

409

冪等キーの内容不一致、または操作できない申請状態

application/json

参照先:Error

object

error 必須

string

422

品目を拒否。申請全体を作成せず items に理由を返す。

application/json

object

error 任意

固定値:items_rejected

items 任意

array

配列の要素

object

cn 任意

string | null

kind 任意

string | null

reason 任意

string

選択値:invalid_item・entrusted_requires_web_terms・not_available・already_owned・duplicate_company・order_limit・monthly_cap・daily_limit

429

頻度上限。Retry-After に従って再試行。

ヘッダ

Retry-After

integer

application/json

参照先:Error

object

error 必須

string

503

サービスを利用できない

application/json

参照先:Error

object

error 必須

string

このキーの申請を一覧する

GET/api/v1/purchase-requests

必要な権限:purchase

パラメータ・リクエスト本文はありません。

応答

200

requests: PurchaseRequest[]。新しい順、最大 100 件。このキーで作成した申請のみ。

application/json

object

requests 任意

array

配列の要素

参照先:PurchaseRequest

object

request_id 任意

string 申請 UUID

status 任意

string pending_approval・approved・rejected・expired・cancelled

選択値:pending_approval・approved・rejected・expired・cancelled

amount_jpy 任意

number 申請時の与信上限額(円)

expires_at 任意

string 承認期限

created_at 任意

string 作成日時

approval_url 任意

string Web 承認ページの絶対 URL

items 任意

array 申請内容

配列の要素

object

cn 任意

string 法人番号

kind 任意

string latest・archive

track 任意

string provision

order_ids 任意

array 承認後の注文 UUID

配列の要素

string

orders 任意

array 決済状況

配列の要素

object

order_id 任意

string 注文 UUID

payment_status 任意

string pending_authorization・authorized・captured・capture_failed・canceled

reapplication_required 任意

boolean 取消済みで再申請が必要か

order_items 任意

array 文書の取得状況

配列の要素

object

order_id 任意

string 注文 UUID

cn 任意

string 法人番号

kind 任意

string latest・archive

status 任意

string processing・available・unavailable

document_id 任意

string PDF と同じ提供判定を通った権利付与済み明細にのみ返す文書 UUID

auto_approved 任意

boolean 承認なし購入を適用したか

auto_payment_ready 任意

boolean 自動決済の開始準備ができたか

reason 任意

string | null 承認なし購入を適用できない理由

403

API キーの認証・認可を通らない、または Origin ヘッダ付きの呼び出し

application/json

参照先:Error

object

error 必須

string

429

頻度上限。Retry-After に従って再試行。

ヘッダ

Retry-After

integer

application/json

参照先:Error

object

error 必須

string

503

サービスを利用できない

application/json

参照先:Error

object

error 必須

string

申請・決済・取得の状態を確認する

GET/api/v1/purchase-requests/{id}

必要な権限:purchase

パラメータ

id(パス・必須)

string 申請 UUID(パス)

形式:uuid

応答

200

PurchaseRequest(下の申請の項目)。作成時の ordered はここでは approved。

application/json

参照先:PurchaseRequest

object

request_id 任意

string 申請 UUID

status 任意

string pending_approval・approved・rejected・expired・cancelled

選択値:pending_approval・approved・rejected・expired・cancelled

amount_jpy 任意

number 申請時の与信上限額(円)

expires_at 任意

string 承認期限

created_at 任意

string 作成日時

approval_url 任意

string Web 承認ページの絶対 URL

items 任意

array 申請内容

配列の要素

object

cn 任意

string 法人番号

kind 任意

string latest・archive

track 任意

string provision

order_ids 任意

array 承認後の注文 UUID

配列の要素

string

orders 任意

array 決済状況

配列の要素

object

order_id 任意

string 注文 UUID

payment_status 任意

string pending_authorization・authorized・captured・capture_failed・canceled

reapplication_required 任意

boolean 取消済みで再申請が必要か

order_items 任意

array 文書の取得状況

配列の要素

object

order_id 任意

string 注文 UUID

cn 任意

string 法人番号

kind 任意

string latest・archive

status 任意

string processing・available・unavailable

document_id 任意

string PDF と同じ提供判定を通った権利付与済み明細にのみ返す文書 UUID

auto_approved 任意

boolean 承認なし購入を適用したか

auto_payment_ready 任意

boolean 自動決済の開始準備ができたか

reason 任意

string | null 承認なし購入を適用できない理由

400

400:UUID が不正。403:このキーの申請ではない。

application/json

参照先:Error

object

error 必須

string

403

API キーの認証・認可を通らない、または Origin ヘッダ付きの呼び出し

application/json

参照先:Error

object

error 必須

string

429

頻度上限。Retry-After に従って再試行。

ヘッダ

Retry-After

integer

application/json

参照先:Error

object

error 必須

string

503

サービスを利用できない

application/json

参照先:Error

object

error 必須

string

承認待ち申請を取り消す

DELETE/api/v1/purchase-requests/{id}

必要な権限:purchase

パラメータ

id(パス・必須)

string 申請 UUID(パス)

形式:uuid

応答

200

PurchaseRequest。status=cancelled。期限を過ぎていた場合は expired。決済済み注文の取消 API ではありません。

application/json

参照先:PurchaseRequest

object

request_id 任意

string 申請 UUID

status 任意

string pending_approval・approved・rejected・expired・cancelled

選択値:pending_approval・approved・rejected・expired・cancelled

amount_jpy 任意

number 申請時の与信上限額(円)

expires_at 任意

string 承認期限

created_at 任意

string 作成日時

approval_url 任意

string Web 承認ページの絶対 URL

items 任意

array 申請内容

配列の要素

object

cn 任意

string 法人番号

kind 任意

string latest・archive

track 任意

string provision

order_ids 任意

array 承認後の注文 UUID

配列の要素

string

orders 任意

array 決済状況

配列の要素

object

order_id 任意

string 注文 UUID

payment_status 任意

string pending_authorization・authorized・captured・capture_failed・canceled

reapplication_required 任意

boolean 取消済みで再申請が必要か

order_items 任意

array 文書の取得状況

配列の要素

object

order_id 任意

string 注文 UUID

cn 任意

string 法人番号

kind 任意

string latest・archive

status 任意

string processing・available・unavailable

document_id 任意

string PDF と同じ提供判定を通った権利付与済み明細にのみ返す文書 UUID

auto_approved 任意

boolean 承認なし購入を適用したか

auto_payment_ready 任意

boolean 自動決済の開始準備ができたか

reason 任意

string | null 承認なし購入を適用できない理由

400

400:UUID が不正。409:承認待ち以外など取消できない状態。

application/json

参照先:Error

object

error 必須

string

403

API キーの認証・認可を通らない、または Origin ヘッダ付きの呼び出し

application/json

参照先:Error

object

error 必須

string

409

冪等キーの内容不一致、または操作できない申請状態

application/json

参照先:Error

object

error 必須

string

429

頻度上限。Retry-After に従って再試行。

ヘッダ

Retry-After

integer

application/json

参照先:Error

object

error 必須

string

503

サービスを利用できない

application/json

参照先:Error

object

error 必須

string

文書の解析データを取得する

GET/api/v1/documents/{id}/data

必要な権限:data:read

パラメータ

id(パス・必須)

string 文書 UUID(パス)。注文・明細 ID と異なります。

形式:uuid

応答

200

rows・excluded。文書と解析データの項目は下記。

application/json

参照先:DocumentData

object

rows 任意

array 提供可能な文書

配列の要素

object

document_id 任意

string 文書 ID

corporate_number 任意

string 法人番号

file_name 任意

string 既定の PDF 名

data 任意

参照先:ParsedData

object

doc_type 任意

string | null history・closed

trade_name 任意

string | null 商号

corporate_number 任意

string | null 法人番号

company_number 任意

string | null 会社法人等番号

established_on 任意

string | null 設立日

acquired_at 任意

string | null 取得日時

representative_name 任意

string 役員から組み立てた代表者名

officer_count 任意

number | null 役員の人数

last_changed_on 任意

string | null 履歴内の最新変更日

parse_status 任意

string | null 解析状況

warnings 任意

string | null 解析上の注意

capital_jpy 任意

number | null 資本金(円)

issued_shares 任意

number | null 発行済株式数

share_transfer_restriction 任意

string | null 株式譲渡制限

purposes 任意

array 目的

配列の要素

string

officers 任意

array

配列の要素

object

name 任意

string | null 役員名

title 任意

string | null 役職

appointed_on 任意

string | null 就任日

status 任意

string | null 役員の状態

branches 任意

array

配列の要素

object

name 任意

string | null 支店名

history 任意

array

配列の要素

object

kind 任意

string | null 履歴の種類

changed_on 任意

string | null 変更日(initial の場合あり)

registered_on 任意

string | null 登記日

before 任意

string | null 変更前

after 任意

string | null 変更後

summary 任意

string | null 変更の要約

excluded 任意

array 提供対象から除いた文書

配列の要素

object

document_id 任意

string 文書 ID

reason 任意

string 除外理由

400

400:文書 ID の形式が不正。個別の提供可否は excluded を確認。

application/json

参照先:Error

object

error 必須

string

403

API キーの認証・認可を通らない、または Origin ヘッダ付きの呼び出し

application/json

参照先:Error

object

error 必須

string

429

頻度上限。Retry-After に従って再試行。

ヘッダ

Retry-After

integer

application/json

参照先:Error

object

error 必須

string

503

サービスを利用できない

application/json

参照先:Error

object

error 必須

string

登記情報の PDF を取得する

GET/api/v1/documents/{id}/pdf

必要な権限:pdf:read

パラメータ

id(パス・必須)

string 文書 UUID(パス)

形式:uuid

応答

200

application/pdf のバイナリ。Content-Disposition: attachment(filename と filename*)。Cache-Control: private, no-store。

application/pdf

string

形式:binary

400

400:ID が不正。403:権利・提供可否の確認・所属確認などの条件を満たさない。404:認可後にファイルが見つからない(Not found)。429:PDF の頻度上限。

application/json

参照先:Error

object

error 必須

string

403

API キーの認証・認可を通らない、または Origin ヘッダ付きの呼び出し

application/json

参照先:Error

object

error 必須

string

404

認可後の登記情報の PDF が見つからない

application/json

参照先:Error

object

error 必須

string

429

頻度上限。Retry-After に従って再試行。

ヘッダ

Retry-After

integer

application/json

参照先:Error

object

error 必須

string

503

サービスを利用できない

application/json

参照先:Error

object

error 必須

string

Webhook イベント

order_item.available

明細が確定し、現在提供可能になったときに通知します。

設定した通知先への POST 通知です。x-required-scope の none は受信に API キー権限が不要なことを示します。署名を元の本文バイト列で検証し、送信時刻との差を 5 分以内に制限してください。Toki-Webhook-Id を少なくとも 24 時間保持して重複を排除します。

必要な権限:API キー権限は不要

パラメータ

Toki-Webhook-Id(ヘッダ・必須)

配信イベントの UUID。テスト時もヘッダの実イベント ID で重複排除します。

string

形式:uuid

Toki-Webhook-Timestamp(ヘッダ・必須)

送信時の Unix 秒。

string

パターン:^[0-9]+$

Toki-Webhook-Signature(ヘッダ・必須)

v1= + HMAC-SHA256(secret, timestamp + "." + raw_body) の小文字 16 進数。secret は UTF-8 で使用します。

string

パターン:^v1=[0-9a-f]{64}$

リクエスト本文(必須)

application/json

object

event_id 必須

string イベント UUID。テスト本文はゼロ UUID

形式:uuid

type 必須

string イベント名

選択値:order_item.available

occurred_at 必須

string イベント発生日時(JST、ISO 8601)

形式:date-time

order_id 必須

string 注文 UUID。注文イベント・auto_purchase.executed・document.pdf

形式:uuid

item_id 必須

string 明細 UUID。order_item.available・document.pdf。

形式:uuid

counts 必須

object 注文・申請イベントの件数

items 必須

integer 申請系は申請品目数、available は当該 1 明細、completed は注文の対象明細全体、followup は先に登記完了待ちだった対象のみ

最小値:0

acquired 必須

integer 取得できた数。注文イベントのみ。

最小値:0

registration 必須

integer 登記完了待ち数。注文イベントのみ。

最小値:0

failed 必須

integer 取得できなかった数。注文イベントのみ。

最小値:0

test 任意

boolean テスト送信時のみ true。ping には付かない。

固定値:true

応答

2XX

署名検証後、イベントを永続化して受信を確認します。

order.completed

通常の処理が終了したときに通知します。登記完了待ちを含む場合があります。全件成功の意味ではありません。

設定した通知先への POST 通知です。x-required-scope の none は受信に API キー権限が不要なことを示します。署名を元の本文バイト列で検証し、送信時刻との差を 5 分以内に制限してください。Toki-Webhook-Id を少なくとも 24 時間保持して重複を排除します。

必要な権限:API キー権限は不要

パラメータ

Toki-Webhook-Id(ヘッダ・必須)

配信イベントの UUID。テスト時もヘッダの実イベント ID で重複排除します。

string

形式:uuid

Toki-Webhook-Timestamp(ヘッダ・必須)

送信時の Unix 秒。

string

パターン:^[0-9]+$

Toki-Webhook-Signature(ヘッダ・必須)

v1= + HMAC-SHA256(secret, timestamp + "." + raw_body) の小文字 16 進数。secret は UTF-8 で使用します。

string

パターン:^v1=[0-9a-f]{64}$

リクエスト本文(必須)

application/json

object

event_id 必須

string イベント UUID。テスト本文はゼロ UUID

形式:uuid

type 必須

string イベント名

選択値:order.completed

occurred_at 必須

string イベント発生日時(JST、ISO 8601)

形式:date-time

order_id 必須

string 注文 UUID。注文イベント・auto_purchase.executed・document.pdf

形式:uuid

counts 必須

object 注文・申請イベントの件数

items 必須

integer 申請系は申請品目数、available は当該 1 明細、completed は注文の対象明細全体、followup は先に登記完了待ちだった対象のみ

最小値:0

acquired 必須

integer 取得できた数。注文イベントのみ。

最小値:0

registration 必須

integer 登記完了待ち数。注文イベントのみ。

最小値:0

failed 必須

integer 取得できなかった数。注文イベントのみ。

最小値:0

test 任意

boolean テスト送信時のみ true。ping には付かない。

固定値:true

応答

2XX

署名検証後、イベントを永続化して受信を確認します。

order.registration_followup

order.completed で登記完了待ちだった対象の追跡がすべて終了したときに通知します。

設定した通知先への POST 通知です。x-required-scope の none は受信に API キー権限が不要なことを示します。署名を元の本文バイト列で検証し、送信時刻との差を 5 分以内に制限してください。Toki-Webhook-Id を少なくとも 24 時間保持して重複を排除します。

必要な権限:API キー権限は不要

パラメータ

Toki-Webhook-Id(ヘッダ・必須)

配信イベントの UUID。テスト時もヘッダの実イベント ID で重複排除します。

string

形式:uuid

Toki-Webhook-Timestamp(ヘッダ・必須)

送信時の Unix 秒。

string

パターン:^[0-9]+$

Toki-Webhook-Signature(ヘッダ・必須)

v1= + HMAC-SHA256(secret, timestamp + "." + raw_body) の小文字 16 進数。secret は UTF-8 で使用します。

string

パターン:^v1=[0-9a-f]{64}$

リクエスト本文(必須)

application/json

object

event_id 必須

string イベント UUID。テスト本文はゼロ UUID

形式:uuid

type 必須

string イベント名

選択値:order.registration_followup

occurred_at 必須

string イベント発生日時(JST、ISO 8601)

形式:date-time

order_id 必須

string 注文 UUID。注文イベント・auto_purchase.executed・document.pdf

形式:uuid

counts 必須

object 注文・申請イベントの件数

items 必須

integer 申請系は申請品目数、available は当該 1 明細、completed は注文の対象明細全体、followup は先に登記完了待ちだった対象のみ

最小値:0

acquired 必須

integer 取得できた数。注文イベントのみ。

最小値:0

registration 必須

integer 登記完了待ち数。注文イベントのみ。

最小値:0

failed 必須

integer 取得できなかった数。注文イベントのみ。

最小値:0

test 任意

boolean テスト送信時のみ true。ping には付かない。

固定値:true

応答

2XX

署名検証後、イベントを永続化して受信を確認します。

purchase_request.pending_approval

承認待ち申請を作成したとき、または自動決済に追加認証が必要で承認待ちへ戻ったときに通知します。

設定した通知先への POST 通知です。x-required-scope の none は受信に API キー権限が不要なことを示します。署名を元の本文バイト列で検証し、送信時刻との差を 5 分以内に制限してください。Toki-Webhook-Id を少なくとも 24 時間保持して重複を排除します。

必要な権限:API キー権限は不要

パラメータ

Toki-Webhook-Id(ヘッダ・必須)

配信イベントの UUID。テスト時もヘッダの実イベント ID で重複排除します。

string

形式:uuid

Toki-Webhook-Timestamp(ヘッダ・必須)

送信時の Unix 秒。

string

パターン:^[0-9]+$

Toki-Webhook-Signature(ヘッダ・必須)

v1= + HMAC-SHA256(secret, timestamp + "." + raw_body) の小文字 16 進数。secret は UTF-8 で使用します。

string

パターン:^v1=[0-9a-f]{64}$

リクエスト本文(必須)

application/json

object

event_id 必須

string イベント UUID。テスト本文はゼロ UUID

形式:uuid

type 必須

string イベント名

選択値:purchase_request.pending_approval

occurred_at 必須

string イベント発生日時(JST、ISO 8601)

形式:date-time

purchase_request_id 必須

string 申請 UUID。申請イベントと auto_purchase.executed

形式:uuid

counts 必須

object 注文・申請イベントの件数

items 必須

integer 申請系は申請品目数、available は当該 1 明細、completed は注文の対象明細全体、followup は先に登記完了待ちだった対象のみ

最小値:0

amount_jpy 必須

integer 申請時の上限額(円)。申請イベントと auto_purchase.executed

最小値:0

test 任意

boolean テスト送信時のみ true。ping には付かない。

固定値:true

応答

2XX

署名検証後、イベントを永続化して受信を確認します。

purchase_request.approved

メンバーが Web で承認したときに通知します。決済・取得完了ではありません。承認なし購入で自動承認された場合はこのイベントではなく auto_purchase.executed が届きます。

設定した通知先への POST 通知です。x-required-scope の none は受信に API キー権限が不要なことを示します。署名を元の本文バイト列で検証し、送信時刻との差を 5 分以内に制限してください。Toki-Webhook-Id を少なくとも 24 時間保持して重複を排除します。

必要な権限:API キー権限は不要

パラメータ

Toki-Webhook-Id(ヘッダ・必須)

配信イベントの UUID。テスト時もヘッダの実イベント ID で重複排除します。

string

形式:uuid

Toki-Webhook-Timestamp(ヘッダ・必須)

送信時の Unix 秒。

string

パターン:^[0-9]+$

Toki-Webhook-Signature(ヘッダ・必須)

v1= + HMAC-SHA256(secret, timestamp + "." + raw_body) の小文字 16 進数。secret は UTF-8 で使用します。

string

パターン:^v1=[0-9a-f]{64}$

リクエスト本文(必須)

application/json

object

event_id 必須

string イベント UUID。テスト本文はゼロ UUID

形式:uuid

type 必須

string イベント名

選択値:purchase_request.approved

occurred_at 必須

string イベント発生日時(JST、ISO 8601)

形式:date-time

purchase_request_id 必須

string 申請 UUID。申請イベントと auto_purchase.executed

形式:uuid

counts 必須

object 注文・申請イベントの件数

items 必須

integer 申請系は申請品目数、available は当該 1 明細、completed は注文の対象明細全体、followup は先に登記完了待ちだった対象のみ

最小値:0

amount_jpy 必須

integer 申請時の上限額(円)。申請イベントと auto_purchase.executed

最小値:0

test 任意

boolean テスト送信時のみ true。ping には付かない。

固定値:true

応答

2XX

署名検証後、イベントを永続化して受信を確認します。

purchase_request.rejected

承認待ち申請が却下または申請キーで取消されたときに通知します。

設定した通知先への POST 通知です。x-required-scope の none は受信に API キー権限が不要なことを示します。署名を元の本文バイト列で検証し、送信時刻との差を 5 分以内に制限してください。Toki-Webhook-Id を少なくとも 24 時間保持して重複を排除します。

必要な権限:API キー権限は不要

パラメータ

Toki-Webhook-Id(ヘッダ・必須)

配信イベントの UUID。テスト時もヘッダの実イベント ID で重複排除します。

string

形式:uuid

Toki-Webhook-Timestamp(ヘッダ・必須)

送信時の Unix 秒。

string

パターン:^[0-9]+$

Toki-Webhook-Signature(ヘッダ・必須)

v1= + HMAC-SHA256(secret, timestamp + "." + raw_body) の小文字 16 進数。secret は UTF-8 で使用します。

string

パターン:^v1=[0-9a-f]{64}$

リクエスト本文(必須)

application/json

object

event_id 必須

string イベント UUID。テスト本文はゼロ UUID

形式:uuid

type 必須

string イベント名

選択値:purchase_request.rejected

occurred_at 必須

string イベント発生日時(JST、ISO 8601)

形式:date-time

purchase_request_id 必須

string 申請 UUID。申請イベントと auto_purchase.executed

形式:uuid

counts 必須

object 注文・申請イベントの件数

items 必須

integer 申請系は申請品目数、available は当該 1 明細、completed は注文の対象明細全体、followup は先に登記完了待ちだった対象のみ

最小値:0

amount_jpy 必須

integer 申請時の上限額(円)。申請イベントと auto_purchase.executed

最小値:0

test 任意

boolean テスト送信時のみ true。ping には付かない。

固定値:true

応答

2XX

署名検証後、イベントを永続化して受信を確認します。

purchase_request.expired

承認待ちの申請が期限切れなどで失効したときに通知します。

設定した通知先への POST 通知です。x-required-scope の none は受信に API キー権限が不要なことを示します。署名を元の本文バイト列で検証し、送信時刻との差を 5 分以内に制限してください。Toki-Webhook-Id を少なくとも 24 時間保持して重複を排除します。

必要な権限:API キー権限は不要

パラメータ

Toki-Webhook-Id(ヘッダ・必須)

配信イベントの UUID。テスト時もヘッダの実イベント ID で重複排除します。

string

形式:uuid

Toki-Webhook-Timestamp(ヘッダ・必須)

送信時の Unix 秒。

string

パターン:^[0-9]+$

Toki-Webhook-Signature(ヘッダ・必須)

v1= + HMAC-SHA256(secret, timestamp + "." + raw_body) の小文字 16 進数。secret は UTF-8 で使用します。

string

パターン:^v1=[0-9a-f]{64}$

リクエスト本文(必須)

application/json

object

event_id 必須

string イベント UUID。テスト本文はゼロ UUID

形式:uuid

type 必須

string イベント名

選択値:purchase_request.expired

occurred_at 必須

string イベント発生日時(JST、ISO 8601)

形式:date-time

purchase_request_id 必須

string 申請 UUID。申請イベントと auto_purchase.executed

形式:uuid

counts 必須

object 注文・申請イベントの件数

items 必須

integer 申請系は申請品目数、available は当該 1 明細、completed は注文の対象明細全体、followup は先に登記完了待ちだった対象のみ

最小値:0

amount_jpy 必須

integer 申請時の上限額(円)。申請イベントと auto_purchase.executed

最小値:0

test 任意

boolean テスト送信時のみ true。ping には付かない。

固定値:true

応答

2XX

署名検証後、イベントを永続化して受信を確認します。

auto_purchase.executed

承認なし購入の全注文で与信が確定したときに通知します。PDF の取得完了通知ではありません。order_id は代表の 1 注文です。

設定した通知先への POST 通知です。x-required-scope の none は受信に API キー権限が不要なことを示します。署名を元の本文バイト列で検証し、送信時刻との差を 5 分以内に制限してください。Toki-Webhook-Id を少なくとも 24 時間保持して重複を排除します。

必要な権限:API キー権限は不要

パラメータ

Toki-Webhook-Id(ヘッダ・必須)

配信イベントの UUID。テスト時もヘッダの実イベント ID で重複排除します。

string

形式:uuid

Toki-Webhook-Timestamp(ヘッダ・必須)

送信時の Unix 秒。

string

パターン:^[0-9]+$

Toki-Webhook-Signature(ヘッダ・必須)

v1= + HMAC-SHA256(secret, timestamp + "." + raw_body) の小文字 16 進数。secret は UTF-8 で使用します。

string

パターン:^v1=[0-9a-f]{64}$

リクエスト本文(必須)

application/json

object

event_id 必須

string イベント UUID。テスト本文はゼロ UUID

形式:uuid

type 必須

string イベント名

選択値:auto_purchase.executed

occurred_at 必須

string イベント発生日時(JST、ISO 8601)

形式:date-time

order_id 必須

string 注文 UUID。注文イベント・auto_purchase.executed・document.pdf

形式:uuid

purchase_request_id 必須

string 申請 UUID。申請イベントと auto_purchase.executed

形式:uuid

counts 必須

object 注文・申請イベントの件数

items 必須

integer 申請系は申請品目数、available は当該 1 明細、completed は注文の対象明細全体、followup は先に登記完了待ちだった対象のみ

最小値:0

amount_jpy 必須

integer 申請時の上限額(円)。申請イベントと auto_purchase.executed

最小値:0

test 任意

boolean テスト送信時のみ true。ping には付かない。

固定値:true

応答

2XX

署名検証後、イベントを永続化して受信を確認します。

webhook.ping

通知先の登録・URL 変更・疎通の再確認時に送信します。購読イベントには含めません。

設定した通知先への POST 通知です。x-required-scope の none は受信に API キー権限が不要なことを示します。署名を元の本文バイト列で検証し、送信時刻との差を 5 分以内に制限してください。Toki-Webhook-Id を少なくとも 24 時間保持して重複を排除します。

必要な権限:API キー権限は不要

パラメータ

Toki-Webhook-Id(ヘッダ・必須)

配信イベントの UUID。テスト時もヘッダの実イベント ID で重複排除します。

string

形式:uuid

Toki-Webhook-Timestamp(ヘッダ・必須)

送信時の Unix 秒。

string

パターン:^[0-9]+$

Toki-Webhook-Signature(ヘッダ・必須)

v1= + HMAC-SHA256(secret, timestamp + "." + raw_body) の小文字 16 進数。secret は UTF-8 で使用します。

string

パターン:^v1=[0-9a-f]{64}$

リクエスト本文(必須)

application/json

object

event_id 必須

string イベント UUID。テスト本文はゼロ UUID

形式:uuid

type 必須

string イベント名

選択値:webhook.ping

occurred_at 必須

string イベント発生日時(JST、ISO 8601)

形式:date-time

応答

2XX

署名検証後、イベントを永続化して受信を確認します。

document.pdf

PDF 配信が有効で、両方の同意が現行版の通知先に、明細が提供可能になった時点で送ります。検出済みの明細は、あとから有効化しても配信対象に追加しません。

設定した通知先への POST 通知です。x-required-scope の none は受信に API キー権限が不要なことを示します。署名を元の本文バイト列で検証し、送信時刻との差を 5 分以内に制限してください。Toki-Webhook-Id を少なくとも 24 時間保持して重複を排除します。

必要な権限:API キー権限は不要

パラメータ

Toki-Webhook-Id(ヘッダ・必須)

配信イベントの UUID。テスト時もヘッダの実イベント ID で重複排除します。

string

形式:uuid

Toki-Webhook-Timestamp(ヘッダ・必須)

送信時の Unix 秒。

string

パターン:^[0-9]+$

Toki-Webhook-Signature(ヘッダ・必須)

v1= + HMAC-SHA256(secret, timestamp + "." + raw_body) の小文字 16 進数。secret は UTF-8 で使用します。

string

パターン:^v1=[0-9a-f]{64}$

リクエスト本文(必須)

application/json

object

event_id 必須

string イベント UUID。テスト本文はゼロ UUID

形式:uuid

type 必須

string イベント名

選択値:document.pdf

occurred_at 必須

string イベント発生日時(JST、ISO 8601)

形式:date-time

order_id 必須

string 注文 UUID。注文イベント・auto_purchase.executed・document.pdf

形式:uuid

item_id 必須

string 明細 UUID。order_item.available・document.pdf。

形式:uuid

test 任意

boolean テスト送信時のみ true。ping には付かない。

固定値:true

document_id 必須

string document.pdf:文書 UUID

形式:uuid

file_name 必須

string document.pdf:REST の既定名と同じ、取得日(JST)_商号_種別.pdf

content_type 必須

string document.pdf:application/pdf

選択値:application/pdf

size_bytes 必須

integer document.pdf:Base64 復号後の PDF バイト数。最大 10 MiB(10,485,760 bytes)

最小値:1

最大値:10485760

sha256 必須

string document.pdf:復号後の PDF の SHA-256、小文字 16 進数

パターン:^[0-9a-f]{64}$

pdf_base64 必須

string document.pdf:PDF の標準 Base64。JSON 本文は約 4/3 倍になります。

エンコーディング:base64

メディア型:application/pdf

応答

2XX

署名検証後、イベントを永続化して受信を確認します。

スキーマ一覧

Company

object

cn 任意

string 13 桁の法人番号(先頭 0 不可)

name 任意

string 社名

closed 任意

boolean 閉鎖法人か

prefecture 任意

string | null 都道府県

city 任意

string | null 市区町村

industry 任意

string | null 業種

capital 任意

string 資本金の表示値(未取得は —)

founded 任意

string 設立日または —

archiveDate 任意

string | null 提供できる履歴事項アーカイブの取得日時

recentArchive 任意

object | null 直近取得済みの場合の案内

reasonCode 任意

string recent_archive

acquiredOn 任意

string 取得日

message 任意

string 案内文

registrationReasonCode 任意

string | null registration_blocked:本日の取得が保留

registrationBlockedOn 任意

string | null 保留日

registrationWarning 任意

string | null 登記手続きに関する案内

signal 任意

object 登記受付の観測情報

state 任意

string | null receipt_after・receipt_near・no_receipt_in_covered・unverified

bureau 任意

string 局名の表示値

coveredThrough 任意

string 観測範囲の終了日または空文字

last_receipt_on 任意

string | null 観測した最新の登記受付日

acquiredByOwnOrg 任意

boolean 所属法人が最新取得した履歴があるか

reason 任意

string not_available・not_registered_corporation

entrustable 任意

boolean Web の取得代行を案内できるか

Quote

object

lines 任意

array 見積明細

配列の要素

object

company 任意

上の法人情報 参照先:Company

object

cn 任意

string 13 桁の法人番号(先頭 0 不可)

name 任意

string 社名

closed 任意

boolean 閉鎖法人か

prefecture 任意

string | null 都道府県

city 任意

string | null 市区町村

industry 任意

string | null 業種

capital 任意

string 資本金の表示値(未取得は —)

founded 任意

string 設立日または —

archiveDate 任意

string | null 提供できる履歴事項アーカイブの取得日時

recentArchive 任意

object | null 直近取得済みの場合の案内

reasonCode 任意

string recent_archive

acquiredOn 任意

string 取得日

message 任意

string 案内文

registrationReasonCode 任意

string | null registration_blocked:本日の取得が保留

registrationBlockedOn 任意

string | null 保留日

registrationWarning 任意

string | null 登記手続きに関する案内

signal 任意

object 登記受付の観測情報

state 任意

string | null receipt_after・receipt_near・no_receipt_in_covered・unverified

bureau 任意

string 局名の表示値

coveredThrough 任意

string 観測範囲の終了日または空文字

last_receipt_on 任意

string | null 観測した最新の登記受付日

acquiredByOwnOrg 任意

boolean 所属法人が最新取得した履歴があるか

reason 任意

string not_available・not_registered_corporation

entrustable 任意

boolean Web の取得代行を案内できるか

choice 任意

string new・archive・redownload

選択値:new・archive・redownload

manual 任意

boolean 取得方法を明示指定したか

reason 任意

string 選定理由

reasonCode 任意

string | null recent_archive・registration_blocked・already_owned などの選定理由

acquiredOn 任意

string | null アーカイブ取得日

voucher 任意

boolean 引換券を使うか

amount 任意

number 明細金額(円)

unitAmount 任意

number 1 文書の単価(円)

authorizationAmount 任意

number | null 与信の上限額(円)

docType 任意

string history・closed

closedRecordRef 任意

string | null 閉鎖事項の参照値

quantityUncertain 任意

boolean 文書数が未確定か

track 任意

string provision・entrusted

freeRedownload 任意

boolean 権利があり無料で再取得できるか

documentId 任意

string | null 選択した文書 ID。archive・redownload の場合に返る。

timepointKind 任意

string | null latest・past・closed

headOffice 任意

string | null 選択時点の本店

requestedDocumentId 任意

string | null 指定された文書 ID

newCount 任意

number 最新取得件数

archiveCount 任意

number アーカイブ件数

vouchersUsed 任意

number 使用引換券数

total 任意

number 合計額(円)

authorizationTotal 任意

number 与信上限額(円)

estimatedVouchers 任意

number 発行見込みの引換券数

taxAmount 任意

number 内消費税(円)

consent 任意

object 承認時の見積照合値

authorizationTotal 任意

number 確認した与信上限額

linesHash 任意

string 確認した明細のハッシュ

monthly_remaining 任意

number 月間の残り取得可能数

monthly_reserved 任意

number 予約中の取得数

base_cap 任意

number 基本の月間上限

monthly_used 任意

number 月間使用済み数

monthly_cap 任意

number 月間上限数

prepaid_remaining 任意

number 現在有効な月間加算件数

entrustedSalesOpen 任意

boolean 取得代行の受付可否

entrustedSalesTestAllowed 任意

boolean 取得代行のテスト受付可否

Cart

object

items 任意

array API カートの品目

配列の要素

object

cn 任意

string 法人番号

kind 任意

string new・archive

added_via_key_id 任意

string 追加した API キーの UUID

added_at 任意

string 追加日時

quote 任意

この品目の見積

いずれかの型

参照先:Quote

object

lines 任意

array 見積明細

配列の要素

object

company 任意

上の法人情報 参照先:Company

object

cn 任意

string 13 桁の法人番号(先頭 0 不可)

name 任意

string 社名

closed 任意

boolean 閉鎖法人か

prefecture 任意

string | null 都道府県

city 任意

string | null 市区町村

industry 任意

string | null 業種

capital 任意

string 資本金の表示値(未取得は —)

founded 任意

string 設立日または —

archiveDate 任意

string | null 提供できる履歴事項アーカイブの取得日時

recentArchive 任意

object | null 直近取得済みの場合の案内

reasonCode 任意

string recent_archive

acquiredOn 任意

string 取得日

message 任意

string 案内文

registrationReasonCode 任意

string | null registration_blocked:本日の取得が保留

registrationBlockedOn 任意

string | null 保留日

registrationWarning 任意

string | null 登記手続きに関する案内

signal 任意

object 登記受付の観測情報

state 任意

string | null receipt_after・receipt_near・no_receipt_in_covered・unverified

bureau 任意

string 局名の表示値

coveredThrough 任意

string 観測範囲の終了日または空文字

last_receipt_on 任意

string | null 観測した最新の登記受付日

acquiredByOwnOrg 任意

boolean 所属法人が最新取得した履歴があるか

reason 任意

string not_available・not_registered_corporation

entrustable 任意

boolean Web の取得代行を案内できるか

choice 任意

string new・archive・redownload

選択値:new・archive・redownload

manual 任意

boolean 取得方法を明示指定したか

reason 任意

string 選定理由

reasonCode 任意

string | null recent_archive・registration_blocked・already_owned などの選定理由

acquiredOn 任意

string | null アーカイブ取得日

voucher 任意

boolean 引換券を使うか

amount 任意

number 明細金額(円)

unitAmount 任意

number 1 文書の単価(円)

authorizationAmount 任意

number | null 与信の上限額(円)

docType 任意

string history・closed

closedRecordRef 任意

string | null 閉鎖事項の参照値

quantityUncertain 任意

boolean 文書数が未確定か

track 任意

string provision・entrusted

freeRedownload 任意

boolean 権利があり無料で再取得できるか

documentId 任意

string | null 選択した文書 ID。archive・redownload の場合に返る。

timepointKind 任意

string | null latest・past・closed

headOffice 任意

string | null 選択時点の本店

requestedDocumentId 任意

string | null 指定された文書 ID

newCount 任意

number 最新取得件数

archiveCount 任意

number アーカイブ件数

vouchersUsed 任意

number 使用引換券数

total 任意

number 合計額(円)

authorizationTotal 任意

number 与信上限額(円)

estimatedVouchers 任意

number 発行見込みの引換券数

taxAmount 任意

number 内消費税(円)

consent 任意

object 承認時の見積照合値

authorizationTotal 任意

number 確認した与信上限額

linesHash 任意

string 確認した明細のハッシュ

monthly_remaining 任意

number 月間の残り取得可能数

monthly_reserved 任意

number 予約中の取得数

base_cap 任意

number 基本の月間上限

monthly_used 任意

number 月間使用済み数

monthly_cap 任意

number 月間上限数

prepaid_remaining 任意

number 現在有効な月間加算件数

entrustedSalesOpen 任意

boolean 取得代行の受付可否

entrustedSalesTestAllowed 任意

boolean 取得代行のテスト受付可否

null

error 任意

string | null 見積できない場合は not_available

quote 任意

カート全体の見積。見積できない場合は null

いずれかの型

参照先:Quote

object

lines 任意

array 見積明細

配列の要素

object

company 任意

上の法人情報 参照先:Company

object

cn 任意

string 13 桁の法人番号(先頭 0 不可)

name 任意

string 社名

closed 任意

boolean 閉鎖法人か

prefecture 任意

string | null 都道府県

city 任意

string | null 市区町村

industry 任意

string | null 業種

capital 任意

string 資本金の表示値(未取得は —)

founded 任意

string 設立日または —

archiveDate 任意

string | null 提供できる履歴事項アーカイブの取得日時

recentArchive 任意

object | null 直近取得済みの場合の案内

reasonCode 任意

string recent_archive

acquiredOn 任意

string 取得日

message 任意

string 案内文

registrationReasonCode 任意

string | null registration_blocked:本日の取得が保留

registrationBlockedOn 任意

string | null 保留日

registrationWarning 任意

string | null 登記手続きに関する案内

signal 任意

object 登記受付の観測情報

state 任意

string | null receipt_after・receipt_near・no_receipt_in_covered・unverified

bureau 任意

string 局名の表示値

coveredThrough 任意

string 観測範囲の終了日または空文字

last_receipt_on 任意

string | null 観測した最新の登記受付日

acquiredByOwnOrg 任意

boolean 所属法人が最新取得した履歴があるか

reason 任意

string not_available・not_registered_corporation

entrustable 任意

boolean Web の取得代行を案内できるか

choice 任意

string new・archive・redownload

選択値:new・archive・redownload

manual 任意

boolean 取得方法を明示指定したか

reason 任意

string 選定理由

reasonCode 任意

string | null recent_archive・registration_blocked・already_owned などの選定理由

acquiredOn 任意

string | null アーカイブ取得日

voucher 任意

boolean 引換券を使うか

amount 任意

number 明細金額(円)

unitAmount 任意

number 1 文書の単価(円)

authorizationAmount 任意

number | null 与信の上限額(円)

docType 任意

string history・closed

closedRecordRef 任意

string | null 閉鎖事項の参照値

quantityUncertain 任意

boolean 文書数が未確定か

track 任意

string provision・entrusted

freeRedownload 任意

boolean 権利があり無料で再取得できるか

documentId 任意

string | null 選択した文書 ID。archive・redownload の場合に返る。

timepointKind 任意

string | null latest・past・closed

headOffice 任意

string | null 選択時点の本店

requestedDocumentId 任意

string | null 指定された文書 ID

newCount 任意

number 最新取得件数

archiveCount 任意

number アーカイブ件数

vouchersUsed 任意

number 使用引換券数

total 任意

number 合計額(円)

authorizationTotal 任意

number 与信上限額(円)

estimatedVouchers 任意

number 発行見込みの引換券数

taxAmount 任意

number 内消費税(円)

consent 任意

object 承認時の見積照合値

authorizationTotal 任意

number 確認した与信上限額

linesHash 任意

string 確認した明細のハッシュ

monthly_remaining 任意

number 月間の残り取得可能数

monthly_reserved 任意

number 予約中の取得数

base_cap 任意

number 基本の月間上限

monthly_used 任意

number 月間使用済み数

monthly_cap 任意

number 月間上限数

prepaid_remaining 任意

number 現在有効な月間加算件数

entrustedSalesOpen 任意

boolean 取得代行の受付可否

entrustedSalesTestAllowed 任意

boolean 取得代行のテスト受付可否

null

CartResult

object

results 任意

array 指定品目ごとの追加結果

配列の要素

object

cn 任意

string | null 法人番号。不正入力では null の場合あり。

kind 任意

string | null 受理した種別。latest は new に正規化。

ok 任意

boolean 追加済み・すでに登録済みなら true

status 任意

string added・already_in_cart・rejected

error 任意

string | null invalid_item・entrusted_requires_web_terms・not_available・order_limit・monthly_cap。already_in_cart では項目なし。

PurchaseRequest

object

request_id 任意

string 申請 UUID

status 任意

string pending_approval・approved・rejected・expired・cancelled

選択値:pending_approval・approved・rejected・expired・cancelled

amount_jpy 任意

number 申請時の与信上限額(円)

expires_at 任意

string 承認期限

created_at 任意

string 作成日時

approval_url 任意

string Web 承認ページの絶対 URL

items 任意

array 申請内容

配列の要素

object

cn 任意

string 法人番号

kind 任意

string latest・archive

track 任意

string provision

order_ids 任意

array 承認後の注文 UUID

配列の要素

string

orders 任意

array 決済状況

配列の要素

object

order_id 任意

string 注文 UUID

payment_status 任意

string pending_authorization・authorized・captured・capture_failed・canceled

reapplication_required 任意

boolean 取消済みで再申請が必要か

order_items 任意

array 文書の取得状況

配列の要素

object

order_id 任意

string 注文 UUID

cn 任意

string 法人番号

kind 任意

string latest・archive

status 任意

string processing・available・unavailable

document_id 任意

string PDF と同じ提供判定を通った権利付与済み明細にのみ返す文書 UUID

auto_approved 任意

boolean 承認なし購入を適用したか

auto_payment_ready 任意

boolean 自動決済の開始準備ができたか

reason 任意

string | null 承認なし購入を適用できない理由

DocumentData

object

rows 任意

array 提供可能な文書

配列の要素

object

document_id 任意

string 文書 ID

corporate_number 任意

string 法人番号

file_name 任意

string 既定の PDF 名

data 任意

参照先:ParsedData

object

doc_type 任意

string | null history・closed

trade_name 任意

string | null 商号

corporate_number 任意

string | null 法人番号

company_number 任意

string | null 会社法人等番号

established_on 任意

string | null 設立日

acquired_at 任意

string | null 取得日時

representative_name 任意

string 役員から組み立てた代表者名

officer_count 任意

number | null 役員の人数

last_changed_on 任意

string | null 履歴内の最新変更日

parse_status 任意

string | null 解析状況

warnings 任意

string | null 解析上の注意

capital_jpy 任意

number | null 資本金(円)

issued_shares 任意

number | null 発行済株式数

share_transfer_restriction 任意

string | null 株式譲渡制限

purposes 任意

array 目的

配列の要素

string

officers 任意

array

配列の要素

object

name 任意

string | null 役員名

title 任意

string | null 役職

appointed_on 任意

string | null 就任日

status 任意

string | null 役員の状態

branches 任意

array

配列の要素

object

name 任意

string | null 支店名

history 任意

array

配列の要素

object

kind 任意

string | null 履歴の種類

changed_on 任意

string | null 変更日(initial の場合あり)

registered_on 任意

string | null 登記日

before 任意

string | null 変更前

after 任意

string | null 変更後

summary 任意

string | null 変更の要約

excluded 任意

array 提供対象から除いた文書

配列の要素

object

document_id 任意

string 文書 ID

reason 任意

string 除外理由

ParsedData

object

doc_type 任意

string | null history・closed

trade_name 任意

string | null 商号

corporate_number 任意

string | null 法人番号

company_number 任意

string | null 会社法人等番号

established_on 任意

string | null 設立日

acquired_at 任意

string | null 取得日時

representative_name 任意

string 役員から組み立てた代表者名

officer_count 任意

number | null 役員の人数

last_changed_on 任意

string | null 履歴内の最新変更日

parse_status 任意

string | null 解析状況

warnings 任意

string | null 解析上の注意

capital_jpy 任意

number | null 資本金(円)

issued_shares 任意

number | null 発行済株式数

share_transfer_restriction 任意

string | null 株式譲渡制限

purposes 任意

array 目的

配列の要素

string

officers 任意

array

配列の要素

object

name 任意

string | null 役員名

title 任意

string | null 役職

appointed_on 任意

string | null 就任日

status 任意

string | null 役員の状態

branches 任意

array

配列の要素

object

name 任意

string | null 支店名

history 任意

array

配列の要素

object

kind 任意

string | null 履歴の種類

changed_on 任意

string | null 変更日(initial の場合あり)

registered_on 任意

string | null 登記日

before 任意

string | null 変更前

after 任意

string | null 変更後

summary 任意

string | null 変更の要約

PurchaseCreated

object

request_id 必須

string

形式:uuid

status 必須

string

選択値:pending_approval・ordered・cancelled

order_ids 任意

array

配列の要素

string

形式:uuid

reason 任意

string

選択値:expired・terms_changed・auto_approval_not_retried・entrusted_requires_web_terms・auto_setting_owner_inactive・auto_purchase_disabled・auto_saved_card_required・auto_limit_exceeded・auto_payment_requires_action・auto_payment_declined・permission_required

Error

object

error 必須

string