> For clean Markdown content of this page, append .md to this URL. For the complete documentation index, see https://buildwithfern.com/learn/llms.txt.

# Get Guidances

GET https://fai.buildwithfern.com/guidance/{domain}

Reference: https://buildwithfern.com/learn/docs/ai-features/ask-fern/api-reference/guidance/get-guidances

## Authentication

- `Authorization` header (bearer token, required) — Bearer authentication of the form `Bearer <token>`, where token is your auth token.

## Servers

- `https://fai.buildwithfern.com` (Production, default)
- `https://fai-dev.buildwithfern.com` (Development)
- `http://localhost:8080` (Local)

## Request

### Path parameters

- `domain` (string, required)

### Query parameters

- `page` (integer, optional, nullable) — The page number for pagination
- `limit` (integer, optional, nullable) — The number of documents per page

## Response

### 200

Successful Response

- `guidances` (list of Guidance, required) — List of guidance documents for the domain
- `pagination` (PaginationResponse, required) — Pagination information for the guidance document list

## Errors

### 422 Unprocessable Entity Error

Validation Error

- `detail` (list of ValidationError, optional)

## Types

### Guidance

- `domain` (string, required)
- `context` (list of string, required)
- `document` (string, required)
- `guidance_id` (string, required)
- `created_at` (datetime, required)
- `updated_at` (datetime, required)

### PaginationResponse

- `total` (integer, required)
- `page` (integer, required)
- `limit` (integer, required)

### ValidationError

- `loc` (list of ValidationErrorLocItems, required)
- `msg` (string, required)
- `type` (string, required)

### ValidationErrorLocItems

## Examples

**Response**

```json
{
  "guidances": [
    {
      "domain": "string",
      "context": [
        "string"
      ],
      "document": "string",
      "guidance_id": "string",
      "created_at": "2024-01-15T09:30:00Z",
      "updated_at": "2024-01-15T09:30:00Z"
    }
  ],
  "pagination": {
    "total": 1,
    "page": 1,
    "limit": 1
  }
}
```