# Meta

Public discovery endpoints. Both are unauthenticated — call them before you have
an API key for uptime monitoring or code generation.

## GET /v1/health

Liveness probe. Returns `200` whenever the API is reachable.

**Scope:** Public (no auth)

### Example request

```bash
curl https://api.ticketconnect.example/v1/health
```

### Example response

```json
{
  "status": "ok",
  "version": "v1"
}
```

---

## GET /v1/openapi.json

Returns the machine-readable OpenAPI 3.0 contract for the entire API. Fetch it
for client/SDK generation or to import the API into Postman.

**Scope:** Public (no auth)

### Example request

```bash
curl https://api.ticketconnect.example/v1/openapi.json
```

### Example response

```json
{
  "openapi": "3.0.3",
  "info": {
    "title": "TicketConnect White-Label API",
    "version": "1.0.0"
  },
  "paths": { "...": "..." }
}
```

A live Swagger UI rendering of this document is hosted at **`/v1/docs`**.