> ## Documentation Index > Fetch the complete documentation index at: https://docs.bizmori.com/llms.txt > Use this file to discover all available pages before exploring further. # Get order report > Get the status of a report and, when it is `completed`, its download URL. A locale with no report request returns `404 REPORT_NOT_FOUND`. A new `download.url` is issued on every call and expires after 300 seconds. An expired URL returns `403` from storage and cannot be renewed. Don't store the URL: call this endpoint when the user clicks download and open the returned URL right away. Returns `400 ORDER_EXPIRED` after the order's retention period ends, whatever the report status. ## OpenAPI ````yaml api-reference/openapi.yaml GET /api/v3/orders/{orderId}/reports/{locale} openapi: 3.0.0 info: title: BIZ MORI API version: 2.0.0 description: > BIZ MORI API provides four core services for digital content protection: - **Anti-AI**: Protect images from AI training - **Watermark Embed**: Embed invisible digital watermarks into images - **Watermark Extract**: Extract and verify watermarks from images - **AI Detection**: Detect whether an image is AI-generated - **Test API keys**: Keys with the `sk_test_` prefix use the same Bearer authentication and support order-lifecycle testing with mock responses without running processing services or consuming credits; test uploads discard file contents and do not create result files contact: name: BIZ MORI Support email: support@bizmori.com license: name: Proprietary url: https://docs.bizmori.com/legal/terms servers: - url: https://api.bizmori.com description: Production security: [] tags: - name: Anti-AI description: Anti-AI image protection orders - name: Watermark Embed description: Watermark embedding orders - name: Watermark Extract description: Watermark extraction orders - name: AI Detection description: AI-generated image detection orders - name: Orders description: Order query and management - name: Webhooks description: Webhook configuration and events - name: Reports description: PDF analysis reports for watermark extract and AI Detection orders paths: /api/v3/orders/{orderId}/reports/{locale}: get: tags: - Reports summary: Get an order report description: > Get the status of a report and, when it is `completed`, its download URL. A locale with no report request returns `404 REPORT_NOT_FOUND`. A new `download.url` is issued on every call and expires after 300 seconds. An expired URL returns `403` from storage and cannot be renewed. Don't store the URL: call this endpoint when the user clicks download and open the returned URL right away. Returns `400 ORDER_EXPIRED` after the order's retention period ends, whatever the report status. operationId: getOrderReport parameters: - in: path name: orderId required: true schema: type: string pattern: ^[0-9]{1,20}$ description: Order ID - in: path name: locale required: true schema: type: string enum: - ko-KR - en-US - ja-JP description: Report language responses: '200': description: >- Report resource in `queued`, `processing`, `completed`, or `failed` status. `download` is set only when `completed` content: application/json: schema: $ref: '#/components/schemas/OrderReportResponse' example: data: orderId: '1234567891' reportType: watermarkDetection locale: en-US status: completed download: url: https://s3.ap-northeast-2.amazonaws.com/... expiresInSeconds: 300 failure: null '400': description: >- Invalid request, the order type does not support the locale, or the order's retention period has ended content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' examples: validation: value: code: VALIDATION_FAILED locale: value: code: REPORT_LOCALE_UNSUPPORTED expired: value: code: ORDER_EXPIRED '401': $ref: '#/components/responses/Unauthorized' '404': description: >- The order does not exist, no report was requested for this locale, or the completed report file is missing content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' examples: order: value: code: ORDER_NOT_FOUND report: value: code: REPORT_NOT_FOUND '500': $ref: '#/components/responses/InternalError' '503': description: Report generation is temporarily unavailable content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: code: SERVICE_UNAVAILABLE security: - BearerAuth: [] x-codeSamples: - lang: curl label: cURL source: > curl -X GET https://api.bizmori.com/api/v3/orders/ORDER_ID/reports/en-US \ -H "Authorization: Bearer YOUR_API_KEY" - lang: javascript label: JavaScript source: > const orderId = 'ORDER_ID'; const locale = 'en-US'; const response = await fetch(`https://api.bizmori.com/api/v3/orders/${orderId}/reports/${locale}`, { headers: { 'Authorization': 'Bearer YOUR_API_KEY' } }); const { data } = await response.json(); if (data.status === 'completed') window.location.href = data.download.url; - lang: python label: Python source: | import requests order_id = 'ORDER_ID' locale = 'en-US' response = requests.get( f'https://api.bizmori.com/api/v3/orders/{order_id}/reports/{locale}', headers={'Authorization': 'Bearer YOUR_API_KEY'} ) data = response.json()['data'] if data['status'] == 'completed': pdf = requests.get(data['download']['url']).content components: schemas: OrderReportResponse: type: object required: - data properties: data: $ref: '#/components/schemas/OrderReportResource' ErrorResponse: type: object properties: code: type: string description: Error code OrderReportResource: type: object required: - orderId - reportType - locale - status - download properties: orderId: type: string description: Order ID reportType: type: string enum: - watermarkDetection - aiDetection description: Set by BIZ MORI from the order type locale: type: string enum: - ko-KR - en-US - ja-JP status: type: string enum: - queued - processing - completed - failed description: Report generation status download: nullable: true description: Download information. Present only when `status` is `completed` allOf: - $ref: '#/components/schemas/OrderReportDownload' failure: nullable: true description: Failure information. Present only when `status` is `failed` allOf: - $ref: '#/components/schemas/OrderReportFailure' OrderReportDownload: type: object required: - url - expiresInSeconds properties: url: type: string format: uri description: > Presigned PDF URL, valid for 300 seconds. Watermark reports download as `-report-.pdf` (for example `Spring campaign-report-en-US.pdf`). Call the report endpoint again for a new URL instead of storing this one. expiresInSeconds: type: integer enum: - 300 OrderReportFailure: type: object required: - code - retryable properties: code: type: string enum: - REPORT_GENERATION_FAILED - REPORT_NOT_AVAILABLE retryable: type: boolean description: > `true` if calling `POST /api/v3/orders/{orderId}/reports` again for the same order and locale starts a new attempt. Watermark reports become `false` after 3 failed attempts. responses: Unauthorized: description: Authentication failed content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: code: AUTH_NOT_AUTHENTICATED InternalError: description: Internal server error content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: code: SERVER_INTERNAL_ERROR securitySchemes: BearerAuth: type: http scheme: bearer description: >- Bearer API key for external client access. Live keys use the `sk_` prefix; test keys use the `sk_test_` prefix and support order-lifecycle testing with mock responses without processing or credit usage. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.