GET /api/v1/document
Personal access token & O auth2

Headers

  • X-PLANNR-ACCOUNT-UUID string

Query parameters

  • include string

    Comma separated list of relationships to include in the response. Valid relationships are [clients, file].

  • filter[uuid] string

    Filter by a comma separated list of UUIDs.

  • filter[name] string

    Filter by partial document title

  • filter[created_before] string

    date Filter documents created before a given date. Format: YYYY-MM-DD

  • filter[created_after] string

    date Filter documents created after a given date. Format: YYYY-MM-DD

  • filter[client_uuids] string

    Filter by a comma separated list of client UUIDs.

  • filter[circle_uuids] string

    Comma separated string of circle UUIDs to filter by.

  • sort string

    Field to sort by. Valid fields are [created_at, updated_at]. Negative sign to denote DESC. Defaults to 'updated_at'.

  • per_page integer

    Number of results to return with pagination (Default 15. Max 500).

Responses

  • 200 application/json
    Hide response attribute Show response attribute object
    • data array[object]
      Hide data attributes Show data attributes object
      • uuid string

        The UUID of the resource.

      • created_at string

        The timestamp of when the resource was created.

      • updated_at string

        The timestamp of when the resource was updated.

      • version integer

        The document builder version. Used for internal purposes only. Defaults to 3

      • name string

        The name of the document.

      • status string

        The status of the document.

      • last_publishing_error string

        The last error that occurred during publishing.

      • required_dependants object

        The required dependant variables of the document.

        Hide required_dependants attribute Show required_dependants attribute object
        • client-1 string
      • known_dependants object

        The dependants submitted to the document previously.

        Hide known_dependants attribute Show known_dependants attribute object
        • client-1 string
      • public_docx_url string

        The download URL of the DOCX content. This is intended for the user to download if they are signed into Plannr. You can access this data via the API using the route in /api/v1.

      • public_sfdt_url string

        The download URL of the SFDT (SyncFusion) content. This is intended for the user to download if they are signed into Plannr. You can access this data via the API using the route in /api/v1.

      • public_pdf_url string

        The download URL of the PDF content. This is intended for the user to download if they are signed into Plannr. You can access this data via the API using the route in /api/v1.

      • public_preview_url string

        The image preview URL of the document. This is intended for the user to preview the document before opening it. You can access this data via the API using the route in /api/v1.
GET /api/v1/document 
curl \
 --request GET 'https://api.plannrcrm.com/api/v1/document' \
 --header "Authorization: Bearer $ACCESS_TOKEN" \
 --header "X-PLANNR-ACCOUNT-UUID: {YOUR_PLANNR_ACCOUNT_UUID}"
Response examples (200) 
{
  "data": [
    {
      "uuid": "e0638275-0dd0-4208-9d85-170e728ffbb0",
      "created_at": "2026-05-19T18:31:17+01:00",
      "updated_at": "2026-05-19T18:31:17+01:00",
      "version": 3,
      "name": "Welcome Template",
      "status": "published",
      "last_publishing_error": "There was an error converting this file to PDF. Please try again later.",
      "required_dependants": {
        "client-1": "client"
      },
      "known_dependants": {
        "client-1": "052ea92f-1b51-4edd-bf1f-32b5cbc354d4"
      },
      "public_docx_url": "https://api.plannrcrm.com/document/a17d2ffb-df3e-4ebb-b557-051a088deaa1/content/docx?plannr_account_uuid=e6e8b96c-cf95-4c81-a704-c12ef4f1d92c",
      "public_sfdt_url": "https://api.plannrcrm.com/document/6189037d-b30d-4d5b-bf92-ba5b9089dd2d/content/sfdt?plannr_account_uuid=872700c7-6e14-4e0e-9774-e3989c008342",
      "public_pdf_url": "https://api.plannrcrm.com/document/6f103aea-1e60-439d-a238-4a6597e251e9/content/pdf?plannr_account_uuid=bd24d41b-8517-4246-9165-c3a3c10f11f6",
      "public_preview_url": "https://api.plannrcrm.com/document/79ed398a-a4a6-472d-b005-fa5c6408ab0c/content/preview?plannr_account_uuid=a1d2b3e9-9cc1-4fbb-920e-c64f30a252ff"
    }
  ]
}