---
search:
  tags:
    - Objects and records
    - GET
seo:
  description: >-
    Candidate accounts and contacts for… Reference for the GET
    /api/v1/objects/{objectId}/records/{recordId}/conversion-matches endpoint in
    the Taylorz CRM API.
sidebar:
  label: Find conversion matches
  badge: GET
title: Find conversion matches
type: openapi-operation
---
Candidate accounts and contacts for converting this lead. The scan is bounded, so `partial` true means none found proves nothing.

`GET /api/v1/objects/{objectId}/records/{recordId}/conversion-matches`

**Responses**

- `200` — The candidates the scan found
- `400` — The request body, query or parameters were refused
- `401` — The access token is missing, invalid or revoked
- `403` — The tenant's module is off, or the token's scope or the member's role does not permit the action
- `404` — No such record, or none the caller may read
- `413` — The request exceeds the route's body limit
- `500` — An unexpected failure

Response example, 200:

```json
{
  "accounts": [
    {
      "id": "string",
      "name": "string",
      "score": 0
    }
  ],
  "contacts": [
    {
      "id": "string",
      "name": "string",
      "score": 0
    }
  ],
  "partial": true
}
```