{ "components": { "callbacks": {}, "examples": {}, "headers": {}, "links": {}, "parameters": {}, "pathItems": {}, "requestBodies": {}, "responses": {}, "schemas": {}, "securitySchemes": { "bearerAuth": { "scheme": "bearer", "type": "http" } } }, "info": { "description": "", "title": "edinet", "version": "1", "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" } }, "x-aisa-catalogs": { "edinet": { "description": "", "title": "edinet", "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" } }, "x-aisa-document": { "facts_hash": "e99476d645d65d34a7a7c24a39d9a83e3fd151a56e7d95967a467097d0fb477b", "generator_version": "3", "protocol_version": "1", "schema_version": "1" }, "x-aisa-plans": { "builder": 1.0, "display_plan": "payg", "payg": 1.0, "similarweb_payg": 1.0, "team": 1.0, "version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb" } } }, "x-aisa-configured-paths": [ "/apis/v1/edinet/documents.json", "/apis/v1/edinet/documents/{docID}" ], "x-aisa-document": { "composer_version": "28", "document_hash": "sha256:9835708c41059a06d71b0e486ff9f7b33e095f05a7e253f874334c51b9d474f4", "facts_hash": "e99476d645d65d34a7a7c24a39d9a83e3fd151a56e7d95967a467097d0fb477b", "generator_version": "3", "identity_base_document_hash": "sha256:2fe74b3a3d8a0123989f3e16e7fde4b8e73e16f5d978fdc2550e34b2eb6f1dda", "identity_compatibility_hash": "sha256:658232bfe1bd4a916be1b52f15bc608d71508e519da36188c758e46a1ee49f9a", "protocol_version": "1", "response_pending": [], "schema_version": "1" }, "x-aisa-plans": { "builder": 1.0, "display_plan": "payg", "payg": 1.0, "similarweb_payg": 1.0, "team": 1.0, "version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb" }, "x-aisa-provider": "edinet" }, "jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema", "openapi": "3.1.0", "paths": { "/apis/v1/edinet/documents.json": { "get": { "description": "{\"methods\":[{\"methodType\":\"GET\",\"methodDesc\":\"Query the EDINET filing list for a given file date. Returns metadata only when type=1, or metadata plus filing results when type=2.\",\"requestParams\":[{\"paramName\":\"date\",\"paramType\":\"query\",\"required\":true,\"desc\":\"File date in YYYY-MM-DD format.\"},{\"paramName\":\"type\",\"paramType\":\"query\",\"desc\":\"Response mode: 1 for metadata only, 2 for metadata plus filing list. Defaults to 1 when omitted.\"},{\"paramName\":\"Subscription-Key\",\"paramType\":\"query\",\"required\":true,\"desc\":\"EDINET API key passed as a query parameter.\"}],\"responseParams\":[{\"paramName\":\"metadata\",\"desc\":\"Metadata object with title, request parameter echo, result count, processDateTime, status, and message.\"},{\"paramName\":\"results\",\"desc\":\"Array of filing document objects when type=2, including fields such as seqNumber, docID, filerName, docTypeCode, submitDateTime, and file availability flags.\"}]}]}\n\n\n公开参考价格：每次成功请求 $0.00001 USD。 最终费用以账户适用价格及实际结算为准。\n", "operationId": "getEdinetDocuments", "parameters": [ { "description": "文件日期，格式为 YYYY-MM-DD。", "in": "query", "name": "date", "required": true, "schema": { "examples": [ "2026-07-23" ], "format": "date", "type": "string" } }, { "description": "响应模式：1 仅返回元数据，2 返回元数据加申报列表。", "in": "query", "name": "type", "required": false, "schema": { "default": 1, "enum": [ 1, 2 ], "type": "integer" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "metadata": { "description": "元数据对象，包含标题、请求参数回显、结果数量、processDateTime、status 和 message。", "type": "object" }, "results": { "description": "type=2 时返回的申报文档对象。", "items": { "properties": { "docID": { "type": "string" }, "docTypeCode": { "type": "string" }, "filerName": { "type": "string" }, "seqNumber": { "type": "integer" }, "submitDateTime": { "type": "string" } }, "type": "object" }, "type": "array" } }, "type": "object" } } }, "description": "EDINET 文档列表响应。" }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "Document List API", "tags": [ "default" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "mpp": true, "mpp_methods": [ "GET" ], "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "x402": false }, "x-aisa-catalog-id": "edinet", "x-aisa-category": "general", "x-aisa-docs-url": "https://aisa.one/docs/api-reference/financial/get_edinet-documents", "x-aisa-identity": { "canonical_operation_id": "get_edinet_documents", "historical_aliases": [ { "canonical_source_file": "openapi/edinet.json", "canonical_source_sha256": "288bc100a3e41d50606fa122d6f2a5d6ab2a71b7d4de8b3cb4eea7dbb940dac4", "locale": "zh", "method": "GET", "operation_id": "getEdinetDocuments", "public_path": "/apis/v1/edinet/documents.json", "published_ref": "e0ee9af05d7407976af62a72ac4e3499703a4f6a", "source_file": "openapi/zh/edinet.json", "source_sha256": "41707f0811e00ce951315621989decb027259048c3a7a331c9d3f035586baa14" } ], "schema_version": 1, "sha256": "sha256:40cd330a4d2e4dd4d5b5937c7d60de8770c96f5edf9dab3fe21fadbf1361b948" }, "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_pricing": "fixed_success", "default_request_estimate_usd": 1e-05, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-response-source": { "content_hash": "sha256:b15b8de78a865270661dd10b2350b9180efff025c966aaac5ab47e749184a901", "kind": "upstream_success_contract", "source": { "content_hash": "sha256:5fb067942217910574a7b2c9e0460301c3ed4d1eec5312448058f849497e9b3e", "converter": "scripts/import_existing_contracts.py@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:64fe8769d1733df1e068c095785c7bec0d36f6f170eab3723c716cc5751c8a4d", "refresh_policy": "manual", "review_period_days": 30, "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/edinet.json" } }, "x-aisa-revision": { "customer_pricing_ref": "da34ca3458ba", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "84e80e3cefd0" }, "x-aisa-runtime-operation": { "method": "ANY", "operation_id": "get_edinet_documents", "path": "/apis/v1/edinet/documents.json" }, "x-aisa-source": { "content_hash": "sha256:5fb067942217910574a7b2c9e0460301c3ed4d1eec5312448058f849497e9b3e", "converter": "scripts/import_existing_contracts.py@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:64fe8769d1733df1e068c095785c7bec0d36f6f170eab3723c716cc5751c8a4d", "refresh_policy": "manual", "review_period_days": 30, "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/edinet.json" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v2/documents.json", "x-aisa-validation": "provider", "x-codeSamples": [ { "label": "Reference example", "lang": "text", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/edinet/documents.json?date=2026-07-23' \\\n --header 'Authorization: Bearer '" } ] } }, "/apis/v1/edinet/documents/{docID}": { "get": { "description": "{\"methods\":[{\"methodType\":\"GET\",\"methodDesc\":\"Download a specific EDINET document by docID. The returned file type is selected by the type query parameter and the actual success payload must be interpreted from Content-Type.\",\"requestParams\":[{\"paramName\":\"docID\",\"paramType\":\"path\",\"required\":true,\"desc\":\"Document management identifier from the document list API, for example S1234567.\"},{\"paramName\":\"type\",\"paramType\":\"query\",\"required\":true,\"desc\":\"File type to download: 1 for filing body and audit report ZIP, 2 for PDF, 3 for alternate document and attachments ZIP, 4 for English document ZIP, 5 for CSV ZIP converted from XBRL.\"},{\"paramName\":\"Subscription-Key\",\"paramType\":\"query\",\"required\":true,\"desc\":\"EDINET API key passed as a query parameter.\"}],\"responseParams\":[{\"paramName\":\"Content-Type\",\"desc\":\"Response MIME type. application/octet-stream indicates ZIP, application/pdf indicates PDF, and application/json; charset=utf-8 indicates an error JSON response.\"},{\"paramName\":\"content\",\"desc\":\"Binary ZIP or PDF file content on success.\"},{\"paramName\":\"message\",\"desc\":\"Error message when the response body is JSON.\"}]}]}\n\n\n公开参考价格：每次成功请求 $0.00001 USD。 最终费用以账户适用价格及实际结算为准。\n", "operationId": "getEdinetDocumentDownload", "parameters": [ { "description": "来自文档列表 API 的文档管理标识符。", "in": "path", "name": "docID", "required": true, "schema": { "examples": [ "S1000000" ], "type": "string" } }, { "description": "要下载的文件类型：1 为申报正文和审计报告 ZIP，2 为 PDF，3 为替代文档及附件 ZIP，4 为英文文档 ZIP，5 为由 XBRL 转换的 CSV ZIP。", "in": "query", "name": "type", "required": true, "schema": { "enum": [ 1, 2, 3, 4, 5 ], "type": "integer" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "message": { "type": "string" } }, "type": "object" } }, "application/octet-stream": { "schema": { "format": "binary", "type": "string" } }, "application/pdf": { "schema": { "format": "binary", "type": "string" } } }, "description": "根据 Content-Type，返回二进制 ZIP/PDF 文件内容或 JSON 错误载荷。" }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "Document Download API", "tags": [ "default" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "mpp": true, "mpp_methods": [ "GET", "POST", "PUT", "PATCH", "DELETE", "HEAD", "OPTIONS", "TRACE" ], "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "x402": false }, "x-aisa-catalog-id": "edinet", "x-aisa-category": "general", "x-aisa-docs-url": "https://aisa.one/docs/api-reference/financial/get_edinet-documents-docid", "x-aisa-identity": { "canonical_operation_id": "get_edinet_document_download", "historical_aliases": [ { "canonical_source_file": "openapi/edinet.json", "canonical_source_sha256": "288bc100a3e41d50606fa122d6f2a5d6ab2a71b7d4de8b3cb4eea7dbb940dac4", "locale": "zh", "method": "GET", "operation_id": "getEdinetDocumentDownload", "public_path": "/apis/v1/edinet/documents/{docID}", "published_ref": "e0ee9af05d7407976af62a72ac4e3499703a4f6a", "source_file": "openapi/zh/edinet.json", "source_sha256": "41707f0811e00ce951315621989decb027259048c3a7a331c9d3f035586baa14" } ], "schema_version": 1, "sha256": "sha256:04850b2640c4ef292c7ffd868b2d4fe0f8df17821a7d483ecc359501a7db055a" }, "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_pricing": "fixed_success", "default_request_estimate_usd": 1e-05, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-response-source": { "content_hash": "sha256:7eee0d83f0ce6854787580119b690ed227c13c6f5126373f3dc510848cecb266", "kind": "upstream_success_contract", "source": { "content_hash": "sha256:5fb067942217910574a7b2c9e0460301c3ed4d1eec5312448058f849497e9b3e", "converter": "scripts/import_existing_contracts.py@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:64fe8769d1733df1e068c095785c7bec0d36f6f170eab3723c716cc5751c8a4d", "refresh_policy": "manual", "review_period_days": 30, "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/edinet.json" } }, "x-aisa-revision": { "customer_pricing_ref": "da34ca3458ba", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "a83aa014e4e1" }, "x-aisa-runtime-operation": { "method": "ANY", "operation_id": "get_edinet_document_download", "path": "/apis/v1/edinet/documents/{docID}" }, "x-aisa-source": { "content_hash": "sha256:5fb067942217910574a7b2c9e0460301c3ed4d1eec5312448058f849497e9b3e", "converter": "scripts/import_existing_contracts.py@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:64fe8769d1733df1e068c095785c7bec0d36f6f170eab3723c716cc5751c8a4d", "refresh_policy": "manual", "review_period_days": 30, "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/edinet.json" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v2/documents/{docID}", "x-aisa-validation": "provider" } } }, "security": [ { "bearerAuth": [] } ], "servers": [ { "url": "https://api.aisa.one" } ] }