API Documentation
Instructions for using Crocodoc in your own applications

A newer version of Crocodoc's API is now available. Go to https://crocodoc.com/docs/ to view the documentation for our new API.


All API requests require use of a valid API token. The following request uses an example API token to delete an uploaded document:

API Methods


Upload and convert a file. This method will try to convert a file that has been referenced by a URL or has been uploaded via a POST request.
Example request: https://personal.crocodoc.com/api/v1/document/upload?url=http://www.dcaa.mil/chap6.pdf&token=

view details

Check the conversion status of a document.

view details

Delete an uploaded file.

view details

Download an uploaded file with or without annotations.

view details

Creates a new "short ID" that can be used to share a document.

view details

Clones an uploaded document. Document annotations are not copied.

view details

Creates a session ID for session-based document viewing. Each session ID may only be used once.
The following URL uses an example session ID to grant access to a private document:

view details

Embeddable Viewer


View an embedded document. This URL returns a web page that can be embedded within an iframe.

Example Document

The following iframe is set to this URL: http://personal.crocodoc.com/demo?embedded=true

Tip: Add the following CSS rule to show a spinner while the iframe loads.

iframe { background:url(//personal.crocodoc.com/media/images/docviewer/spinner.gif) no-repeat center; }


View a document using session-based viewing. Session-based viewing enables the embedding of private documents. To obtain session IDs, use the session/get API method.

Example Session



Arguments should be passed in when creating session IDs.