> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.medicomp.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.medicomp.com/_mcp/server.

# Authentication

When hosted on-premise, the Quippe REST APIs can be protected through any authentication method used in your host application.

The Quippe [sandbox site](https://quippe.medicomp.com) accepts [HTTP basic authentication](https://developer.mozilla.org/en-US/docs/Web/HTTP/Guides/Authentication#basic_authentication_scheme) or you can use a [JSON web token](https://www.jwt.io/) generated by a request to the [/Quippe/Security/Token](/api-reference/rest/get-quippe-security-token) endpoint.  

[Sign up for credentials](https://medicomp.com/request-access/) to test with the sandbox site.

## HTTP basic authentication

```http
GET /api/Quippe/Search?Query=type%202%20diabetes HTTP/2
Host: quippe.medicomp.com
Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ=
```

## JSON web token

### With user credentials

```http
GET /api/Quippe/Security/Token HTTP/2
Host: quippe.medicomp.com
Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ=
```

```json
{
  "response": {
    "token": "eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJ1aWQiOiJ1c2VyQG1lZGljb21wLmNvbSIsInR0eXBlIjoidXNlciIsIm5iZiI6MTc4NDIxNDE3NSwiZXhwIjoxNzg0MjQyOTc1LCJpYXQiOjE3ODQyMTQxNzUsImlzcyI6InF1aXBwZS1hcGkiLCJhdWQiOiJxdWlwcGUtdWkifQ.h4w_U_8hZfVHvO4YyLOkrJ3X2BiIZZntolJ3wNc8MuI46LW0m8svDhwJKAHpgmiAuVXaHGQ9yQ9Spib_fBHtFcC2Zelw-MxwB0-9unPeycrU3fyVqwwTrUlOL3GYO_BEOrAp0Txny6EXvWZs1SHly7i80wP5zET-oAypYg9RwkCHyEBU_TbWgWvXRjs9i9LlpWBhECcLVgxBMsxb44l7ZOMCrG2d4Sl7ZmB0txsBZVcyKj4eRz6aU0V5jV3r3nZpJCYQmrTjXcmAwMdX26xXhgZI7FYcCNLnp961UQbNq6c_--pWN0nuSFcP5FftnrzHkNW1TNnL_7Kz1yqoL0pU2w"
  }
}
```

Followed by:

```http
GET /api/Quippe/Search?Query=type%202%20diabetes HTTP/2
Host: quippe.medicomp.com
Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJ1aWQiOiJ1c2VyQG1lZGljb21wLmNvbSIsInR0eXBlIjoidXNlciIsIm5iZiI6MTc4NDIxNDE3NSwiZXhwIjoxNzg0MjQyOTc1LCJpYXQiOjE3ODQyMTQxNzUsImlzcyI6InF1aXBwZS1hcGkiLCJhdWQiOiJxdWlwcGUtdWkifQ.h4w_U_8hZfVHvO4YyLOkrJ3X2BiIZZntolJ3wNc8MuI46LW0m8svDhwJKAHpgmiAuVXaHGQ9yQ9Spib_fBHtFcC2Zelw-MxwB0-9unPeycrU3fyVqwwTrUlOL3GYO_BEOrAp0Txny6EXvWZs1SHly7i80wP5zET-oAypYg9RwkCHyEBU_TbWgWvXRjs9i9LlpWBhECcLVgxBMsxb44l7ZOMCrG2d4Sl7ZmB0txsBZVcyKj4eRz6aU0V5jV3r3nZpJCYQmrTjXcmAwMdX26xXhgZI7FYcCNLnp961UQbNq6c_--pWN0nuSFcP5FftnrzHkNW1TNnL_7Kz1yqoL0pU2w
```

### With a previously-issued token

```http
GET /api/Quippe/Security/Token HTTP/2
Host: quippe.medicomp.com
Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJ1aWQiOiJ1c2VyQG1lZGljb21wLmNvbSIsInR0eXBlIjoidXNlciIsIm5iZiI6MTc4NDIxNDE3NSwiZXhwIjoxNzg0MjQyOTc1LCJpYXQiOjE3ODQyMTQxNzUsImlzcyI6InF1aXBwZS1hcGkiLCJhdWQiOiJxdWlwcGUtdWkifQ.h4w_U_8hZfVHvO4YyLOkrJ3X2BiIZZntolJ3wNc8MuI46LW0m8svDhwJKAHpgmiAuVXaHGQ9yQ9Spib_fBHtFcC2Zelw-MxwB0-9unPeycrU3fyVqwwTrUlOL3GYO_BEOrAp0Txny6EXvWZs1SHly7i80wP5zET-oAypYg9RwkCHyEBU_TbWgWvXRjs9i9LlpWBhECcLVgxBMsxb44l7ZOMCrG2d4Sl7ZmB0txsBZVcyKj4eRz6aU0V5jV3r3nZpJCYQmrTjXcmAwMdX26xXhgZI7FYcCNLnp961UQbNq6c_--pWN0nuSFcP5FftnrzHkNW1TNnL_7Kz1yqoL0pU2w
```

```json
{
  "response": {
    "token": "eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJ1aWQiOiJ1c2VyQG1lZGljb21wLmNvbSIsInR0eXBlIjoidXNlciIsIm5iZiI6MTc4NDIxNDE3NSwiZXhwIjoxNzg0MjQ1OTc1LCJpYXQiOjE3ODQyMTQxNzUsImlzcyI6InF1aXBwZS1hcGkiLCJhdWQiOiJxdWlwcGUtdWkifQ.XjiXorhB6A3neoLbpKyKzJCnjSv3bWWpzDWWY5QUN2Vi_vAO-ON6JYwZ46HMulgvvmexR_vS5HkTp75B_vVx5XJImv1s8NsCuUt5ixbkQ588_7wfAT6E2KTFGbuZHwZnjnXLsZyoz_mesHD1WuXl1RiL5o8l5hkYp5iIjn0sd73tOcnaxpPtrwwvNySVyYgb2FFJGrkoTpEiQ3G16wur2pCvGHDj1vwZ_Rc_jU0YDQET8LcVAu57p38G7jLBhR_UlFOdb34KsupAKYSBPKVPzMkiMgaVqsik5KvtRUL0JmvJhj6aCxJsAyjbgDG8muramPzBKZV9BvsBlN77T9DOwQ"
  }
}
```

Followed by:

```http
GET /api/Quippe/Search?Query=type%202%20diabetes HTTP/2
Host: quippe.medicomp.com
Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJ1aWQiOiJ1c2VyQG1lZGljb21wLmNvbSIsInR0eXBlIjoidXNlciIsIm5iZiI6MTc4NDIxNDE3NSwiZXhwIjoxNzg0MjQ1OTc1LCJpYXQiOjE3ODQyMTQxNzUsImlzcyI6InF1aXBwZS1hcGkiLCJhdWQiOiJxdWlwcGUtdWkifQ.XjiXorhB6A3neoLbpKyKzJCnjSv3bWWpzDWWY5QUN2Vi_vAO-ON6JYwZ46HMulgvvmexR_vS5HkTp75B_vVx5XJImv1s8NsCuUt5ixbkQ588_7wfAT6E2KTFGbuZHwZnjnXLsZyoz_mesHD1WuXl1RiL5o8l5hkYp5iIjn0sd73tOcnaxpPtrwwvNySVyYgb2FFJGrkoTpEiQ3G16wur2pCvGHDj1vwZ_Rc_jU0YDQET8LcVAu57p38G7jLBhR_UlFOdb34KsupAKYSBPKVPzMkiMgaVqsik5KvtRUL0JmvJhj6aCxJsAyjbgDG8muramPzBKZV9BvsBlN77T9DOwQ
```