Finish the fact-find request Run in API Explorer
Will mark the fact-find request as completed overall regardless of fact-find pass progress.
POST
/api/v1/fact-find/request/{factFindRequest_uuid}/finish
curl \
--request POST 'https://api.plannrcrm.com/api/v1/fact-find/request/6ff8f7f6-1eb3-3525-be4a-3932c805afed/finish' \
--header "Authorization: Bearer $ACCESS_TOKEN" \
--header "X-PLANNR-ACCOUNT-UUID: {YOUR_PLANNR_ACCOUNT_UUID}"
Response examples (200)
{
"uuid": "b7711ded-f1db-4f8a-926f-adb1541cf900",
"schema": {
"name": "Default fact-find",
"uuid": "86fb7f27-6a99-4a92-83fa-c2609d8a1cfb",
"created_at": "2025-11-17T21:14:40+00:00",
"public_url": "https://api.plannrcrm.com/fact-find/401c977d-9b09-4061-816c-c28de98f5589",
"updated_at": "2025-11-17T21:14:40+00:00",
"archived_at": "2025-11-16T21:14:40+00: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": "f4d5454a-ecf1-4bcd-a01b-88f0871b68f1",
"email": "gareth@codepotato.co.uk",
"last_name": "Thompson",
"photo_url": "https://eu.ui-avatars.com/api/?name=Gareth+Thompson",
"created_at": "2025-11-17T21:14:40+00:00",
"first_name": "Gareth",
"updated_at": "2025-11-17T21:14:40+00:00",
"external_references": "App\\Http\\Resources\\ExternalReferenceResource"
},
"created_at": "2025-11-17T21:14:40+00:00",
"updated_at": "2025-11-17T21:14:40+00: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": "bb902df0-4b22-4fea-b057-102086a9b85a",
"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": "f9e4417f-ee08-41ec-a0c6-acb1f708a75f"
},
"created_at": "2025-11-17T21:14:40+00:00",
"updated_at": "2025-11-17T21:14:40+00:00",
"folder_name": "folder 2",
"uploaded_at": "2025-11-17T21:14:40+00:00",
"documentable": "Object",
"download_url": "https://api.plannrcrm.com/file/12da2e45-0557-43f1-8ad2-43307465f7b8/download",
"last_modified": "2025-11-17T21:14:40+00:00",
"documentable_type": "account",
"original_created_at": "2025-11-17T21:14:40+00:00"
},
"completed_at": "2025-11-12T21:14:40+00:00",
"invitation_url": "https://api.plannrcrm.com/fact-find/485be3ea-f2a1-427d-8257-6542d388bc22/99aec2a4-5a9c-4071-9bcc-ae6d5c3c4cc9",
"invitation_text": "Please complete this fact-find!",
"fact_find_passes": {
"firm": {
"name": "Codepotato Ltd",
"uuid": "2d03e6e9-245f-45ea-a161-8c6543a24431"
},
"uuid": "5d040cd0-6397-4437-9d79-fda79606bbf6",
"circle": {
"name": "The Codepotato Gang",
"uuid": "74e7226b-b6d9-4831-9cfb-d2487e657872"
},
"account": "App\\Http\\Resources\\MinimalAccountResource",
"progress": 50,
"created_at": "2025-11-17T21:14:40+00:00",
"expires_at": "2025-11-17T21:14:40+00:00",
"updated_at": "2025-11-17T21:14:40+00:00",
"is_complete": false,
"completed_sections": 2
}
}