### GET /api/v4/{collection}/{ref}

**Get a record** (`get`). One record by UUID, domain, slug or LinkedIn URL (funding rounds and exits: UUID). expand nests related records with their own pagination.

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. |
| `ref` | string | yes | UUID, domain, slug or LinkedIn URL (percent-encode URLs). |

#### Query parameters

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `fields` | array<string> (comma-separated) |  |  |
| `expand` | array<string> (comma-separated) |  |  |

#### Response

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `data` | object | yes | A record with the requested fields (see /schema). Expanded to-many relations are page objects {data, page}; to-one relations are objects or null. |
| `data.id` | string | yes | UUID. |
| `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. |
| 404 | `NOT_FOUND` | The record or resource does not exist for this account. |
| 409 | `REF_AMBIGUOUS` | The ref matches several records. |
| 413 | `RECORD_TOO_LARGE` | A single record exceeds the 1 MB response budget. |
| 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. |
| 504 | `QUERY_TIMEOUT` | The query ran out of its time budget. |

#### Example

```bash

curl -X GET 'https://startup-seeker.com/api/v4/startups/stripe.com?fields=name,domain,total_funding_usd&expand=funding_rounds' \
  -H "Authorization: Bearer $STARTUPSEEKER_API_KEY"

```