# Get the approvals on an approval's order ```http GET https://secure.yoprint.com/v1/api/store/{team_slug}/approvals/{hash_id} ``` - API version: v1 - Operation ID: `v1_public_approvals_show` - Section: Sales › [Approvals](https://developer.yoprint.com/reference/approvals.md) - Web page: https://developer.yoprint.com/reference/approvals/v1-approvals-show/ - Authentication: `Authorization: Bearer YOUR_API_KEY` Looks up the approval, then returns **every approval on the same order or quote**, as a list: job and order approvals, completed or not. Find the one you asked for by `id`. Each item has the approval's notes, status and signature, and who completed it: `approved_by` is `contact`, with `approved_by_contact_id`, when a Customer Portal contact did. Job approvals also have `items` (each mockup or design with its own status and the customer's notes) and `mockup` (the images). ## Permission Any member of the team. ## Path parameters - `team_slug` (string, required): Your team slug, shown as Team ID next to your API key in Profile. Example `your-team`. - `hash_id` (string, required): The approval's `id`, from the approvals list. A hash id; unique keys and document numbers are refused with 404. Example `Fi0zPeMlwKadEo`. ## Request body This operation takes no request body. ### Example request ```bash curl 'https://secure.yoprint.com/v1/api/store/your-team/approvals/Fi0zPeMlwKadEo' \ -H 'Authorization: Bearer YOUR_API_KEY' \ -H 'Accept: application/json' \ -H 'X-Yoprint-Decimal-Format: exact-v1' ``` ## Response `200` Successful response. Fields: - `data` (array of objects, required) - Each item: - `approved_by` (string, optional): `contact` when a Customer Portal contact completed it (`approved_by_contact_id`). `user` when a team member completed it. Otherwise `customer`, even before anyone has approved it. One of: `"contact"`, `"user"`, `"customer"`. - `approved_by_contact_id` (string | null, optional): The contact who completed it in the Customer Portal, when YoPrint knows which contact it was. Null otherwise. - `approved_by_user` (string | null, optional): The hash id of the team member who completed it on the customer's behalf, if any. - `completed` (boolean, optional): True once the customer finished, whether they approved or asked for changes. - `completed_at` (string (date-time) | null, optional) - `created_at` (string (date-time), optional) - `customer_last_viewed_contact_id` (string | null, optional): The last contact known to have opened it in the Customer Portal. Null when none is known. - `customer_last_viewed_date` (string (date-time) | null, optional) - `id` (string, optional) - `items` (array of objects, optional): Job approvals: each mockup file or design, in order, with its own status and notes. `media` items also carry the file's details and expiring links; `mockup_design` items carry the design's revision and page previews. An empty list for order approvals. - Each item: - `id` (string, optional): The item's id. - `media_id` (string | null, optional): `media` items: the file's id. - `mockup_design_id` (string | null, optional): `mockup_design` items: the design's id. - `name` (string | null, optional) - `notes_from_customer` (string | null, optional) - `notes_to_customer` (string | null, optional) - `position` (integer, optional) - `status` (string, optional): One of: `"pending-approval"`, `"approved"`, `"need-changes"`. - `type` (string, optional): `media`: an uploaded mockup file. `mockup_design`: a design made in the mockup designer. One of: `"media"`, `"mockup_design"`. - `job_id` (string | null, optional): Job approvals only. - `job_name` (string, optional): An empty string for order approvals. - `job_scoped_id` (string, optional): The job number, such as `JOB-1001`. An empty string for order approvals. - `mockup` (array of objects | null, optional): Job approvals: the uploaded mockup files only (designs are only in `items`); an empty list when there are none. Null for order approvals. - Each item: - `created_at` (string (date-time), optional) - `file_name` (string, optional) - `id` (string, optional): The same id as the matching `media` item in `items`. - `media_id` (string, optional): The file's id. - `mime_type` (string, optional) - `name` (string, optional) - `notes_from_customer` (string | null, optional) - `notes_to_customer` (string | null, optional) - `position` (integer, optional) - `status` (string, optional): One of: `"pending-approval"`, `"approved"`, `"need-changes"`. - `url` (string, optional): A signed download link. It expires; don't store it. - `notes_from_customer` (string | null, optional) - `notes_to_customer` (string | null, optional) - `order_external_type` (string | null, optional) - `order_id` (string | null, optional) - `order_object_type` (string | null, optional): `sales_order` or `quote`. One of: `"sales_order"`, `"quote"`. - `order_quote` (boolean, optional): True when the approval is on a quote. - `order_scoped_id` (string, optional): The order or quote number. - `request_by` (string | null, optional): A team member's hash id, or null. Approvals created in the web app or through the API are null here: neither records who requested them. - `signature` (string | null, optional): The customer's signature, when they signed. - `signed_terms_text` (string | null, optional): The terms the customer agreed to when signing. - `status` (string, optional): `pending`: not sent yet. `sent-to-customer`: emailed. `viewed-by-customer`: the customer opened it. `need-changes`: the customer finished and asked for changes ("Review requested"). `completed`: approved. One of: `"pending"`, `"sent-to-customer"`, `"viewed-by-customer"`, `"need-changes"`, `"completed"`. - `type` (string, optional): `job`: artwork approval for one job's mockups. `order`: approval of the whole order. One of: `"job"`, `"order"`. - `status` (integer, required) - `success` (boolean, required) Example response: ```json { "data": [ { "approved_by": "customer", "approved_by_contact_id": null, "approved_by_user": null, "completed": false, "completed_at": null, "created_at": "2026-11-03T09:30:00+00:00", "customer_last_viewed_contact_id": null, "customer_last_viewed_date": null, "id": "Fi0zPeMlwKadEo", "items": [ { "collection": "mockup", "created_at": "2026-11-03T09:30:00+00:00", "download_url": "https://example.com/media/front-logo.png?download=1", "file_name": "front-logo.png", "id": "Top25MBL9YyCKV", "is_image": true, "media_id": "b0l2VJxwa3ppc7", "mime_type": "image/png", "name": "front-logo", "notes_from_customer": null, "notes_to_customer": null, "position": 1, "preview": { "large": "https://example.com/media/front-logo-1200.png", "medium": "https://example.com/media/front-logo-800.png", "small": "https://example.com/media/front-logo-250.png" }, "preview_url": "https://example.com/media/front-logo-800.png", "show_in_pdf": null, "size": 182044, "status": "pending-approval", "type": "media", "url": "https://example.com/media/front-logo.png?download=1", "view_url": "https://example.com/media/front-logo.png" } ], "job_id": "K6iF8n29iwOZnj", "job_name": "Front logo", "job_scoped_id": "JOB-1001", "mockup": [ { "collection": "mockup", "created_at": "2026-11-03T09:30:00+00:00", "file_name": "front-logo.png", "id": "Top25MBL9YyCKV", "is_image": true, "media_id": "b0l2VJxwa3ppc7", "mime_type": "image/png", "name": "front-logo", "notes_from_customer": null, "notes_to_customer": null, "position": 1, "preview": { "large": "https://example.com/media/front-logo-1200.png", "medium": "https://example.com/media/front-logo-800.png", "small": "https://example.com/media/front-logo-250.png" }, "show_in_pdf": null, "size": 182044, "status": "pending-approval", "url": "https://example.com/media/front-logo.png?download=1", "view_url": "https://example.com/media/front-logo.png" } ], "notes_from_customer": null, "notes_to_customer": "Please check the logo size.", "order_external_type": null, "order_id": "V4keXwwxMQyXw7", "order_object_type": "sales_order", "order_quote": false, "order_scoped_id": "SO1001", "request_by": null, "signature": null, "signed_terms_text": null, "status": "sent-to-customer", "type": "job" } ], "status": 200, "success": true } ``` ## Errors - `401` The API key is missing or wrong (`unauthenticated`). - `403` You are not allowed to do this. `api_access_not_in_plan`: your team's plan doesn't include API access (Pro and above, with an active subscription or trial), so every request answers this until the team upgrades. When your role lacks the permission the operation needs, the body is only `{"message": "Insufficient Permission"}`. Other refusals use the error envelope, with `unauthorized` or `user_is_not_authorized`. - `404` Not found. `page_not_found`: the team slug is unknown, you are not a member of the team, or an id in the path is not one of this team's. `code: null`, with a message that starts "No query results for": there is no record with that id. - When: No approval of this team has this id, or its order came from Shopify. Fix: Use an `id` from the approvals list. ## Notes - Unlike the list, this includes approvals on draft orders. ## Related - [List approvals](https://developer.yoprint.com/reference/approvals/v1-approvals-index.md): `GET /v1/api/store/{team_slug}/approvals` - [Get an order approval](https://developer.yoprint.com/reference/sales-order-approvals/v2-order-approval-show.md): `GET /v2/api/store/{team_slug}/v2/sales_order/{hash_id}/approval/{hash_id2}`