> ## Documentation Index > Fetch the complete documentation index at: https://docs.doconda.com/llms.txt > Use this file to discover all available pages before exploring further. # Recoger una conversión > Una conversión que tardó más de 120 s, o un enlace nuevo al archivo convertido. ## OpenAPI ````yaml /es/openapi.json get /convert/{conversion_id} openapi: 3.1.0 info: title: Doconda API version: 0.1.0 license: name: Proprietary url: https://doconda.com/terms description: >- Convert, create and edit Word, PowerPoint, Excel and PDF documents for AI agents. `POST /documents` waits for the document (direct, the default) or answers at once with `background: true`. Errors follow RFC 9457 (application/problem+json). `POST /documents` accepts `Idempotency-Key`. servers: - url: https://api.eu.doconda.com/v1 security: - apiKey: [] tags: - name: Documents description: Create and edit documents. - name: Files description: 'Your own files: convert them, or use them as a source or to edit.' - name: Webhooks description: Be notified when a document is ready. - name: Editor description: Calls your backend makes for the editor plugin. - name: Dashboard description: >- Used by the Doconda dashboard with a signed-in user. Not available with API keys. paths: /convert/{conversion_id}: get: tags: - Files summary: Pick up a conversion that took longer than 120 s operationId: getConversion parameters: - name: conversion_id in: path required: true schema: type: string responses: '200': description: >- The result. Text is deleted once picked up; a file, 15 minutes after it was made. content: application/json: schema: type: object properties: object: type: string const: conversion id: type: string pattern: ^doc_[0-9A-HJKMNP-TV-Z]{26}$ from: type: string enum: - docx - doc - odt - md - txt - html - xlsx - xls - csv - pptx - ppt - pdf - png - jpg description: >- The format of the file you sent: `doc`, `xls` and `ppt` are the 97-2003 ones; `md` is Markdown. to: type: string enum: - docx - pdf - md - txt - html - odt - rtf - xlsx - csv - pptx description: >- The format you want. Word, Markdown, text, HTML and .odt → docx, pdf, md, txt, html, odt, rtf. Excel and CSV → xlsx, csv, pdf, md, txt. PowerPoint → pptx, pdf, md, txt. PDF → docx, md, txt. PNG and JPEG → pdf, md. A scanned PDF or a picture is read with OCR. text: description: >- md, txt, html and csv: the result itself (an Excel to CSV is its first sheet). Then nothing is kept. Other formats: null. type: - string - 'null' output: anyOf: - type: object properties: id: type: string pattern: ^out_[0-9A-HJKMNP-TV-Z]{26}$ kind: type: string enum: - docx - pptx - xlsx - pdf - preview - html - md - txt - csv - odt - rtf page: type: integer minimum: -9007199254740991 maximum: 9007199254740991 content_type: type: string bytes: type: integer minimum: -9007199254740991 maximum: 9007199254740991 width: type: integer minimum: -9007199254740991 maximum: 9007199254740991 height: type: integer minimum: -9007199254740991 maximum: 9007199254740991 url: type: string description: >- Signed download URL, valid 5 minutes. For `html` (an artifact), the link to the page, which works until its retention ends or you delete it; with `retention: none`, the page to download. expires_at: anyOf: - type: string format: date-time pattern: >- ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z|([+-](?:[01]\d|2[0-3]):[0-5]\d)))$ - type: 'null' description: >- When `url` stops working; null for an artifact's page, which works until the document's `expires_at`. required: - id - kind - content_type - bytes - url - expires_at - type: 'null' description: >- docx, pdf, odt, rtf, xlsx and pptx: the file, to download within 5 minutes. Text formats: null. pages: anyOf: - type: integer minimum: -9007199254740991 maximum: 9007199254740991 - type: 'null' description: >- Pages (PDF, Word), slides (PowerPoint) or sheets (Excel) of the file you sent. expires_at: anyOf: - type: string format: date-time pattern: >- ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z|([+-](?:[01]\d|2[0-3]):[0-5]\d)))$ - type: 'null' description: >- When the converted file is deleted (15 minutes after it was made); null for text, deleted at once. required: - object - id - from - to - text - output - pages - expires_at description: >- No AI is used: the first 1000 conversions each month are free, then 0.01 € each. '202': description: 'Still converting: ask again in a few seconds.' content: application/json: schema: type: object properties: object: type: string const: conversion id: type: string pattern: ^doc_[0-9A-HJKMNP-TV-Z]{26}$ status: type: string enum: - queued - running required: - object - id - status description: >- Still converting (a long scanned PDF can take minutes): pick it up with GET /convert/{id} within 15 minutes. '401': description: unauthorized (missing, unknown or revoked key; expired session). content: application/problem+json: schema: type: object properties: type: type: string title: type: string status: type: integer minimum: -9007199254740991 maximum: 9007199254740991 code: type: string description: >- Stable machine code, e.g. input_invalid, insufficient_balance. request_id: type: string errors: type: array items: type: object properties: path: type: string message: type: string required: - path - message required: - type - title - status - code - request_id '404': description: >- Not found: never existed, text already picked up, or more than 15 minutes old. content: application/problem+json: schema: type: object properties: type: type: string title: type: string status: type: integer minimum: -9007199254740991 maximum: 9007199254740991 code: type: string description: >- Stable machine code, e.g. input_invalid, insufficient_balance. request_id: type: string errors: type: array items: type: object properties: path: type: string message: type: string required: - path - message required: - type - title - status - code - request_id '422': description: The file could not be converted. content: application/problem+json: schema: type: object properties: type: type: string title: type: string status: type: integer minimum: -9007199254740991 maximum: 9007199254740991 code: type: string description: >- Stable machine code, e.g. input_invalid, insufficient_balance. request_id: type: string errors: type: array items: type: object properties: path: type: string message: type: string required: - path - message required: - type - title - status - code - request_id security: - apiKey: [] - session: [] components: securitySchemes: apiKey: type: http scheme: bearer description: '`Authorization: Bearer ak_eu_…`, a key from the dashboard (API keys).' session: type: http scheme: bearer bearerFormat: JWT description: 'Dashboard only: the Cognito ID token of the signed-in user.' ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.