---
title: "Retrieve Documents"
method: GET
path: "/api/companies/{company_uuid}/retrieve"
tags: ["knowledge"]
---

# Retrieve Documents

`GET /api/companies/{company_uuid}/retrieve`

## Request

- Base URL: `https://api.regdoor.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.regdoor.com/api/companies/{company_uuid}/retrieve`
- Auth: HTTP bearer

Retrieve documents from the knowledge base using semantic or hybrid search

## Path parameters

- `company_uuid` string, uuid, required

## Query parameters

- `query` string
- `limit` integer, nullable: Max number of document chunks to retrieve
- `jurisdiction_id` union: Filter by jurisdiction ID(s). Accepts a single ID or a list of IDs. To pass multiple IDs, repeat the parameter: ?jurisdiction_id=1&jurisdiction_id=2&jurisdiction_id=3
  - integer
  - integer[]
- `semantic_search` boolean, nullable: Activate semantic search
- `full_text_search` boolean, nullable: Activate full text search
- `document_type` union: Filter by document type(s). Accepts a single type or a list of types. To pass multiple values, repeat the parameter: ?document_type=type1&document_type=type2&document_type=type3
  - string
  - string[]
- `published_from` string, date-time, nullable: Filter by publication date from (inclusive). Accepts ISO 8601 format, treated as UTC. Examples: 2024-01-01T00:00:00Z, 2024-01-01T00:00:00+00:00, or 2024-01-01T00:00:00
- `published_to` string, date-time, nullable: Filter by publication date to (inclusive). Accepts ISO 8601 format, treated as UTC. Examples: 2024-06-30T23:59:59Z, 2024-06-30T23:59:59+00:00, or 2024-06-30T23:59:59
- `contents_uuid` union: Filter by content UUID(s). Accepts a single UUID or a list of UUIDs. To pass multiple UUIDs, repeat the parameter: ?contents_uuid=uuid1&contents_uuid=uuid2&contents_uuid=uuid3
  - string, uuid
  - string[]
- `exclude_content_uuids` union: Exclude content UUID(s). Accepts a single UUID or a list of UUIDs. To pass multiple UUIDs, repeat the parameter: ?exclude_content_uuids=uuid1&exclude_content_uuids=uuid2
  - string, uuid
  - string[]
- `exclude_chunk_uuids` union: Exclude chunk UUID(s). Accepts a single UUID or a list of UUIDs. To pass multiple UUIDs, repeat the parameter: ?exclude_chunk_uuids=uuid1&exclude_chunk_uuids=uuid2
  - string, uuid
  - string[]
- `subjects_uuid` union: Filter by subject UUID(s). Accepts a single UUID or a list of UUIDs. To pass multiple UUIDs, repeat the parameter: ?subjects_uuid=uuid1&subjects_uuid=uuid2&subjects_uuid=uuid3
  - string, uuid
  - string[]
- `consultation_role` string, nullable: Filter by consultation_role in the content info field
- `organization_list` union: Filter by organization UUID(s). Accepts a single UUID or a list. To pass multiple UUIDs, repeat the parameter: ?organization_list=uuid1&organization_list=uuid2
  - string, uuid
  - string[]
- `sector_uuid_list` union: Filter by sector UUID(s). Accepts a single UUID or a list. To pass multiple UUIDs, repeat the parameter.
  - string, uuid
  - string[]
- `subsector_uuid_list` union: Filter by subsector UUID(s). Accepts a single UUID or a list. To pass multiple UUIDs, repeat the parameter.
  - string, uuid
  - string[]
- `language` string: Language of the search query and documents

## Headers

- `X-User-Email` string, nullable

## Response `200`

Successful Response

- unknown

## Other responses

- `404`: Not found
- `422`: Validation Error

---

[API](https://skmtc.dev/regdoor/apis/regdoor-api.md) - [All operations](https://skmtc.dev/regdoor/apis/regdoor-api/llms.txt) - [OpenAPI document](https://skmtc.dev/regdoor/apis/regdoor-api/revisions/7642336631af?raw)