Reject an enquiry

POST/api/v2/client-assist/{id}/reject

Rejects a Client Assist enquiry because your firm cannot take it on. The enquiry moves to REJECTED, and the client is emailed to say your firm is unable to help. If they opted in to updates by SMS, they are sent a text message too.

Rejecting is final. A rejected enquiry cannot be accepted, reported or reopened.

If the enquiry itself is the problem, for example it is not a genuine legal problem or the contact details are fake, report it instead.

Path parameters

Param	Type	Required	Description
`id`	`string`	Required	The `id` of the enquiry to reject.

Body parameters

Field	Type	Required	Description
`reason`	`string`	Required	Why your firm cannot help. Use one of the reject reasons. Cannot be empty.
`details`	`string`	Optional	More detail, in your own words. Stored with the enquiry for your firm’s records.

Reject reasons

These are the reasons your dashboard offers, and it shows them by label. Any other text is accepted and shown as it is.

Value	Shown in your dashboard as
`outside-expertise`	Outside my area of expertise
`conflict-of-interest`	Conflict of interest
`at-full-capacity`	At full capacity
`case-complexity`	Case too complex/simple for our practice
`geographic-location`	Geographic location issues
`fee-structure`	Fee structure mismatch
`unrealistic-expectations`	Unrealistic client expectations
`other`	Other reason

Request

cURL

POST /api/v2/client-assist/{id}/reject


curl --location 'https://www.reviewsolicitors.co.uk/api/v2/client-assist/{id}/reject' \
     --header 'Authorization: Bearer {access_token}' \
     --header 'Content-Type: application/json' \
     --data   '{
          "reason": "at-full-capacity",
          "details": "No capacity for new family law cases until October."
     }'

Response

200 OK


{
  "message": "Client assist enquiry rejected"
}

The enquiry now shows status REJECTED, with rejectedAt, rejectReason and rejectDetails set. See Retrieve an enquiry.

Errors

Code	Cause
400	`reason` is missing or empty, or the enquiry is already `REJECTED`, `REPORTED`, `COMPLETED` or `CLOSED`.
403	Client Assist is not active for your firm.
404	No Client Assist enquiry with that `id` belongs to your firm.

A missing reason returns a list of field errors:

400 Bad Request


[
  {
    "field": "reason",
    "error": ["A reason is required"]
  }
]