### GET /api/v4/locations

**Find locations** (`locations`). Resolve a place name to the country, region, state or GeoNames city ids that filters use. Free.

Free. API key required. Success: `200`.

#### Query parameters

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `q` | string | yes |  |

#### Response

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `data` | array<object> | yes | The results. |
| `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. |
| 401 | `UNAUTHORIZED` | The API key is missing, invalid or revoked. |
| 429 | `RATE_LIMITED` | Too many requests in the current window. |
| 500 | `INTERNAL_ERROR` | An unexpected server error. |
| 503 | `SERVICE_UNAVAILABLE` | A dependency is temporarily unavailable. |

#### Example

```bash

curl -X GET 'https://startup-seeker.com/api/v4/locations?q=Munich' \
  -H "Authorization: Bearer $STARTUPSEEKER_API_KEY"

```