POST /api/v1/addons/mortgagebrain/mortgage-search
Personal access token & O auth2
application/json

Body

  • applicants array[object] Required

    The applicants for the mortgage search. Must be at least one and no more than two.

    Hide applicants attributes Show applicants attributes object
    • account_uuid string(uuid)

      The UUID of the applicant

    • title string

      The title of the applicant

      Value Description
      mr MR
      mrs MRS
      miss MISS
      ms MS
      mx MX
      dr DR
      dame DAME
      father FATHER
      madam MADAM
      lord LORD
      sir SIR
      prof PROF

      Values are mr, mrs, miss, ms, mx, dr, dame, father, madam, lord, sir, or prof.

  • case_uuids array[string(uuid)]

    An optional array of case UUIDs to associate to the mortgage search

  • oauth_connection_uuid string(uuid)

    An optional OAuth2 connection UUID to overwrite the default behaviour (which is to pick the first Mortgage Brain OAuth2 connection)

  • proceed boolean Required

    This parameter can be used to indicate whether to proceed with creating the mortgage search or not. If false, a 202 response will be returned without creating the search. This can be used to validate the data before continuing.

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.

    • 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
POST /api/v1/addons/mortgagebrain/mortgage-search 
curl \
 --request POST 'https://api.plannrcrm.com/api/v1/addons/mortgagebrain/mortgage-search' \
 --header "Authorization: Bearer $ACCESS_TOKEN" \
 --header "Content-Type: application/json" \
 --data '{"applicants":[{"title":"mr","account_uuid":"3ec3ba4c-feef-4650-afec-6788b93f13fa"}],"case_uuids":["60f2801e-ac1e-4508-9bfa-e155630f6f4a","d559a13d-f4df-4db3-80ec-5dc962c67569","4e228cec-1161-40e3-8131-a3bed4b78ce7"],"oauth_connection_uuid":"14fa708a-7a8a-4f83-b003-126fbbf3ccc2","proceed":true}'
Request examples 
{
  "applicants": [
    {
      "title": "mr",
      "account_uuid": "3ec3ba4c-feef-4650-afec-6788b93f13fa"
    }
  ],
  "case_uuids": [
    "60f2801e-ac1e-4508-9bfa-e155630f6f4a",
    "d559a13d-f4df-4db3-80ec-5dc962c67569",
    "4e228cec-1161-40e3-8131-a3bed4b78ce7"
  ],
  "oauth_connection_uuid": "14fa708a-7a8a-4f83-b003-126fbbf3ccc2",
  "proceed": true
}
Response examples (200) 
{
  "uuid": "1b1ae6be-df66-4b50-913f-39f4a918af60",
  "cases": [
    {
      "name": "finance",
      "slug": "finance",
      "type": "App\\Http\\Resources\\CasesTypeResource",
      "uuid": "12cb6d58-5781-4744-9acd-01ab7ea95737",
      "plans": "App\\Http\\Resources\\Plans\\PlanResource",
      "value": {
        "amount": {
          "example": "4000",
          "description": "Money amount at their lowest denominator (for example: pennies)"
        },
        "currency": {
          "example": "GBP",
          "description": "Currency of the money"
        },
        "formatted": {
          "example": "£40.00",
          "description": "Money amount formatted with currency"
        }
      },
      "status": "App\\Http\\Resources\\CasesStatusResource",
      "review_at": "2026-02-06T09:09:45+00:00",
      "created_at": "2026-02-06T09:09:45+00:00",
      "updated_at": "2026-02-06T09:09:45+00:00",
      "group_uuids": [
        "8cdda53c-b76d-48ec-80a4-3f31a8b39e87"
      ],
      "completed_at": "2026-02-06T09:09:45+00:00",
      "participants": "App\\Http\\Resources\\AccountResource",
      "custom_fields": "App\\Http\\Resources\\CustomFieldValueResource",
      "status_position": 4,
      "task_board_uuid": "ea21ab8d-b2e5-4200-a11d-2124754e60a0",
      "assigned_to_uuids": [
        "68ac764a-0dd1-4b8f-a215-4a1b08342756"
      ],
      "participants_count": 4
    }
  ],
  "status": "pending",
  "provider": "Mortgage Brain",
  "applicants": [
    {
      "uuid": "1a87d5f7-94cd-4728-9981-14be93f88bd9",
      "account": "App\\Http\\Resources\\MinimalAccountResource",
      "created_at": "2026-02-06T09:09:45+00:00",
      "updated_at": "2026-02-06T09:09:45+00:00"
    }
  ],
  "created_at": "2026-02-06T09:09:45+00:00",
  "updated_at": "2026-02-06T09:09:45+00:00",
  "provider_data": [],
  "provider_reference": "123456789"
}