> ## Documentation Index > Fetch the complete documentation index at: https://print.app/docs/llms.txt > Use this file to discover all available pages before exploring further. # Get a PDF profile > Returns one PDF profile, with every setting. A password is never shown, only `hasPassword`. ## OpenAPI ````yaml openapi.json GET /v2/pdf-profiles/{id} openapi: 3.1.0 info: title: Print.App API version: 2.1.0 description: >- Server-to-server API for Print.App integrations: designs and their page content, folders, files, fonts, palettes, product assignments, projects and editor links. Authenticate every request with a secret key: `Authorization: Bearer sk_…`. Never call it from a browser. servers: - url: https://api.print.app description: Production security: - bearerAuth: [] tags: - name: Account description: The account a secret key belongs to. - name: Designs description: >- The designs (templates) your customers start from: create them at a size, manage their pages, and place text, images and shapes on them. - name: Design folders description: >- Folders that organise your designs. A design can sit in more than one folder. - name: Files description: >- Your own images and graphics, used in designs and offered to customers in the editor. - name: Graphic folders description: >- Folders of files, shown in the editor under Pictures, Backgrounds, Textures or Frames. - name: Fonts description: >- The fonts your designs and customers can use: the built-in set, imported Google fonts and fonts you upload. - name: Palettes description: Colour palettes offered in the editor. - name: Products description: Which designs open for each product (and variant) in your store. - name: Projects description: Your customers' saved designs. - name: Links description: Shareable editor links that open a design or project at create.print.app. - name: Connectors description: >- Links between the options on a store's product page and the editor: the choice a customer makes shows the right pages, opens the right design, or sets the size, orientation or colour. Read a product page for what a connector can point at, and test one against a design before customers meet it. - name: Resource profiles description: >- Limits on the fonts, colour palettes and graphic folders the editor offers, for the designs that use them. - name: PDF profiles description: >- The settings print PDFs are made with: colour conversion, PDF standard, cut lines, image resolution, fonts. paths: /v2/pdf-profiles/{id}: get: tags: - PDF profiles summary: Get a PDF profile description: >- Returns one PDF profile, with every setting. A password is never shown, only `hasPassword`. operationId: getPdfProfile parameters: - name: id in: path required: true schema: type: string description: The profile id (`pdf_profile_…`, or a built-in `_default_…`). responses: '200': description: OK. headers: x-request-id: $ref: '#/components/headers/RequestId' content: application/json: schema: $ref: '#/components/schemas/PdfProfile' '401': description: Missing, unknown, revoked or expired secret key. headers: x-request-id: $ref: '#/components/headers/RequestId' content: application/json: schema: $ref: '#/components/schemas/Error' example: error: true code: unauthorized message: >- Missing or invalid secret key. Send it as "Authorization: Bearer sk_…". requestId: FZn-uhymjoEEJow= '403': description: The account is suspended for an unpaid invoice. headers: x-request-id: $ref: '#/components/headers/RequestId' content: application/json: schema: $ref: '#/components/schemas/Error' example: error: true code: account_suspended message: >- This account is suspended. Settle the outstanding invoice in the Print.App dashboard. requestId: FZn-uhymjoEEJow= '404': description: >- Not found in your account. Another account's resources answer 404 too. headers: x-request-id: $ref: '#/components/headers/RequestId' content: application/json: schema: $ref: '#/components/schemas/Error' example: error: true code: not_found message: Not found. requestId: FZn-uhymjoEEJow= '429': description: >- Rate limited by the API gateway. Back off and retry. This response comes from the gateway, so its body is `{ "message": "Too Many Requests" }`, not the standard error. content: application/json: schema: $ref: '#/components/schemas/GatewayError' example: message: Too Many Requests '500': description: >- Something failed on our side. Retry; quote the requestId to support if it persists. headers: x-request-id: $ref: '#/components/headers/RequestId' content: application/json: schema: $ref: '#/components/schemas/Error' example: error: true code: internal_error message: >- Something went wrong on our side. Retry the request; if it keeps failing, contact support with the requestId. requestId: FZn-uhymjoEEJow= components: headers: RequestId: description: Identifies the request. Quote it when contacting support. schema: type: string schemas: PdfProfile: title: PdfProfile description: The settings the print PDF of a design is made with. type: object required: - object - id - title - description - builtIn - compatibility - colorProfile - embedIccProfile - renderSpotColors - renderInvisibleLayers - renderMarks - includeScreenshot - renderDieline - dielineSpot - dielineWidth - downsampleImages - downsampleResolution - jpegQuality - convertImageColorSpace - embedIccProfileInImages - honorImageIccProfile - interpolateImages - imageRenderingIntent - embedFonts - subsetFonts - flattenFonts - requirePassword - hasPassword - created - modified properties: object: type: string const: pdf_profile id: type: string title: type: - string - 'null' description: type: - string - 'null' builtIn: type: boolean description: >- Provided by Print.App: it cannot be changed; make your own with basedOn. compatibility: type: string description: The PDF version or standard. Default 1.7. colorProfile: type: - string - 'null' description: >- Convert colours to this output profile (`cmyk-coated-fogra39` for European coated stock, `cmyk-us-web-coated-swop` for US, `sRGB` for digital and photo printers). `null`: no conversion. embedIccProfile: type: boolean description: Embed the output profile in the PDF. renderSpotColors: type: boolean description: Keep spot colours (foils, Pantone) as separate inks. renderInvisibleLayers: type: boolean description: Include hidden layers (such as a white underbase). renderMarks: type: boolean description: Add crop and bleed marks. includeScreenshot: type: boolean description: Add a page with a flat preview of the design. renderDieline: type: boolean description: >- Draw the cut line of die-cut pages (stickers, labels) as a named spot stroke. dielineSpot: type: string description: >- The cut line's spot colour name, as the cutter expects it. Default CutContour. dielineWidth: type: number description: The cut line's width in points. Default 0.25. downsampleImages: type: boolean description: Reduce images above `downsampleResolution`, for smaller files. downsampleResolution: type: number description: Pixels per inch images are reduced to. Default 300. jpegQuality: type: number description: JPEG quality of reduced images. Default 91. convertImageColorSpace: type: boolean description: Convert images to the output profile too (needs colorProfile). embedIccProfileInImages: type: boolean honorImageIccProfile: type: boolean description: Use each image's own colour profile when converting it. interpolateImages: type: boolean description: Smooth images when they are enlarged. imageRenderingIntent: type: string description: How out-of-gamut image colours are mapped. Default Auto. embedFonts: type: boolean description: Embed fonts, so the printer needs none installed. subsetFonts: type: boolean description: Embed only the characters used. flattenFonts: type: boolean description: Turn text into outlines (no fonts in the PDF at all). requirePassword: type: boolean description: The PDF opens only with `password`. hasPassword: type: boolean description: A password is set (it is never shown). created: type: - string - 'null' format: date-time modified: type: - string - 'null' format: date-time Error: title: Error description: >- Every error the API itself returns. Match on `code`; `message` is for people and may be reworded. type: object required: - error - code - message - requestId properties: error: type: boolean const: true code: type: string enum: - unauthorized - account_suspended - invalid_request - not_found - route_not_found - idempotency_key_reused - idempotency_in_progress - folder_not_empty - builtin_folder - builtin_palette - editor_not_supported - design_changed - payload_too_large - unsupported_media_type - ops_failed - internal_error - service_unavailable description: >- `unauthorized` (401): missing, unknown, revoked or expired secret key. `account_suspended` (403): the account has an unpaid invoice. `invalid_request` (400): a parameter or body field is malformed — see `param` and `details`. `not_found` (404): no such resource in your account. `route_not_found` (404): no such endpoint. `idempotency_key_reused` (409): the Idempotency-Key was used for a different request. `idempotency_in_progress` (409): the first request with that key is still running. `folder_not_empty` (409): the folder still holds designs or folders. `builtin_folder`, `builtin_palette` (409): Print.App's own folders and palettes cannot be changed. `editor_not_supported` (409): page content can only be edited on accounts that use the new editor. `design_changed` (409): the design was saved elsewhere while the batch ran; read it again and retry. `payload_too_large` (413): a body or file over the limit. `unsupported_media_type` (415): send JSON. `ops_failed` (422): an operation in the batch failed, nothing was saved — see `details`. `internal_error` (500): retry; contact support with the `requestId` if it persists. `service_unavailable` (503): retry in a few seconds. message: type: string param: type: string description: The parameter or body field at fault, as a path (`pages[0].title`). details: type: array description: >- Every problem found, when there was more than one (`invalid_request`), or each operation's result (`ops_failed`). items: type: object requestId: type: string description: >- Also sent as the `x-request-id` header. Quote it when contacting support. examples: - error: true code: invalid_request message: limit must be an integer from 1 to 100. param: limit requestId: FZn-uhymjoEEJow= GatewayError: type: object properties: message: type: string description: Returned by the API gateway itself (429). securitySchemes: bearerAuth: type: http scheme: bearer description: >- A secret key from Print.App admin → Domains → Secret keys, sent as `Authorization: Bearer sk_…`. Server-side only. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.