PUT /api/v2/mortgage-searches/{uuid}
Personal access token & O auth2

Headers

  • X-PLANNR-ACCOUNT-UUID string

Path parameters

  • uuid string Required
application/json

Body

  • name string Required

    The name of the mortgage search

    Maximum length is 255.

Responses

  • 200 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.

    • name string

      The name of the mortgage search

    • status string

      The status of the mortgage search

    • provider string

      The provider that the mortgage search is for

    • provider_reference string

      The provider reference of the mortgage search

    • provider_data array

      Any provider data related to the mortgage search

    • applicants array[object]

      The applicants of the mortgage search

      Hide applicants attributes Show applicants attributes object
      • uuid string
      • created_at string
      • updated_at string
      • account string
    • cases array[object]

      The cases that are related to the mortgage search

      Hide cases attributes Show cases attributes object
      • uuid string
      • created_at string
      • updated_at string
      • name string
      • slug string
      • status string
      • type string
      • review_at string
      • assigned_to_uuids array[string]
      • group_uuids array[string]
      • completed_at string
      • value object
        Hide value attributes Show value attributes object
        • amount object
          Hide amount attributes Show amount attributes object
          • example string
          • description string
        • formatted object
          Hide formatted attributes Show formatted attributes object
          • example string
          • description string
        • currency object
          Hide currency attributes Show currency attributes object
          • example string
          • description string
      • status_position integer
      • participants_count integer
      • participants string
      • task_board_uuid string
      • plans string
      • custom_fields string
    • products array[object]

      The products that are related to the mortgage search

      Hide products attributes Show products attributes object
      • uuid string
      • created_at string
      • updated_at string
      • provider_reference string
      • provider_scenario_name string
      • provider_scenario_data array
      • lender_name string
      • product_title string
      • files string
    • files array[object]

      The files that are related to the mortgage search

      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
PUT /api/v2/mortgage-searches/{uuid} 
curl \
 --request PUT 'https://api.plannrcrm.com/api/v2/mortgage-searches/6ff8f7f6-1eb3-3525-be4a-3932c805afed' \
 --header "Authorization: Bearer $ACCESS_TOKEN" \
 --header "Content-Type: application/json" \
 --header "X-PLANNR-ACCOUNT-UUID: {YOUR_PLANNR_ACCOUNT_UUID}" \
 --data '{"name":"My Mortgage Search"}'
Request examples 
# Headers
X-PLANNR-ACCOUNT-UUID: {YOUR_PLANNR_ACCOUNT_UUID}

# Payload
{
  "name": "My Mortgage Search"
}
Response examples (200) 
{
  "uuid": "de053bf5-b9e3-41a8-8a8c-d1af7e20faf6",
  "created_at": "2026-06-04T11:58:04+01:00",
  "updated_at": "2026-06-04T11:58:04+01:00",
  "name": "My Mortgage Search",
  "status": "pending",
  "provider": "Mortgage Brain",
  "provider_reference": "123456789",
  "provider_data": [],
  "applicants": [
    {
      "uuid": "fd149ae3-6728-4eb3-8673-f40f9758cbcb",
      "created_at": "2026-06-04T11:58:04+01:00",
      "updated_at": "2026-06-04T11:58:04+01:00",
      "account": "App\\Http\\Resources\\MinimalAccountResource"
    }
  ],
  "cases": [
    {
      "uuid": "508c8c6d-66d3-405d-b693-10f6b82480c4",
      "created_at": "2026-06-04T11:58:04+01:00",
      "updated_at": "2026-06-04T11:58:04+01:00",
      "name": "finance",
      "slug": "finance",
      "status": "App\\Http\\Resources\\CasesStatusResource",
      "type": "App\\Http\\Resources\\CasesTypeResource",
      "review_at": "2026-06-04T11:58:04+01:00",
      "assigned_to_uuids": [
        "f6506a09-a0cd-4b2c-8640-5e3fa9db1330"
      ],
      "group_uuids": [
        "ba85b9db-b418-48ed-99c7-aa2d9031b03b"
      ],
      "completed_at": "2026-06-04T11:58:04+01:00",
      "value": {
        "amount": {
          "example": "4000",
          "description": "Money amount at their lowest denominator (for example: pennies)"
        },
        "formatted": {
          "example": "£40.00",
          "description": "Money amount formatted with currency"
        },
        "currency": {
          "example": "GBP",
          "description": "Currency of the money"
        }
      },
      "status_position": 4,
      "participants_count": 4,
      "participants": "App\\Http\\Resources\\AccountResource",
      "task_board_uuid": "b8b1d078-3312-41a5-97dc-91665c7427f8",
      "plans": "App\\Http\\Resources\\Plans\\PlanResource",
      "custom_fields": "App\\Http\\Resources\\CustomFieldValueResource"
    }
  ],
  "products": [
    {
      "uuid": "35d6ce31-341a-439d-b0c6-d00f5a461f78",
      "created_at": "2026-06-04T11:58:04+01:00",
      "updated_at": "2026-06-04T11:58:04+01:00",
      "provider_reference": "example-reference",
      "provider_scenario_name": "Single Applicant, Small Deposit",
      "provider_scenario_data": [],
      "lender_name": "HSBC",
      "product_title": "5% Fixed Rate - 5 year",
      "files": "App\\Http\\Resources\\FileResource"
    }
  ],
  "files": [
    {
      "uuid": "3abe85d9-c5e6-4461-952e-6a058e2f916f",
      "created_at": "2026-06-04T11:58:04+01:00",
      "original_created_at": "2026-06-04T11:58:04+01:00",
      "updated_at": "2026-06-04T11:58:04+01:00",
      "uploaded_at": "2026-06-04T11:58:04+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-04T11:58:04+01:00",
      "progress": "100",
      "download_url": "https://api.plannrcrm.com/file/c8cf5d5c-a8f0-4a74-8925-53ab80d58595/download",
      "folder_name": "folder 2",
      "folder": "App\\Http\\Resources\\FolderResource",
      "documentable_type": "account",
      "documentable": "Object",
      "navigator": {
        "model_type": "account",
        "model_uuid": "ba07e44d-1c71-4f8e-b086-5b5dc35d7e6d"
      },
      "firm": "App\\Http\\Resources\\FirmResource",
      "account": "App\\Http\\Resources\\MinimalAccountResource",
      "tags": "App\\Http\\Resources\\TagResource"
    }
  ]
}