application/json

Body

  • name string Required

    Name of the report

  • report_type_id string

    Type of report to generate, available types are actual_vs_estimate_report, adviser_income_detailed, aged_debt_report, cases_export, charges_export, client_expenditure_export, client_export, conversion_pipeline, employee_export, form_submission_export, group_scheme_members_export, holding_export, income_reconciliation_export, new_business_export, new_business_summary_report, note_export, plan_export, premium_export, revenue_analysis_based_on_receipts, rmar, staff_member_export, task_export, time_entries, valuation_report

    Values are actual_vs_estimate_report, adviser_income_detailed, aged_debt_report, cases_export, charges_export, client_expenditure_export, client_export, conversion_pipeline, employee_export, form_submission_export, group_scheme_members_export, holding_export, income_reconciliation_export, new_business_export, new_business_summary_report, note_export, plan_export, premium_export, revenue_analysis_based_on_receipts, rmar, staff_member_export, task_export, time_entries, or valuation_report.

  • report_template_uuid string(uuid)

    Report template uuid to generate a report from, required if no report id is passed

  • report_query object

    Extra query parameters that can be used to manipulate the report output, only works for new reports, for templates the data stored on the template will be used

    Additional properties are allowed.

  • save_as_template boolean

    setting this to true will save this request as a template that can be reused, if no value is given this defaults to false, does not store a new template if a template if a template is passed

  • template_name string

    The name of the template to generate. Required if save_as_template is true.

Responses

  • 201 application/json
    Hide response attributes Show response 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.

    • last_interaction_at string

      Last interaction date of an account associated with this report

    • last_login_at string

      Last login date of an account associated with this report

    • name string

      Name of the report

    • created_by object

      the account that created this report

      Hide created_by attributes Show created_by attributes object
      • uuid string
      • created_at string
      • updated_at string
      • type string
      • role string
      • first_name string
      • last_name string
      • name string
      • email string
      • photo_url string
      • firm string
      • primary_phone_number string
      • primary_email string
      • current_time_entry string
      • assigned_adviser string
      • assigned_administrator string
      • assigned_paraplanner string
      • introduced_by string
      • groups string
      • tags string
      • owners string
      • first_contact_date string
      • next_review_date string
      • previous_review_date string
      • anniversary_review_date string
      • with_login boolean
      • has_joint_account boolean
      • can_be_deleted string
      • joint_account_circle string
      • circles string
      • ownership_percentage integer
      • inactive_at string
      • last_interaction_at string
      • custom_fields string
      • external_references string
    • report_type_id string

      report type id

    • status string

      Current status of report generation

    • progress integer

      Current progress of the report when generating

    • files array[object]

      Files generated for this report instance

      Hide files attributes Show files attributes object
      • uuid string
      • created_at string
      • original_created_at string
      • updated_at string
      • uploaded_at string
      • status string
      • filename string
      • name string
      • extension string
      • type string
      • size string
      • path string
      • last_modified string
      • progress string
      • download_url string
      • folder_name string
      • folder string
      • documentable_type string
      • documentable string
      • navigator object
        Hide navigator attributes Show navigator attributes object
        • model_type string
        • model_uuid string
      • firm string
      • account string
      • tags string
    • folder object

      Folder generated with the report. this is the default folder that all generated documents will be stored

      Hide folder attributes Show folder attributes object
      • uuid string
      • created_at string
      • updated_at string
      • name string
      • slug string
      • path string
      • clients_read boolean
      • clients_write boolean
      • show_client_permissions boolean
      • is_system_folder boolean
      • is_pseudo_folder boolean
      • is_root_folder boolean
      • documentable_type string
      • documentable_uuid string
      • documentable string
      • participants_count integer
      • participants string
      • folders_count integer
      • folders string
      • files_count integer
      • files string
      • parents string
      • ancestors string
      • children string
      • depth integer
      • owned boolean
POST /api/v1/report
curl \
 --request POST 'https://api.plannrcrm.com/api/v1/report' \
 --header "Authorization: Bearer $ACCESS_TOKEN" \
 --header "Content-Type: application/json" \
 --data '{"name":"Client Export 22nd July","report_type_id":"actual_vs_estimate_report","report_template_uuid":"60301e34-d33d-4b67-a933-f0292d8a32e6","report_query":{"start_date":"2025-12-24T11:03:00+00:00"},"save_as_template":true,"template_name":"my-template"}'
Request examples
{
  "name": "Client Export 22nd July",
  "report_type_id": "actual_vs_estimate_report",
  "report_template_uuid": "60301e34-d33d-4b67-a933-f0292d8a32e6",
  "report_query": {
    "start_date": "2025-12-24T11:03:00+00:00"
  },
  "save_as_template": true,
  "template_name": "my-template"
}
Response examples (201)
{
  "name": "rmar-report-2025-12-24T11:03:00+00:00",
  "uuid": "0b06e75e-bd93-491e-9dc4-3aa186427910",
  "files": [
    {
      "firm": "App\\Http\\Resources\\FirmResource",
      "name": "Welcome to Plannr",
      "path": "Gareth Thompson/Subfolder/Welcome to Plannr.pdf",
      "size": "21691783",
      "tags": "App\\Http\\Resources\\TagResource",
      "type": "type",
      "uuid": "e395eed2-9a59-4320-9e52-345215e39d64",
      "folder": "App\\Http\\Resources\\FolderResource",
      "status": "uploaded",
      "account": "App\\Http\\Resources\\MinimalAccountResource",
      "filename": "Welcome to Plannr.pdf",
      "progress": "100",
      "extension": "pdf",
      "navigator": {
        "model_type": "account",
        "model_uuid": "66ad0c2c-b578-4e85-aa4a-7a37df614299"
      },
      "created_at": "2025-12-24T11:03:00+00:00",
      "updated_at": "2025-12-24T11:03:00+00:00",
      "folder_name": "folder 2",
      "uploaded_at": "2025-12-24T11:03:00+00:00",
      "documentable": "Object",
      "download_url": "https://api.plannrcrm.com/file/5f381da3-faed-4fca-99c2-d9969d36920d/download",
      "last_modified": "2025-12-24T11:03:00+00:00",
      "documentable_type": "account",
      "original_created_at": "2025-12-24T11:03:00+00:00"
    }
  ],
  "folder": {
    "name": "Important Documents",
    "path": "Codepotato/Important Documents",
    "slug": "important-documents",
    "uuid": "411ccc4e-deec-4a64-9524-3a8a96fae1d9",
    "depth": 5,
    "files": "App\\Http\\Resources\\FileResource",
    "owned": false,
    "folders": "App\\Http\\Resources\\FolderResource",
    "parents": "App\\Http\\Resources\\FolderResource",
    "children": "App\\Http\\Resources\\FolderResource",
    "ancestors": "App\\Http\\Resources\\FolderResource",
    "created_at": "2025-12-24T11:03:00+00:00",
    "updated_at": "2025-12-24T11:03:00+00:00",
    "files_count": 8,
    "clients_read": true,
    "documentable": "Object",
    "participants": "App\\Http\\Resources\\FolderParticipantResource",
    "clients_write": true,
    "folders_count": 5,
    "is_root_folder": true,
    "is_pseudo_folder": true,
    "is_system_folder": true,
    "documentable_type": "account",
    "documentable_uuid": "account",
    "participants_count": 3,
    "show_client_permissions": true
  },
  "status": "complete",
  "progress": 100,
  "created_at": "2025-12-24T11:03:00+00:00",
  "created_by": {
    "firm": "App\\Http\\Resources\\FirmResource",
    "name": "Gareth Thompson",
    "role": "client",
    "tags": "App\\Http\\Resources\\TagResource",
    "type": "client",
    "uuid": "5f6dd9e5-776c-4d9d-9ee2-763a7f56e249",
    "email": "gareth@codepotato.co.uk",
    "groups": "App\\Http\\Resources\\GroupResource",
    "owners": "App\\Http\\Resources\\AccountResource",
    "circles": "App\\Http\\Resources\\CircleResource",
    "last_name": "Thompson",
    "photo_url": "https://eu.ui-avatars.com/api/?name=gareth+thompson",
    "created_at": "2025-12-24T11:03:00+00:00",
    "first_name": "Gareth",
    "updated_at": "2025-12-24T11:03:00+00:00",
    "with_login": true,
    "inactive_at": "2025-12-24",
    "custom_fields": "App\\Http\\Resources\\CustomFieldValueResource",
    "introduced_by": "App\\Http\\Resources\\AccountResource",
    "primary_email": "App\\Http\\Resources\\ContactDetailResource",
    "can_be_deleted": "false",
    "assigned_adviser": "App\\Http\\Resources\\AccountResource",
    "next_review_date": "2025-12-24T11:03:00+00:00",
    "has_joint_account": true,
    "current_time_entry": "App\\Http\\Resources\\TimeEntryResource",
    "first_contact_date": "2025-12-24T11:03:00+00:00",
    "external_references": "App\\Http\\Resources\\ExternalReferenceResource",
    "last_interaction_at": "2025-12-24 11:03:00",
    "assigned_paraplanner": "App\\Http\\Resources\\AccountResource",
    "joint_account_circle": "App\\Http\\Resources\\CircleResource",
    "ownership_percentage": 100,
    "previous_review_date": "2025-12-24T11:03:00+00:00",
    "primary_phone_number": "App\\Http\\Resources\\ContactDetailResource",
    "assigned_administrator": "App\\Http\\Resources\\AccountResource",
    "anniversary_review_date": "2025-12-24T11:03:00+00:00"
  },
  "updated_at": "2025-12-24T11:03:00+00:00",
  "last_login_at": "2024-01-24T09:15:00Z",
  "report_type_id": "rmar",
  "last_interaction_at": "2024-01-24T10:30:00Z"
}