意匠情報取得APIの情報形式


# 1 意匠情報取得APIとは

　意匠情報取得APIとは、日本国特許庁が提供するサービスであり、意匠情報を取得するためのRest-APIです。令和５年４月にサービスの提供が開始されたのですが、まだ開示されている情報が少なく手探りで使われている方も多いかとおもいます。意匠の法域に対応した意匠情報取得APIについて簡単に説明します。なお、以下は自身で調査した内容ですので、その旨を承知した上でお使いください。

https://www.jpo.go.jp/system/laws/sesaku/data/api-provision.html

https://ip-data.jpo.go.jp/pages/top.html

https://qiita.com/kenichiro_ayaki/items/fc3d400142d47c9c27b0

https://qiita.com/kenichiro_ayaki/items/57135da3993efdd03138

https://qiita.com/kenichiro_ayaki/items/ef145081e1aa93d3f847

# 2 意匠情報取得APIの概要

以下の表は、意匠情報取得APIの名称と概要を示したものです。

| 名称         | 概要       |  URL  |
|:----------------|:----------------|:------------|
|意匠経過情報| 出願番号に基づき経過情報の一覧を取得|https://ip-data.jpo.go.jp/api/design/v1/app_progress/（出願番号）|
|シンプル版意匠経過情報|シンプルな経過情報の一覧を取得|https://ip-data.jpo.go.jp/api/design/v1/app_progress_simple/（出願番号）|
|意匠優先基礎出願情報|出願番号に基づき優先基礎出願情報を取得|https://ip-data.jpo.go.jp/api/design/v1/priority_right_app_info/（出願番号）|
|意匠申請人氏名・名称|申請人コードに基づき申請人氏名・名称を取得|https://ip-data.jpo.go.jp/api/design/v1/applicant_attorney_cd/（申請人コード）|
|意匠申請人コード|申請人氏名・名称に基づき申請人コードを取得|https://ip-data.jpo.go.jp/api/design/v1/applicant_attorney/（申請人氏名・名称）|
|意匠番号参照|出願/公開/登録番号に基づき相互に番号を取得|https://ip-data.jpo.go.jp/api/design/v1/case_number_reference/{種別}/{案件番号}|
|意匠申請書類|出願番号に基づき申請書類の実体ファイルを取得|https://ip-data.jpo.go.jp/api/design/v1/app_doc_cont_opinion_amendment/{出願番号}|
|意匠発送書類|出願番号に基づき申請書類の実体ファイルを取得|https://ip-data.jpo.go.jp/api/design/v1/app_doc_cont_refusal_reason_decision/{出願番号}|
|意匠拒絶理由通知書|出願番号に基づき拒絶理由通知書を取得|https://ip-data.jpo.go.jp/api/design/v1/app_doc_cont_refusal_reason/{出願番号}|
|意匠登録情報|出願番号に基づき登録情報を取得|https://ip-data.jpo.go.jp/api/design/v1/registration_info/{出願番号}|
|意匠J-PlatPat固定アドレス|出願番号に基づきJ-PlatPat固定アドレス情報を取得|https://ip-data.jpo.go.jp/api/design/v1/jpp_fixed_address/{出願番号}|

# 3 意匠情報取得APIの詳細

いｓ情報取得APIを呼び出すにあたり、トークンを取得します。トークンの取得には、Windowsのコマンドプロンプトから以下の cURL.exe コマンドを実行してください。

```bat:コマンドプロンプト
curl -X POST -H "Content-Type: application/x-www-form-urlencoded" --data-urlencode "grant_type=password" --data-urlencode "username=ユーザ名" --data-urlencode "password=パスワード（未エンコード）" https://ip-data.jpo.go.jp/(トークン取得パス) -o token.json.txt
```
これにてJSON形式のトークンが取得できます。

https://qiita.com/kenichiro_ayaki/items/dde737d0d5561c5e4b4c


## 3.1 意匠経過情報
出願番号に基づき経過情報の一覧を取得するものです。

https://ip-data.jpo.go.jp/api/design/v1/app_progress/（出願番号）
のURLに対して、GETリクエストを実行します。なお、ヘッダーにはトークン(access_token)を設定してください。
なお、出願番号は、2022012584 のように、西暦４桁＋年間通番６桁を記載します。

以下に意匠経過情報を取得する curl.exe のコマンド例を示します。これにより、新たにapp_progress.json.txt が生成されます。

```bat:コマンドプロンプト
curl -X GET -H "Authorization: Bearer （アクセストークン）"  https://ip-data.jpo.go.jp/api/design/v1/app_progress/2022012584 -o app_progress.json.txt
```


取得できるJSONの文字コードはUTF8です。キー項目とデータ型は以下です。

| キー項目         | キー項目名       |  データ型   | サイズ |
|:----------------|:----------------|:------------|:------------|
| result          | 取得結果    　　 | オブジェクト  | - |
| ⇒ statusCode   | ステータスコード | 文字列       | 3 |
| ⇒ errorMessage | エラーメッセージ | 文字列       | - |
| ⇒ remainAccessCount | 残アクセス数 | 文字列       | - |
| ⇒ data         | 詳細情報データ   | オブジェクト | - |

以下，dataオブジェクトの説明です。なお矢印は、オブジェクトまたは配列内の子項目を指します。

| キー項目         | キー項目名   |  データ型 | サイズ |
|:----------------|:------------|:------------|:------------|
| applicationNumber   | 出願番号       | 文字列       |10|
| designArticle      | 意匠に係る物品                  | 文字列      |-|
| designClass      | 意匠区分                  | 文字列      |-|
| applicantAttorney   | 申請人（出願人・代理人）    | 配列      | - |
|⇒ applicantAttorneyCd|申請人コード|文字列|9|
|⇒ repeatNumber       |繰返番号    |文字列|-|
|⇒ name|申請人氏名・名称|文字列|1000|
|⇒ applicantAttorneyClass|出願人・代理人識別|文字列|1|
|filingDate    | 出願日    | 文字列     | 8 |
|publicationDate  | 公開日 | 文字列 | 8 |
|registrationNumber| 登録番号 | 文字列 | 7 |
|registrationDate | 登録日      | 文字列 | 8 |
|principalDesignApplicationNumber | 本意匠番号      | 文字列 | 8 |
|erasureIdentifier|抹消識別| 文字列 | 2 |
|expireDate|存続期間満了年月日 | 文字列 | 8 |
|disappearanceDate|本権利消滅日 | 文字列 | 8 |
|priorityRightInformation | 優先権基礎情報 | 配列 | - |
|⇒ parisPriorityApplicationNumber |パリ条約に基づく優先権出願番号 | 文字列 | 20 |
|⇒ parisPriorityDate | パリ条約に基づく優先権主張日 | 文字列 | 8 |
|⇒ parisPriorityCountryCd |パリ条約に基づく優先権国コード | 文字列| 2 |
|⇒ nationalPriorityDate | 国内優先権主張日 | 文字列|8|
|parentApplicationInformation | 原出願情報 | オブジェクト|-|
|⇒ parentApplicationNumber | 原出願番号 | 文字列|10|
|⇒ filingDate | 出願日 |文字列|8|
|divisionalApplicationInformation | 分割出願群情報 | 配列|-|
|⇒ applicationNumber | 出願番号 | 文字列|10|
|⇒ registrationNumber | 登録番号 | 文字列| 7 |
|⇒ erasureIdentifier| 抹消識別 | 文字列| 2 |
|⇒ expireDate| 存続期間満了年月日 | 文字列 | 8 |
|⇒ disappearanceDate| 本権利消滅日 | 文字列 | 8 |
|⇒ divisionalGeneration | 分割出願の世代 | 文字列|-|
|bibliographyInformation | 書類一覧（書誌） | 配列|-|
|⇒ numberType | 番号種別 | 文字列|2 |
|⇒ number | 番号 | 文字列|20|
|⇒ documentList | 書類一覧 | 配列|-|
|⇒⇒ legalDate | 受付日・発送日・作成日 |文字列|8|
|⇒⇒ irirFlg | IB書類フラグ |文字列|1|
|⇒⇒ availabilityFlag | 書類実体有無 | 文字列|1|
|⇒⇒ documentCode | 中間書類コード | 文字列|7|
|⇒⇒ documentDescription | 書類名 | 文字列|40|
|⇒⇒ documentNumber | 書類番号 | 文字列|11|
|⇒⇒ versionNumber | バージョン番号 | 文字列|4|
|⇒⇒ documentSeparator | 書類識別 | 文字列|1|
|⇒⇒ numberOfPages | ページ数 | 文字列|5|
|⇒⇒ sizeOfDocument | ドキュメントサイズ | 文字列|6|

<details><summary>以下は、意匠経過情報のJSONの例です。（クリックで展開）</summary><div>

```json:意願2022-012584の意匠経過情報
{
	"result": {
		"statusCode": "100",
		"errorMessage": "",
		"remainAccessCount": "399",
		"data": {
			"applicationNumber": "2022012584",
			"designArticle": "乗用自動車",
			"designClass": "G22100",
			"applicantAttorney": [
				{
					"applicantAttorneyCd": "591037096",
					"repeatNumber": "1",
					"name": "フオルクスワーゲン・アクチエンゲゼルシヤフト",
					"applicantAttorneyClass": "1"
				},
				{
					"applicantAttorneyCd": "100114890",
					"repeatNumber": "2",
					"name": "アインゼル・フェリックス＝ラインハルト",
					"applicantAttorneyClass": "2"
				},
				{
					"applicantAttorneyCd": "100209185",
					"repeatNumber": "3",
					"name": "松永　章吾",
					"applicantAttorneyClass": "2"
				},
				{
					"applicantAttorneyCd": "100127823",
					"repeatNumber": "4",
					"name": "山崎　和香子",
					"applicantAttorneyClass": "2"
				},
				{
					"applicantAttorneyCd": "100121809",
					"repeatNumber": "5",
					"name": "前川　砂織",
					"applicantAttorneyClass": "2"
				},
				{
					"applicantAttorneyCd": "100124556",
					"repeatNumber": "6",
					"name": "大倉　桂子",
					"applicantAttorneyClass": "2"
				}
			],
			"filingDate": "20220523",
			"publicationDate": "",
			"registrationNumber": "1735126",
			"registrationDate": "20230112",
			"principalDesignApplicationNumber": "2022011905",
			"erasureIdentifier": "00",
			"expireDate": "20470512",
			"disappearanceDate": "",
			"priorityRightInformation": [
				{
					"parisPriorityApplicationNumber": "402021101137.4",
					"parisPriorityDate": "20211210",
					"parisPriorityCountryCd": "DE"
				}
			],
			"parentApplicationInformation": {
				"parentApplicationCategory": "10",
				"parentApplicationLawCode": "3",
				"parentApplicationNumber": "2022300084"
			},
			"bibliographyInformation": [
				{
					"numberType": "01",
					"number": "2022012584",
					"documentList": [
						{
							"legalDate": "20220523",
							"irirFlg": "0",
							"availabilityFlag": "1",
							"documentCode": "A63",
							"documentDescription": "意匠登録願",
							"documentNumber": "52270000349",
							"versionNumber": "0001",
							"documentSeparator": "S",
							"numberOfPages": "0",
							"sizeOfDocument": "600145"
						},
						{
							"legalDate": "20221013",
							"irirFlg": "0",
							"availabilityFlag": "1",
							"documentCode": "A131",
							"documentDescription": "拒絶理由通知書",
							"documentNumber": "06322057705",
							"versionNumber": "0001",
							"documentSeparator": "S",
							"numberOfPages": "0",
							"sizeOfDocument": "1224"
						},
						{
							"legalDate": "20221013",
							"irirFlg": "0",
							"availabilityFlag": "1",
							"documentCode": "A223",
							"documentDescription": "同一出願人による同日出願の協議指令書",
							"documentNumber": "06322057707",
							"versionNumber": "0001",
							"documentSeparator": "S",
							"numberOfPages": "0",
							"sizeOfDocument": "2133"
						},
						{
							"legalDate": "20221207",
							"irirFlg": "0",
							"availabilityFlag": "1",
							"documentCode": "A523",
							"documentDescription": "手続補正書",
							"documentNumber": "52202708726",
							"versionNumber": "0001",
							"documentSeparator": "S",
							"numberOfPages": "0",
							"sizeOfDocument": "702"
						},
						{
							"legalDate": "20221207",
							"irirFlg": "0",
							"availabilityFlag": "1",
							"documentCode": "A53",
							"documentDescription": "意見書",
							"documentNumber": "52202708723",
							"versionNumber": "0001",
							"documentSeparator": "S",
							"numberOfPages": "0",
							"sizeOfDocument": "927"
						},
						{
							"legalDate": "20221222",
							"irirFlg": "0",
							"availabilityFlag": "1",
							"documentCode": "A252",
							"documentDescription": "審査官通知（その他の通知）（期間無）",
							"documentNumber": "06322071592",
							"versionNumber": "0001",
							"documentSeparator": "S",
							"numberOfPages": "0",
							"sizeOfDocument": "1397"
						},
						{
							"legalDate": "20221222",
							"irirFlg": "0",
							"availabilityFlag": "1",
							"documentCode": "A01",
							"documentDescription": "登録査定",
							"documentNumber": "06322071596",
							"versionNumber": "0001",
							"documentSeparator": "S",
							"numberOfPages": "0",
							"sizeOfDocument": "851"
						},
						{
							"legalDate": "20230110",
							"irirFlg": "0",
							"availabilityFlag": "0",
							"documentCode": "A61",
							"documentDescription": "登録料納付",
							"documentNumber": "BBBBBBBBBBB",
							"versionNumber": "0000",
							"documentSeparator": " ",
							"numberOfPages": "0",
							"sizeOfDocument": "0"
						}
					]
				},
				{
					"numberType": "06",
					"number": "1735126",
					"documentList": [
						{
							"legalDate": "20221222",
							"irirFlg": "0",
							"availabilityFlag": "0",
							"documentCode": "A01",
							"documentDescription": "登録査定",
							"documentNumber": "99999999999",
							"versionNumber": "0000",
							"documentSeparator": " ",
							"numberOfPages": "0",
							"sizeOfDocument": "0"
						},
						{
							"legalDate": "20230110",
							"irirFlg": "0",
							"availabilityFlag": "0",
							"documentCode": "R100",
							"documentDescription": "設定納付書",
							"documentNumber": "99999999999",
							"versionNumber": "0000",
							"documentSeparator": " ",
							"numberOfPages": "0",
							"sizeOfDocument": "0"
						},
						{
							"legalDate": "20230124",
							"irirFlg": "0",
							"availabilityFlag": "0",
							"documentCode": "R150",
							"documentDescription": "登録証",
							"documentNumber": "99999999999",
							"versionNumber": "0000",
							"documentSeparator": " ",
							"numberOfPages": "0",
							"sizeOfDocument": "0"
						}
					]
				}
			]
		}
	}
}
```
</div></details>


## 3.2 シンプル意匠経過情報
出願番号に基づき経過情報（優先権基礎情報、原出願情報、分割出願群情報を含まない）の一覧を取得するものです。

https://ip-data.jpo.go.jp/api/design/v1/app_progress_simple/（出願番号）
のURLに対して、GETリクエストを実行します。なお、ヘッダーにはトークンを設定してください。
なお、出願番号は、2022012584 のように、西暦４桁＋年間通番６桁を記載します。

以下に curl.exe のコマンド例を示します。これにより、新たにapp_progress_simple.json.txt が生成されます。

```bat:コマンドプロンプト
curl -X GET -H "Authorization: Bearer （アクセストークン）"  https://ip-data.jpo.go.jp/api/design/v1/app_progress_simple/2022012584 -o app_progress_simple.json.txt
```

取得できるJSONの文字コードはUTF8です。キー項目とデータ型は以下です。

| キー項目         | キー項目名       |  データ型   | サイズ |
|:----------------|:----------------|:------------|:------------|
| result          | 取得結果    　　 | オブジェクト  | - |
| ⇒ statusCode   | ステータスコード | 文字列       | 3 |
| ⇒ errorMessage | エラーメッセージ | 文字列       | - |
| ⇒ remainAccessCount | 残アクセス数 | 文字列       | - |
| ⇒ data         | 詳細情報データ   | オブジェクト | - |

以下，dataオブジェクトの説明です。なお矢印は、オブジェクトまたは配列内の子項目を指します。

| キー項目         | キー項目名   |  データ型 | サイズ |
|:----------------|:------------|:------------|:------------|
| applicationNumber   | 出願番号       | 文字列       |10|
| inventionTitle      | 発明名称                  | 文字列      |1000|
| applicantAttorney   | 申請人（出願人・代理人）    | 配列      | - |
|⇒ applicantAttorneyCd|申請人コード|文字列|9|
|⇒ repeatNumber       |繰返番号    |文字列|-|
|⇒ name|申請人氏名・名称|文字列|1000|
|⇒ applicantAttorneyClass|出願人・代理人識別|文字列|1|
|filingDate    | 出願日    | 文字列     | 8 |
|publicationNumber| 公開番号  | 文字列 | 9 |
|registrationNumber| 登録番号 | 文字列 | 7 |
|registrationDate | 登録日      | 文字列 | 8 |
|erasureIdentifier|抹消識別| 文字列 | 2 |
|expireDate|存続期間満了年月日 | 文字列 | 8 |
|disappearanceDate|本権利消滅日 | 文字列 | 8 |
|bibliographyInformation | 書類一覧（書誌） | 配列|-|
|⇒ numberType | 番号種別 | 文字列|2|
|⇒ number | 番号 | 文字列|20|
|⇒ documentList | 書類一覧 | 配列|-|
|⇒⇒ legalDate | 受付日・発送日・作成日 |文字列|8|
|⇒⇒ irirFlg | IB書類フラグ |文字列|1|
|⇒⇒ availabilityFlag | 書類実体有無 | 文字列|1|
|⇒⇒ documentCode | 中間書類コード | 文字列|7|
|⇒⇒ documentDescription | 書類名 | 文字列|40|
|⇒⇒ documentNumber | 書類番号 | 文字列|11|
|⇒⇒ versionNumber | バージョン番号 | 文字列|4|
|⇒⇒ documentSeparator | 書類識別 | 文字列|1|
|⇒⇒ numberOfPages | ページ数 | 文字列|5|
|⇒⇒ sizeOfDocument | ドキュメントサイズ | 文字列|6|


<details><summary>以下は、シンプル版意匠経過情報のJSONの例です。（クリックで展開）</summary><div>

```json:意願2022-012584のシンプル版意匠経過情報
{
	"result": {
		"statusCode": "100",
		"errorMessage": "",
		"remainAccessCount": "398",
		"data": {
			"applicationNumber": "2022012584",
			"designArticle": "乗用自動車",
			"applicantAttorney": [
				{
					"applicantAttorneyCd": "591037096",
					"repeatNumber": "1",
					"name": "フオルクスワーゲン・アクチエンゲゼルシヤフト",
					"applicantAttorneyClass": "1"
				},
				{
					"applicantAttorneyCd": "100114890",
					"repeatNumber": "2",
					"name": "アインゼル・フェリックス＝ラインハルト",
					"applicantAttorneyClass": "2"
				},
				{
					"applicantAttorneyCd": "100209185",
					"repeatNumber": "3",
					"name": "松永　章吾",
					"applicantAttorneyClass": "2"
				},
				{
					"applicantAttorneyCd": "100127823",
					"repeatNumber": "4",
					"name": "山崎　和香子",
					"applicantAttorneyClass": "2"
				},
				{
					"applicantAttorneyCd": "100121809",
					"repeatNumber": "5",
					"name": "前川　砂織",
					"applicantAttorneyClass": "2"
				},
				{
					"applicantAttorneyCd": "100124556",
					"repeatNumber": "6",
					"name": "大倉　桂子",
					"applicantAttorneyClass": "2"
				}
			],
			"filingDate": "20220523",
			"publicationDate": "",
			"registrationNumber": "1735126",
			"registrationDate": "20230112",
			"erasureIdentifier": "00",
			"expireDate": "20470512",
			"disappearanceDate": "",
			"bibliographyInformation": [
				{
					"numberType": "01",
					"number": "2022012584",
					"documentList": [
						{
							"legalDate": "20220523",
							"irirFlg": "0",
							"availabilityFlag": "1",
							"documentCode": "A63",
							"documentDescription": "意匠登録願",
							"documentNumber": "52270000349",
							"versionNumber": "0001",
							"documentSeparator": "S",
							"numberOfPages": "0",
							"sizeOfDocument": "600145"
						},
						{
							"legalDate": "20221013",
							"irirFlg": "0",
							"availabilityFlag": "1",
							"documentCode": "A131",
							"documentDescription": "拒絶理由通知書",
							"documentNumber": "06322057705",
							"versionNumber": "0001",
							"documentSeparator": "S",
							"numberOfPages": "0",
							"sizeOfDocument": "1224"
						},
						{
							"legalDate": "20221013",
							"irirFlg": "0",
							"availabilityFlag": "1",
							"documentCode": "A223",
							"documentDescription": "同一出願人による同日出願の協議指令書",
							"documentNumber": "06322057707",
							"versionNumber": "0001",
							"documentSeparator": "S",
							"numberOfPages": "0",
							"sizeOfDocument": "2133"
						},
						{
							"legalDate": "20221207",
							"irirFlg": "0",
							"availabilityFlag": "1",
							"documentCode": "A523",
							"documentDescription": "手続補正書",
							"documentNumber": "52202708726",
							"versionNumber": "0001",
							"documentSeparator": "S",
							"numberOfPages": "0",
							"sizeOfDocument": "702"
						},
						{
							"legalDate": "20221207",
							"irirFlg": "0",
							"availabilityFlag": "1",
							"documentCode": "A53",
							"documentDescription": "意見書",
							"documentNumber": "52202708723",
							"versionNumber": "0001",
							"documentSeparator": "S",
							"numberOfPages": "0",
							"sizeOfDocument": "927"
						},
						{
							"legalDate": "20221222",
							"irirFlg": "0",
							"availabilityFlag": "1",
							"documentCode": "A252",
							"documentDescription": "審査官通知（その他の通知）（期間無）",
							"documentNumber": "06322071592",
							"versionNumber": "0001",
							"documentSeparator": "S",
							"numberOfPages": "0",
							"sizeOfDocument": "1397"
						},
						{
							"legalDate": "20221222",
							"irirFlg": "0",
							"availabilityFlag": "1",
							"documentCode": "A01",
							"documentDescription": "登録査定",
							"documentNumber": "06322071596",
							"versionNumber": "0001",
							"documentSeparator": "S",
							"numberOfPages": "0",
							"sizeOfDocument": "851"
						},
						{
							"legalDate": "20230110",
							"irirFlg": "0",
							"availabilityFlag": "0",
							"documentCode": "A61",
							"documentDescription": "登録料納付",
							"documentNumber": "BBBBBBBBBBB",
							"versionNumber": "0000",
							"documentSeparator": " ",
							"numberOfPages": "0",
							"sizeOfDocument": "0"
						}
					]
				},
				{
					"numberType": "06",
					"number": "1735126",
					"documentList": [
						{
							"legalDate": "20221222",
							"irirFlg": "0",
							"availabilityFlag": "0",
							"documentCode": "A01",
							"documentDescription": "登録査定",
							"documentNumber": "99999999999",
							"versionNumber": "0000",
							"documentSeparator": " ",
							"numberOfPages": "0",
							"sizeOfDocument": "0"
						},
						{
							"legalDate": "20230110",
							"irirFlg": "0",
							"availabilityFlag": "0",
							"documentCode": "R100",
							"documentDescription": "設定納付書",
							"documentNumber": "99999999999",
							"versionNumber": "0000",
							"documentSeparator": " ",
							"numberOfPages": "0",
							"sizeOfDocument": "0"
						},
						{
							"legalDate": "20230124",
							"irirFlg": "0",
							"availabilityFlag": "0",
							"documentCode": "R150",
							"documentDescription": "登録証",
							"documentNumber": "99999999999",
							"versionNumber": "0000",
							"documentSeparator": " ",
							"numberOfPages": "0",
							"sizeOfDocument": "0"
						}
					]
				}
			]
		}
	}
}
```
</div></details>

## 3.3 意匠優先基礎出願情報
指定された意匠出願番号に紐づく優先基礎出願情報を取得するものです。

https://ip-data.jpo.go.jp/api/design/v1/priority_right_app_info/（出願番号）
のURLに対して、GETリクエストを実行します。なお、ヘッダーにはトークンを設定してください。
なお、出願番号は、2022012584 のように、西暦４桁＋年間通番６桁を記載します。

以下に curl.exe のコマンド例を示します。これにより、新たにpriority_right_app_info.json.txt が生成されます。

```bat:コマンドプロンプト
curl -X GET -H "Authorization: Bearer （アクセストークン）"  https://ip-data.jpo.go.jp/api/design/v1/priority_right_app_info/2022012584 -o priority_right_app_info.json.txt
```


取得できるJSONの文字コードはUTF8です。キー項目とデータ型は以下です。

| キー項目         | キー項目名       |  データ型   | サイズ |
|:----------------|:----------------|:------------|:------------|
| result          | 取得結果    　　 | オブジェクト  | - |
| ⇒ statusCode   | ステータスコード | 文字列       | 3 |
| ⇒ errorMessage | エラーメッセージ | 文字列       | - |
| ⇒ remainAccessCount | 残アクセス数 | 文字列       | - |
| ⇒ data         | 詳細情報データ   | オブジェクト | - |

以下，dataオブジェクトの説明です。なお矢印は、オブジェクトまたは配列内の子項目を指します。

| キー項目         | キー項目名   |  データ型 | サイズ |
|:----------------|:------------|:------------|:------------|
| applicationNumber   | 出願番号       | 文字列       |10|
|priorityRightInformation | 優先権基礎情報 | 配列 | - |
|⇒ parisPriorityApplicationNumber |パリ条約に基づく優先権出願番号 | 文字列 | 20 |
|⇒ parisPriorityDate | パリ条約に基づく優先権主張日 | 文字列 | 8 |
|⇒ parisPriorityCountryCd |パリ条約に基づく優先権国コード | 文字列| 2

<details><summary>以下は、意匠優先基礎出願情報のJSONの例です。（クリックで展開）</summary><div>

```json:意願2022-012584の意匠優先基礎出願情報
{
	"result": {
		"statusCode": "100",
		"errorMessage": "",
		"remainAccessCount": "28",
		"data": {
			"applicationNumber": "2022012584",
			"priorityRightInformation": [
				{
					"parisPriorityApplicationNumber": "402021101137.4",
					"parisPriorityDate": "20211210",
					"parisPriorityCountryCd": "DE"
				}
			]
		}
	}
}
```
</div></details>

## 3.4 申請人氏名・名称
指定された申請人コードで申請人(出願人・代理人)氏名・名称を取得するものです。

https://ip-data.jpo.go.jp/api/design/v1/applicant_attorney_cd/{申請人コード}
のURLに対して、GETリクエストを実行します。なお、ヘッダーにはトークンを設定してください。
なお、申請人コードは、718000266のように識別コードを記載します。

以下に curl.exe のコマンド例を示します。これにより、新たにapplicant_attorney_cd.json.txt が生成されます。

```bat:コマンドプロンプト
curl -X GET -H "Authorization: Bearer （アクセストークン）"  https://ip-data.jpo.go.jp/api/design/v1/applicant_attorney_cd/718000266 -o applicant_attorney_cd.json.txt
```

取得できるJSONの文字コードはUTF8です。キー項目とデータ型は以下です。

| キー項目         | キー項目名       |  データ型   | サイズ |
|:----------------|:----------------|:------------|:------------|
| result          | 取得結果    　　 | オブジェクト  | - |
| ⇒ statusCode   | ステータスコード | 文字列       | 3 |
| ⇒ errorMessage | エラーメッセージ | 文字列       | - |
| ⇒ remainAccessCount | 残アクセス数 | 文字列       | - |
| ⇒ data         | 詳細情報データ   | オブジェクト | - |

以下，dataオブジェクトの説明です。なお矢印は、オブジェクトまたは配列内の子項目を指します。

| キー項目         | キー項目名   |  データ型 | サイズ |
|:----------------|:------------|:------------|:------------|
|applicantAttorneyName|申請人氏名・名称|文字列|1000|

<details><summary>以下は、申請人氏名・名称のJSONの例です。（クリックで展開）</summary><div>

```json:申請人コード718000266の申請人氏名・名称
{
	"result": {
		"statusCode": "100",
		"errorMessage": "",
		"remainAccessCount": "199",
		"data": {
			"applicantAttorneyName": "特許庁長官"
		}
	}
}
```
</div></details>

## 3.5 申請人コード
指定された申請人氏名・名称で、申請人コードを取得するものです。

https://ip-data.jpo.go.jp/api/design/v1/applicant_attorney/{申請人氏名・名称}
のURLに対して、GETリクエストを実行します。なお、ヘッダーにはトークンを設定してください。
なお、申請人氏名・名称は、UTF-8文字列の「特許庁長官」などの氏名・名称をURLエンコードした%E7%89%B9%E8%A8%B1%E5%BA%81%E9%95%B7%E5%AE%98のように記載します。

以下に curl.exe のコマンド例を示します。これにより、新たにapplicant_attorney.json.txt が生成されます。
なお、.bat ファイルでは、% を %% に変換してください。

```bat:コマンドプロンプト
curl -X GET -H "Authorization: Bearer （アクセストークン）"  https://ip-data.jpo.go.jp/api/design/v1/applicant_attorney/%E7%89%B9%E8%A8%B1%E5%BA%81%E9%95%B7%E5%AE%98 -o applicant_attorney.json.txt
```

取得できるJSONの文字コードはUTF8です。キー項目とデータ型は以下です。

| キー項目         | キー項目名       |  データ型   | サイズ |
|:----------------|:----------------|:------------|:------------|
| result          | 取得結果    　　 | オブジェクト  | - |
| ⇒ statusCode   | ステータスコード | 文字列       | 3 |
| ⇒ errorMessage | エラーメッセージ | 文字列       | - |
| ⇒ remainAccessCount | 残アクセス数 | 文字列       | - |
| ⇒ data         | 詳細情報データ   | オブジェクト | - |

以下，dataオブジェクトの説明です。なお矢印は、オブジェクトまたは配列内の子項目を指します。

| キー項目         | キー項目名   |  データ型 | サイズ |
|:----------------|:------------|:------------|:------------|
|applicantAttorney|申請人|配列|-|
|⇒ applicantAttorneyCd|申請人コード|文字列|9|
|⇒ name|申請人氏名・名称|文字列|1000|

<details><summary>以下は、申請人コードのJSONの例です。（クリックで展開）</summary><div>

```json:「特許庁長官」の申請人コード
{
	"result": {
		"statusCode": "100",
		"errorMessage": "",
		"remainAccessCount": "188",
		"data": {
			"applicantAttorney": [
				{
					"applicantAttorneyCd": "718000266",
					"name": "特許庁長官"
				}
			]
		}
	}
}
```
</div></details>

## 3.6 意匠番号参照
指定された種別と案件番号に紐づく案件番号を取得するものです。

https://ip-data.jpo.go.jp/api/design/v1/case_number_reference/{種別}/{案件番号}
のURLに対して、GETリクエストを実行します。なお、ヘッダーにはトークンを設定してください。
種別は以下のように指定します。

| 指定したい種別 | 種別名   |
|:--------------|:------------|
| 出願番号       |application|
| 公開・公表番号 |publication|
|登録番号|registration|

以下に curl.exe のコマンド例を示します。これにより、新たにcase_number_reference.json.txt が生成されます。

```bat:コマンドプロンプト
curl -X GET -H "Authorization: Bearer （アクセストークン）"  https://ip-data.jpo.go.jp/api/design/v1/case_number_reference/application/2016500748 -o case_number_reference.json.txt
```

取得できるJSONの文字コードはUTF8です。キー項目とデータ型は以下です。

| キー項目         | キー項目名       |  データ型   | サイズ |
|:----------------|:----------------|:------------|:------------|
| result          | 取得結果    　　 | オブジェクト  | - |
| ⇒ statusCode   | ステータスコード | 文字列       | 3 |
| ⇒ errorMessage | エラーメッセージ | 文字列       | - |
| ⇒ remainAccessCount | 残アクセス数 | 文字列       | - |
| ⇒ data         | 詳細情報データ   | オブジェクト | - |

以下，dataオブジェクトの説明です。なお矢印は、オブジェクトまたは配列内の子項目を指します。

| キー項目         | キー項目名   |  データ型 | サイズ |
|:----------------|:------------|:------------|:------------|
|applicationNumber| 出願番号         |文字列| 10 |
|internationalRegistrationNumber| 国際登録番号 |文字列|-|
|registrationNumber| 登録番号　　　　 |文字列| 7 |
|designNumber| 意匠番号　　　　 |文字列| - |

<details><summary>以下は、意匠番号参照のJSONの例です。（クリックで展開）</summary><div>

```json:意匠番号参照
{
	"result": {
		"statusCode": "100",
		"errorMessage": "",
		"remainAccessCount": "49",
		"data": {
			"applicationNumber": "2016500748",
			"registrationNumber": "1581216",
			"internationalRegistrationNumber": "DM/091050",
			"designNumber": "001"
		}
	}
}
```
</div></details>


## 3.7 意匠申請書類の実体ファイル（意見書・手続補正書）
指定された意匠出願番号に対応する実体審査における意匠申請書類の実体ファイル（意見書・手続補正書）のZIPファイルをダウンロードするものです。

https://ip-data.jpo.go.jp/api/design/v1/app_doc_cont_opinion_amendment/{出願番号}
のURLに対して、GETリクエストを実行します。なお、ヘッダーにはトークンを設定してください。

以下に curl.exe のコマンド例を示します。これにより、新たにapp_doc_cont_opinion_amendment.zip が生成されます。

```bat:コマンドプロンプト
curl -X GET -H "Authorization: Bearer （アクセストークン）"  https://ip-data.jpo.go.jp/api/design/v1/app_doc_cont_opinion_amendment/2020021161 -o app_doc_cont_opinion_amendment.zip
```
<details><summary>以下は、意匠申請書類の実体ファイル（意見書）です。（クリックで展開）</summary><div>

```html:意見書
<HTML>
<HEAD>
<META http-equiv="Content-Type" content="text/html; charset=Shift_JIS">
</HEAD>
<BODY STYLE="font-size:12pt">
<PRE>
                                                                             1/E
【書類名】　　　　　　意見書
【提出日】　　　　　　令和　３年　２月２２日
【あて先】　　　　　　特許庁審査官　小林　佑二　殿
【事件の表示】
　　【出願番号】　　　意願２０２０－　２１１６１
【意匠登録出願人】
　　【識別番号】　　　５１６２９７９４３
　　【氏名又は名称】　アッコ　ブランズ　コーポレイション
【代理人】
　　【識別番号】　　　１００１０７７６６
　　【弁理士】
　　【氏名又は名称】　伊東　忠重
　　【電話番号】　　　（省略）
【発送番号】　　　　　０５６６８７
【意見の内容】
１．審査官殿は、令和２年１１月５日起案の拒絶理由通知書をもって、要旨、本
願は、３つの意匠に係るものであり、経済産業省令で定める物品の区分又はそれ
と同程度の区分により意匠ごとにされているものとは認められず、意匠法第７条
に規定する要件を満たしていない、と認定されました。
 
２．そこで、出願人は、本願の意匠が、一意匠となるよう、本意見書と同日付で
、願書及び図面を補正いたしました。
 
３．以上のことから、本願意匠は、意匠法第７条に規定する要件を満たすものと
思料いたします。審査官殿におかれましては、本願について、再度ご審査を賜わ
りますようお願い申し上げます。
　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　以上
 
</PRE>
</BODY>
</HTML>

```
</div></details>

<details><summary>以下は、意匠申請書類の実体ファイル（手続補正書）です。（クリックで展開）</summary><div>

```html:手続補正書
<HTML>
<HEAD>
<META http-equiv="Content-Type" content="text/html; charset=Shift_JIS">
</HEAD>
<BODY STYLE="font-size:12pt">
<PRE>
                                                                             1/ 
【書類名】　　　　　　手続補正書
【提出日】　　　　　　令和　３年　２月２２日
【あて先】　　　　　　特許庁長官　糟谷　敏秀　殿
【事件の表示】
　　【出願番号】　　　意願２０２０－　２１１６１
【補正をする者】
　　【識別番号】　　　５１６２９７９４３
　　【氏名又は名称】　アッコ　ブランズ　コーポレイション
【代理人】
　　【識別番号】　　　１００１０７７６６
　　【弁理士】
　　【氏名又は名称】　伊東　忠重
　　【電話番号】　　　（省略）
【発送番号】　　　　　０５６６８７
【手続補正1】
　【補正対象書類名】　意匠登録願
　【補正対象項目名】　意匠の説明
　【補正方法】　　　　変更
　【補正の内容】
　　【意匠の説明】　　実線で表した部分が、意匠登録を受けようとする部分で
　　　　　　　　　　　ある。「斜視図」を含めて、意匠登録を受けようとする
　　　　　　　　　　　部分を特定している。意匠登録を受けようとする部分に
　　　　　　　　　　　おいて、縦、横、斜めの直線状及び曲線状の細線若しく
　　　　　　　　　　　は途切れ線は、いずれも立体表面の形状を特定するため
　　　　　　　　　　　のものである。
【手続補正2】
　【補正対象書類名】　図面
　【補正対象項目名】　全図
　【補正方法】　　　　変更
<HR Align="left" Width="640">
                                                                             2/ 
　【補正の内容】
　　【書類名】　　　　図面
　　【斜視図】
<IMG SRC="JPOSGMLDOC10001.JPG" WIDTH="566" HEIGHT="332">
　　【正面図】
<IMG SRC="JPOSGMLDOC10002.JPG" WIDTH="325" HEIGHT="200">
<HR Align="left" Width="640">
                                                                             3/ 
　　【背面図】
<IMG SRC="JPOSGMLDOC10003.JPG" WIDTH="325" HEIGHT="196">
　　【右側面図】
<IMG SRC="JPOSGMLDOC10004.JPG" WIDTH="427" HEIGHT="200">
　　【左側面図】
<IMG SRC="JPOSGMLDOC10005.JPG" WIDTH="427" HEIGHT="200">
<HR Align="left" Width="640">
                                                                             4/ 
　　【平面図】
<IMG SRC="JPOSGMLDOC10006.JPG" WIDTH="325" HEIGHT="427">
<HR Align="left" Width="640">
                                                                             5/E
　　【底面図】
<IMG SRC="JPOSGMLDOC10007.JPG" WIDTH="328" HEIGHT="427">
</PRE>
</BODY>
</HTML>

```
</div></details>

## 3.8 発送書類の実体ファイル（拒絶理由通知書、査定、拒絶査定、補正の却下の決定）
指定された意匠出願番号に対応する実体審査における発送書類の実体ファイル（拒絶理由通知書、査定、拒絶査定、補正の却下の決定）のZIPファイルをダウンロードするものです。

https://ip-data.jpo.go.jp/api/design/v1/app_doc_cont_refusal_reason_decision/{出願番号}
のURLに対して、GETリクエストを実行します。なお、ヘッダーにはトークンを設定してください。

以下に curl.exe のコマンド例を示します。これにより、新たにapp_doc_cont_refusal_reason_decision.zip が生成されます。

```bat:コマンドプロンプト
curl -X GET -H "Authorization: Bearer （アクセストークン）"  https://ip-data.jpo.go.jp/api/design/v1/app_doc_cont_refusal_reason_decision/2020009549 -o app_doc_cont_refusal_reason_decision.zip
```

<details><summary>以下は、意匠発送書類の実体ファイル（拒絶理由通知）です。（クリックで展開）</summary><div>

```html:拒絶理由通知
<HTML>
<HEAD>
<META http-equiv="Content-Type" content="text/html; charset=Shift_JIS">
</HEAD>
<BODY STYLE="font-size:12pt">
<PRE>
                                                                             1/ 
　　　　　　　　　　　<FONT SIZE="6">拒絶理由通知書</FONT>


　意匠登録出願の番号　　　　意願２０２０－００９５４９
　特許庁審査官　　　　　　　▲高▼橋　杏子　　　　　　４４２０
　起案日　　　　　　　　　　令和　２年１２月２１日
　意匠登録出願人　　　　　　ＳＡＹ　ＷＯＲＬＤ有限会社様





　この意匠登録出願については、以下のとおり、登録要件を満たさない理由があ
りますので、意匠法第１９条で準用する特許法第５０条の規定に基づき、通知し
ます。
　この理由について意見があれば、この通知書を発送した日から４０日以内に意
見書を提出することができます。
　なお、意見書の提出があったときには、その内容を考慮した上で、登録の可否
について審査いたします。

　　　　　　　　　　　　　　　　理　由

　この意匠登録出願の意匠は、下記に示すように、意匠法第３条第１項柱書に規
定する工業上利用することができる意匠に該当しません。

　　　　　　　　　　　　　　　　　記

（１）この意匠登録出願の意匠は、意匠に係る物品を「コップ・カップの飲み口
形状」とするものですが、飲み口形状は物品ではありませんので、意匠が不明確
です。

（２）この意匠登録出願の意匠は、意匠登録を受けようとする部分とそれ以外の
部分の境界が不明確ですので、意匠登録を受けようとする部分の形状が特定せず
、意匠が具体的ではありません。

（３）この意匠登録出願の意匠は、願書に添付された図面によっては、背面側の
形態等が不明確であり、添付図面だけでは全体の形状等を特定することができま
せんので、意匠が具体的ではありません。

<HR Align="left" Width="640">
                                                                             2/E
（４）この意匠登録出願の意匠は、意匠に係る物品を「コップ・カップの飲み口
形状」とするもので、「意匠の説明」の欄において、「カップやコップの飲み口
の一部を鼻の幅に鼻を包む形状のＵ字の形をした凹状のカットをいれた鼻うがい
用のカップやコップの飲み口の表示部」との説明を記載されましたが、願書に添
付された図面においては、凹状のカットの形状のみが表されるに止まり、飲み口
の表示部が特定されていないことから、一の意匠を特定することができず、意匠
が具体的ではありません。
　なお、その物品の使用の目的、使用の状態等物品の理解を助けることができる
ような説明は「意匠に係る物品の説明」に記載してください。

◇この通知書・指令書の内容に関するお問合せ先　内線２９１３
























　　　　　　　　　　　　<U>　　　　　　　　　　　　　　　　　　　　　　　　</U>
　　　　　　　　　　　　　　　　　　　　　<U>審査長／代理</U>　　<U>審査官</U>
　　　　　　　　　　　　　　　　　　　　　<U>上島　靖範</U>　　　<U>▲高▼橋　杏子</U>
　　　　　　　　　　　　　　　　　　　　　<U>９１０３</U>　　　　<U>４４２０</U>
</PRE>
</BODY>
</HTML>
```
</div></details>

## 3.9 拒絶理由通知書の実体ファイル
指定された意匠出願番号に対応する拒絶理由通知書のZIPファイルをダウンロードするものです。

https://ip-data.jpo.go.jp/api/design/v1/app_doc_cont_refusal_reason/{出願番号}
のURLに対して、GETリクエストを実行します。なお、ヘッダーにはトークンを設定してください。

以下に curl.exe のコマンド例を示します。これにより、新たにapp_doc_cont_refusal_reason.zip が生成されます。

```bat:コマンドプロンプト
curl -X GET -H "Authorization: Bearer （アクセストークン）"  https://ip-data.jpo.go.jp/api/design/v1/app_doc_cont_refusal_reason/2020009549 -o app_doc_cont_refusal_reason.zip
```

## 3.10 意匠登録情報
指定された意匠出願番号に紐づく登録情報を取得するものです。

https://ip-data.jpo.go.jp/api/design/v1/registration_info/（出願番号）
のURLに対して、GETリクエストを実行します。なお、ヘッダーにはトークンを設定してください。
なお、出願番号は、2022012584のように、西暦４桁＋年間通番６桁を記載します。

以下に curl.exe のコマンド例を示します。これにより、新たにregistration_info.json.txt が生成されます。

```bat:コマンドプロンプト
curl -X GET -H "Authorization: Bearer （アクセストークン）"  https://ip-data.jpo.go.jp/api/design/v1/registration_info/2022012584 -o registration_info.json.txt
```

取得できるJSONの文字コードはUTF8です。キー項目とデータ型は以下です。

| キー項目         | キー項目名       |  データ型   | サイズ |
|:----------------|:----------------|:------------|:------------|
| result          | 取得結果    　　 | オブジェクト  | - |
| ⇒ statusCode   | ステータスコード | 文字列       | 3 |
| ⇒ errorMessage | エラーメッセージ | 文字列       | - |
| ⇒ remainAccessCount | 残アクセス数 | 文字列       | - |
| ⇒ data         | 詳細情報データ   | オブジェクト | - |

以下，dataオブジェクトの説明です。なお矢印は、オブジェクトまたは配列内の子項目を指します。

| キー項目         | キー項目名   |  データ型 | サイズ |
|:----------------|:------------|:------------|:------------|
|applicationNumber   | 出願番号       | 文字列       |10|
|filingDate    | 出願日    | 文字列     | 8 |
|registrationNumber| 登録番号 | 文字列 | 7 |
|registrationDate| 登録日      | 文字列 | 8 |
|decisionDate|査定日| 文字列 | 8 |
|appealTrialDecisiondDate|審決日| 文字列 | 8 |
|rightPersonInformation|権利者情報|配列| - |
|⇒ rightPersonCd| 権利者コード| 文字列      | 9 |
|⇒ rightPersonName| 権利者氏名・名称| 文字列      |1000|
|designArticle      | 意匠に係る物品                  | 文字列      |-|
|expireDate|存続期間満了年月日 | 文字列 | 8 |
|nextPensionPaymentDate|次期年金納付期限 | 文字列 | - |
|lastPaymentYearly|最終納付年分| 文字列 | - |
|erasureIdentifier|本権利抹消識別| 文字列 | - |
|disappearanceDate|本権利抹消日| 文字列 | 8 |
|updateDate|更新日付| 文字列 | 8 |

<details><summary>以下は、意匠登録情報のJSONの例です。（クリックで展開）</summary><div>

```json:意願2022-012584の意匠登録情報
{
	"result": {
		"statusCode": "100",
		"errorMessage": "",
		"remainAccessCount": "197",
		"data": {
			"applicationNumber": "2022012584",
			"filingDate": "20220523",
			"registrationNumber": "1735126",
			"registrationDate": "20230112",
			"decisionDate": "20221219",
			"appealTrialDecisiondDate": "",
			"rightPersonInformation": [
				{
					"rightPersonCd": "591037096",
					"rightPersonName": "フオルクスワーゲン・アクチエンゲゼルシヤフト"
				}
			],
			"designArticle": "乗用自動車",
			"expireDate": "20470512",
			"nextPensionPaymentDate": "20260112",
			"lastPaymentYearly": "03",
			"erasureIdentifier": "00",
			"disappearanceDate": "",
			"updateDate": "20230112"
		}
	}
}
```
</div></details>

## 3.11 J-PlatPatの固定アドレス
指定された出願番号に紐づくJ-PlatPatの固定アドレス情報を取得するものです。

https://ip-data.jpo.go.jp/api/design/v1/jpp_fixed_address/（出願番号）
のURLに対して、GETリクエストを実行します。なお、ヘッダーにはトークンを設定してください。
なお、出願番号は、2022012584のように、西暦４桁＋年間通番６桁を記載します。

以下に curl.exe のコマンド例を示します。これにより、新たにjpp_fixed_address.json.txt が生成されます。

```bat:コマンドプロンプト
curl -X GET -H "Authorization: Bearer （アクセストークン）"  https://ip-data.jpo.go.jp/api/design/v1/jpp_fixed_address/2022012584 -o jpp_fixed_address.json.txt
```

取得できるJSONの文字コードはUTF8です。キー項目とデータ型は以下です。

| キー項目         | キー項目名       |  データ型   | サイズ |
|:----------------|:----------------|:------------|:------------|
| result          | 取得結果    　　 | オブジェクト  | - |
| ⇒ statusCode   | ステータスコード | 文字列       | 3 |
| ⇒ errorMessage | エラーメッセージ | 文字列       | - |
| ⇒ remainAccessCount | 残アクセス数 | 文字列       | - |
| ⇒ data         | 詳細情報データ   | オブジェクト | - |

以下，dataオブジェクトの説明です。なお矢印は、オブジェクトまたは配列内の子項目を指します。

| キー項目         | キー項目名   |  データ型 | サイズ |
|:----------------|:------------|:------------|:------------|
|URL   | J-PlatPatの固定アドレス       | 文字列       |-|

<details><summary>以下は、J-PlatPatの固定アドレス情報のJSONの例です。（クリックで展開）</summary><div>

```json:意願2022-012584のJ-PlatPatの固定アドレス情報
{
	"result": {
		"statusCode": "100",
		"errorMessage": "",
		"remainAccessCount": "199",
		"data": {
			"URL": "https://www.j-platpat.inpit.go.jp/c1800/DE/JP-2022-012584/27DBA8496517D2F4B482AEB97A0FC03B7FCD90E236B6B4847FDC349CB22E6034/30/ja"
		}
	}
}
```
</div></details>

意匠情報取得APIをExcel等から使用するためのVBAクラスライブラリを作成いたしました。宜しければお使いください。

https://qiita.com/kenichiro_ayaki/items/12e6ef9ab1db0e513588