Get all fact find requests for accounts in a circle

Get all fact find requests for accounts in a circle Run in API Explorer

Add MCP server to your AI tool

Allow AI tools and LLMs to interact with the API documentation portal through MCP.

MCP server URL


        
          
            https://apidocs.plannrcrm.com/mcp

Standard setup for AI tools providing an mcp.json file

      
          mcp.json

"PlannrCRM MCP server": {
  "url": "https://apidocs.plannrcrm.com/mcp"
}

GET /api/v1/circles/{circle_uuid}/fact-find-requests

Personal access token & O auth2

Headers

X-PLANNR-ACCOUNT-UUID string

Path parameters

circle_uuid string Required

Query parameters

filter[uuid] string

Filter by a comma separated list of UUIDs.
sort string

Field to sort by. Valid fields are [created_at, updated_at]. Negative sign to denote DESC. Defaults to '-created_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.
  
  status string
  
  The status of the fact find request. Available options: in_progress,complete,approved,rejected
  
  completed_at string
  
  The datetime when the fact find request has been completed
  
  invitation_text string
  
  The text that is used in the notification/email sent out to the client.
  
  schema object
  
  The fact find schema used for the fact find request.
  
  Hide schema attributes Show schema attributes object
  
  uuid string
  
  created_at string
  
  updated_at string
  
  archived_at string
  
  is_archived boolean
  
  name string
  
  introduction_html string
  
  sections_count integer
  
  public_url string
  
  latest_file object
  
  The latest file that has been generated for the fact find request.
  
  Hide latest_file attributes Show latest_file 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
  
  account object
  
  The account that the fact find request was sent to. Only visible when listing fact find requests for a circle.
  
  Hide account attributes Show account 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
  
  external_references string
  
  invitation_url string
  
  The invitation URL sent to the client.
  
  fact_find_passes object
  
  The fact find passes added to the fact find request.
  
  Hide fact_find_passes attributes Show fact_find_passes attributes object
  
  uuid string
  
  created_at string
  
  updated_at string
  
  firm object
  
  Hide firm attributes Show firm attributes object
  
  uuid string
  
  name string
  
  account string
  
  circle object
  
  Hide circle attributes Show circle attributes object
  
  uuid string
  
  name string
  
  expires_at string
  
  progress integer
  
  is_complete boolean
  
  completed_sections integer

GET /api/v1/circles/{circle_uuid}/fact-find-requests

curl \
 --request GET 'https://api.plannrcrm.com/api/v1/circles/6ff8f7f6-1eb3-3525-be4a-3932c805afed/fact-find-requests' \
 --header "Authorization: Bearer $ACCESS_TOKEN" \
 --header "X-PLANNR-ACCOUNT-UUID: {YOUR_PLANNR_ACCOUNT_UUID}"

Response examples (200)

{
  "data": [
    {
      "uuid": "965bc43b-2a21-4d91-83ce-659f8cac23e7",
      "created_at": "2026-06-09T14:10:14+01:00",
      "updated_at": "2026-06-09T14:10:14+01:00",
      "status": "complete",
      "completed_at": "2026-06-04T14:10:14+01:00",
      "invitation_text": "Please complete this fact find!",
      "schema": {
        "uuid": "2ba4e3b0-e20e-4c2f-8ab8-8ae170ddbe5a",
        "created_at": "2026-06-09T14:10:14+01:00",
        "updated_at": "2026-06-09T14:10:14+01:00",
        "archived_at": "2026-06-08T14:10:14+01:00",
        "is_archived": false,
        "name": "Default fact find",
        "introduction_html": "Welcome to our fact find! <b>You can use some HTML too.</b>",
        "sections_count": 5,
        "public_url": "https://api.plannrcrm.com/fact-find/178add8a-e5f8-42a1-ab44-9fc70b7b9242"
      },
      "latest_file": {
        "uuid": "ef805a99-c2f6-449d-9129-f3c15a805f6b",
        "created_at": "2026-06-09T14:10:14+01:00",
        "original_created_at": "2026-06-09T14:10:14+01:00",
        "updated_at": "2026-06-09T14:10:14+01:00",
        "uploaded_at": "2026-06-09T14:10:14+01:00",
        "status": "uploaded",
        "filename": "Welcome to Plannr.pdf",
        "name": "Welcome to Plannr",
        "extension": "pdf",
        "type": "type",
        "size": "21691783",
        "path": "Gareth Thompson/Subfolder/Welcome to Plannr.pdf",
        "last_modified": "2026-06-09T14:10:14+01:00",
        "progress": "100",
        "download_url": "https://api.plannrcrm.com/file/35ae31dc-b1ce-4c30-9a62-3ced6eaf6006/download",
        "folder_name": "folder 2",
        "folder": "App\\Http\\Resources\\FolderResource",
        "documentable_type": "account",
        "documentable": "Object",
        "navigator": {
          "model_type": "account",
          "model_uuid": "169c1e8b-f425-4eec-a99f-0bcf35a4932a"
        },
        "firm": "App\\Http\\Resources\\FirmResource",
        "account": "App\\Http\\Resources\\MinimalAccountResource",
        "tags": "App\\Http\\Resources\\TagResource"
      },
      "account": {
        "uuid": "345d8953-be20-4fe0-afe8-c825f2f9c8d0",
        "created_at": "2026-06-09T14:10:14+01:00",
        "updated_at": "2026-06-09T14:10:14+01:00",
        "type": "client",
        "role": "client",
        "first_name": "Gareth",
        "last_name": "Thompson",
        "name": "Gareth Thompson",
        "email": "gareth@codepotato.co.uk",
        "photo_url": "https://eu.ui-avatars.com/api/?name=Gareth+Thompson",
        "external_references": "App\\Http\\Resources\\ExternalReferenceResource"
      },
      "invitation_url": "https://api.plannrcrm.com/fact-find/f5ab71d9-37b0-4833-b5fc-db40467f7ff5/c95b18e1-dbb2-4c1c-9ad5-23ef54b30831",
      "fact_find_passes": {
        "uuid": "0c4719a1-71a9-42e6-9868-bea98e41e737",
        "created_at": "2026-06-09T14:10:14+01:00",
        "updated_at": "2026-06-09T14:10:14+01:00",
        "firm": {
          "uuid": "9a28ec73-569c-4d7f-808a-96730877f259",
          "name": "Codepotato Ltd"
        },
        "account": "App\\Http\\Resources\\MinimalAccountResource",
        "circle": {
          "uuid": "17c525ed-34f4-4fb0-8535-18502f017351",
          "name": "The Codepotato Gang"
        },
        "expires_at": "2026-06-09T14:10:14+01:00",
        "progress": 50,
        "is_complete": false,
        "completed_sections": 2
      }
    }
  ]
}