--- title: "GET /v1/autofills/{jobId}" method: GET path: "/v1/autofills/{jobId}" tags: ["autofill"] --- # GET /v1/autofills/{jobId} `GET /v1/autofills/{jobId}` To use this API, your integration must act on behalf of a user who is a member of a [Canva Enterprise](https://www.canva.com/enterprise/) organization. Users on Canva paid plans have access to a limited trial while your integration is under development. For more information, see [Trial quotas](https://www.canva.dev/docs/connect/api-requests-responses/#trial-quotas). Get the result of a design autofill job that was created using the [Create design autofill job API](https://www.canva.dev/docs/connect/api-reference/autofills/create-design-autofill-job/). You might need to make multiple requests to this endpoint until you get a `success` or `failed` status. For more information on the workflow for using asynchronous jobs, see [API requests and responses](https://www.canva.dev/docs/connect/api-requests-responses/#asynchronous-job-endpoints). ## Path parameters - `jobId` string, required ## Response `200` OK - GetDesignAutofillJobResponse - `job` DesignAutofillJob, required — Details about the autofill job. - `id` string, required — ID of the asynchronous job that is creating the design using the provided data. - `status` 'in_progress' | 'success' | 'failed', required — Status of the design autofill job. - `result` union — Result of the design autofill job. Only present if job status is `success`. - object — A new autofilled design has been created and saved to the user's root folder. - `type` 'create_design', required - `design` DesignSummary, required — Basic details about the design, such as the design's ID, title, and URL. - `id` string, required — The design ID. - `title` string — The design title. - `url` string — URL of the design. - `thumbnail` Thumbnail — A thumbnail image representing the object. - `width` integer, required — The width of the thumbnail image in pixels. - `height` integer, required — The height of the thumbnail image in pixels. - `url` string, required — A URL for retrieving the thumbnail image. This URL expires after 15 minutes. This URL includes a query string that's required for retrieving the thumbnail. - `urls` DesignLinks, required — A temporary set of URLs for viewing or editing the design. - `edit_url` string, required — A temporary editing URL for the design. This URL is only accessible to the user that made the API request, and is designed to support [return navigation](https://www.canva.dev/docs/connect/return-navigation-guide/) workflows. NOTE: This is not a permanent URL, it is only valid for 30 days. - `view_url` string, required — A temporary viewing URL for the design. This URL is only accessible to the user that made the API request, and is designed to support [return navigation](https://www.canva.dev/docs/connect/return-navigation-guide/) workflows. NOTE: This is not a permanent URL, it is only valid for 30 days. - `created_at` integer, required — When the design was created in Canva, as a Unix timestamp (in seconds since the Unix Epoch). - `updated_at` integer, required — When the design was last updated in Canva, as a Unix timestamp (in seconds since the Unix Epoch). - `page_count` integer — The total number of pages in the design. Some design types don't have pages (for example, Canva docs). - `trial_information` AutofillTrialInformation — WARNING: Trials and trial information are a [preview feature](https://www.canva.dev/docs/connect/#preview-apis). There might be unannounced breaking changes to this feature which won't produce a new API version. Trial information for non-enterprise users. Non-enterprise users have a limited number of autofill uses. Once the trial is exhausted, users must upgrade to [Canva Enterprise](https://www.canva.com/enterprise/) to continue using the Autofill API. - `uses_remaining` integer, required — The number of uses remaining in the free trial. - `upgrade_url` string, required — The URL for a user to upgrade their Canva account to Canva Enterprise. - object — The existing design has been autofilled in place. WARNING: Autofilling an existing design in place is a [preview feature](https://www.canva.dev/docs/connect/#preview-apis). There might be unannounced breaking changes to this feature which won't produce a new API version. - `type` 'update_design', required - `design` DesignSummary, required — Basic details about the design, such as the design's ID, title, and URL. - `id` string, required — The design ID. - `title` string — The design title. - `url` string — URL of the design. - `thumbnail` Thumbnail — A thumbnail image representing the object. - `width` integer, required — The width of the thumbnail image in pixels. - `height` integer, required — The height of the thumbnail image in pixels. - `url` string, required — A URL for retrieving the thumbnail image. This URL expires after 15 minutes. This URL includes a query string that's required for retrieving the thumbnail. - `urls` DesignLinks, required — A temporary set of URLs for viewing or editing the design. - `edit_url` string, required — A temporary editing URL for the design. This URL is only accessible to the user that made the API request, and is designed to support [return navigation](https://www.canva.dev/docs/connect/return-navigation-guide/) workflows. NOTE: This is not a permanent URL, it is only valid for 30 days. - `view_url` string, required — A temporary viewing URL for the design. This URL is only accessible to the user that made the API request, and is designed to support [return navigation](https://www.canva.dev/docs/connect/return-navigation-guide/) workflows. NOTE: This is not a permanent URL, it is only valid for 30 days. - `created_at` integer, required — When the design was created in Canva, as a Unix timestamp (in seconds since the Unix Epoch). - `updated_at` integer, required — When the design was last updated in Canva, as a Unix timestamp (in seconds since the Unix Epoch). - `page_count` integer — The total number of pages in the design. Some design types don't have pages (for example, Canva docs). - `error` AutofillError — If the autofill job fails, this object provides details about the error. - `code` 'autofill_error' | 'thumbnail_generation_error' | 'create_design_error' | 'design_approval_error' | 'trial_quota_exceeded' | 'design_update_error', required - `message` string, required — A human-readable description of what went wrong. ## Other responses - `403` — Forbidden - `404` — Not Found - `default` — Error Response --- [API](https://skmtc.net/canva/apis/canva-connect-api.md) · [All operations](https://skmtc.net/canva/apis/canva-connect-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/canva/canva-connect-api/revisions/360bf0176ab2/schema)