### POST /api/v4/{collection}/match

**Match refs and names** (`match`). Up to 100 domains, UUIDs, LinkedIn URLs or names in one call. One result per input, in input order: exact, candidates, not_found or invalid. Names never become exact.

1¢ per successful request. API key required. Success: `200`.

#### Path parameters

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `collection` | "startups" \| "investors" \| "funding_rounds" \| "exits" | yes | startups, investors, funding_rounds or exits. |

#### Body

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `values` | array<string> | yes | Domains, UUIDs, slugs, LinkedIn URLs or names (names: startups and investors only). |
| `fields` | array<string> |  | Fields for exact matches. Omit for the default fields. |

#### Response

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `data` | array<object> | yes | The results. |
| `data[].input` | string | yes |  |
| `data[].status` | "exact" \| "candidates" \| "not_found" \| "invalid" | yes |  |
| `data[].record` | object |  | For exact matches. |
| `data[].record.id` | string | yes | UUID. |
| `data[].candidates` | array<object> |  |  |
| `data[].candidates[].id` | string | yes | UUID. |
| `data[].candidates[].name` | string \| null |  |  |
| `data[].candidates[].domain` | string \| null |  |  |
| `data[].candidates[].confidence` | number \| null |  |  |
| `data[].error` | object |  |  |
| `data[].error.code` | string | yes |  |
| `data[].error.message` | string | yes |  |
| `meta.request_id` | string | yes | Request id (also in X-Request-Id). |
| `meta.cost_usd_cents` | number | yes | Charged for this request, in USD cents. |

#### Errors

| Status | Code | Meaning |
| --- | --- | --- |
| 400 | `VALIDATION_FAILED` | The request does not match the endpoint contract. |
| 400 | `UNKNOWN_FIELD` | A field name is not part of this collection. |
| 401 | `UNAUTHORIZED` | The API key is missing, invalid or revoked. |
| 402 | `INSUFFICIENT_FUNDS` | The account balance cannot cover this request or job. |
| 429 | `RATE_LIMITED` | Too many requests in the current window. |
| 429 | `QUOTA_EXCEEDED` | A daily or concurrency quota is used up. |
| 500 | `INTERNAL_ERROR` | An unexpected server error. |
| 503 | `SERVICE_UNAVAILABLE` | A dependency is temporarily unavailable. |

#### Example

```bash

curl -X POST 'https://startup-seeker.com/api/v4/startups/match' \
  -H "Authorization: Bearer $STARTUPSEEKER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "values": [
      "stripe.com",
      "Mistral AI"
    ],
    "fields": [
      "name",
      "domain"
    ]
  }'

```