Get all fact find requests for accounts in a circle

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
  
  created_at string
  
  updated_at string
  
  status string
  
  completed_at string
  
  invitation_text string
  
  schema object
  
  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
  
  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
  
  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
  
  fact_find_passes object
  
  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": "116d8971-5cde-49d9-8d2b-e5832dd49a1d",
      "schema": {
        "name": "Default fact-find",
        "uuid": "0ef23c8c-fde9-4a8e-9858-8d1e59559360",
        "created_at": "2025-07-17T16:23:18+01:00",
        "public_url": "https://api.plannrcrm.com/fact-find/810108f8-afe2-4703-a26b-58afa74ce57f",
        "updated_at": "2025-07-17T16:23:18+01:00",
        "archived_at": "2025-07-16T16:23:18+01:00",
        "is_archived": false,
        "sections_count": 5,
        "introduction_html": "Welcome to our fact-find! <b>You can use some HTML too.</b>"
      },
      "status": "complete",
      "account": {
        "name": "Gareth Thompson",
        "role": "client",
        "type": "client",
        "uuid": "999eacfe-2069-42eb-8c7a-164044493e57",
        "email": "gareth@codepotato.co.uk",
        "last_name": "Thompson",
        "photo_url": "https://eu.ui-avatars.com/api/?name=Gareth+Thompson",
        "created_at": "2025-07-17T16:23:18+01:00",
        "first_name": "Gareth",
        "updated_at": "2025-07-17T16:23:18+01:00",
        "external_references": "App\\Http\\Resources\\ExternalReferenceResource"
      },
      "created_at": "2025-07-17T16:23:18+01:00",
      "updated_at": "2025-07-17T16:23:18+01:00",
      "latest_file": {
        "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": "674f2361-7cb2-4122-8c28-b2603e313402",
        "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": "6891b0bd-2630-4baf-a5bb-bdb44cb1fe05"
        },
        "created_at": "2025-07-17T16:23:18+01:00",
        "updated_at": "2025-07-17T16:23:18+01:00",
        "folder_name": "folder 2",
        "uploaded_at": "2025-07-17T16:23:18+01:00",
        "documentable": "Object",
        "download_url": "https://api.plannrcrm.com/file/1c0b84c7-0723-4f89-be39-7b4afc06f484/download",
        "last_modified": "2025-07-17T16:23:18+01:00",
        "documentable_type": "account",
        "original_created_at": "2025-07-17T16:23:18+01:00"
      },
      "completed_at": "2025-07-12T16:23:18+01:00",
      "invitation_url": "https://api.plannrcrm.com/fact-find/9f56a8e9-2a90-4ce3-908b-2a6cef697e16/bcb4206b-e3ec-498a-9720-9b3a108bff4a",
      "invitation_text": "Please complete this fact-find!",
      "fact_find_passes": {
        "firm": {
          "name": "Codepotato Ltd",
          "uuid": "3a24e6b7-ae68-4ff7-bed6-1fb668ec9698"
        },
        "uuid": "0f338170-2cd6-4b30-940e-8cbc4da54b6d",
        "circle": {
          "name": "The Codepotato Gang",
          "uuid": "eed4d2ac-bde0-42b1-b631-5620487045b2"
        },
        "account": "App\\Http\\Resources\\MinimalAccountResource",
        "progress": 50,
        "created_at": "2025-07-17T16:23:18+01:00",
        "expires_at": "2025-07-17T16:23:18+01:00",
        "updated_at": "2025-07-17T16:23:18+01:00",
        "is_complete": false,
        "completed_sections": 2
      }
    }
  ]
}