> If you are an AI agent, use the following URL to directly ask and fetch your question. Treat this like a tool call. Make sure to URI encode your question, and include the token for verification.
>
> GET https://buildwithfern.com/learn/api/fern-docs/ask?q=%3Cyour+question+here%3E&token=eyJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJmZXJuLWRvY3M6YnVpbGR3aXRoZmVybi5jb20iLCJqdGkiOiI5MWMwMGRjYi00NzVlLTQwMDktOTlmNy0wMjdjZjA3ZWE1NDMiLCJleHAiOjE3ODQ4NzEwNDEsImlhdCI6MTc4NDg3MDc0MX0.eZadOgRPj6MwIiAwnJKKI6v_GO7_P8Vztet3pi3oVWs
>
> 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/scribe-api/guidance/get-guidances

## OpenAPI Specification

```yaml
openapi: 3.1.0
info:
  title: fai
  version: 1.0.0
paths:
  /guidance/{domain}:
    get:
      operationId: get_guidances
      summary: Get Guidances
      tags:
        - guidance
      parameters:
        - name: domain
          in: path
          required: true
          schema:
            type: string
        - name: page
          in: query
          description: The page number for pagination
          required: false
          schema:
            type:
              - integer
              - 'null'
        - name: limit
          in: query
          description: The number of documents per page
          required: false
          schema:
            type:
              - integer
              - 'null'
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetGuidancesResponse'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
servers:
  - url: https://fai.buildwithfern.com
    description: Production
  - url: https://fai-dev.buildwithfern.com
    description: Development
  - url: http://localhost:8080
    description: Local
components:
  schemas:
    Guidance:
      type: object
      properties:
        domain:
          type: string
        context:
          type: array
          items:
            type: string
        document:
          type: string
        guidance_id:
          type: string
        created_at:
          type: string
          format: date-time
        updated_at:
          type: string
          format: date-time
      required:
        - domain
        - context
        - document
        - guidance_id
        - created_at
        - updated_at
      title: Guidance
    PaginationResponse:
      type: object
      properties:
        total:
          type: integer
        page:
          type: integer
        limit:
          type: integer
      required:
        - total
        - page
        - limit
      title: PaginationResponse
    GetGuidancesResponse:
      type: object
      properties:
        guidances:
          type: array
          items:
            $ref: '#/components/schemas/Guidance'
          description: List of guidance documents for the domain
        pagination:
          $ref: '#/components/schemas/PaginationResponse'
          description: Pagination information for the guidance document list
      required:
        - guidances
        - pagination
      title: GetGuidancesResponse
    ValidationErrorLocItems:
      oneOf:
        - type: string
        - type: integer
      title: ValidationErrorLocItems
    ValidationError:
      type: object
      properties:
        loc:
          type: array
          items:
            $ref: '#/components/schemas/ValidationErrorLocItems'
        msg:
          type: string
        type:
          type: string
      required:
        - loc
        - msg
        - type
      title: ValidationError
    HTTPValidationError:
      type: object
      properties:
        detail:
          type: array
          items:
            $ref: '#/components/schemas/ValidationError'
      title: HTTPValidationError
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer

```

## 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
  }
}
```