---
title: "List Models"
method: GET
path: "/api/v1/lookup/models"
tags: ["Lookup"]
---

# List Models

`GET /api/v1/lookup/models`

List unified models enabled for the caller's organization. Use `slug` as `model` when creating custom fields or mappings.

## Query parameters

- `category` 'HRIS' | 'ATS' | 'LMS'

## Response `200`

Successful Response

- ModelListResponse
  - `models` ModelListItem[], required
    - `slug` string, required — Stable identifier for the model. Use this as `model` when creating custom fields or mappings.
    - `display_name` string, required — Human-readable name of the model.
    - `category` 'HRIS' | 'ATS' | 'LMS', required

## Other responses

- `401` — Missing or invalid bearer authentication credentials.
- `403` — The credentials are valid but do not permit access to this resource, e.g. a connector token used on a different API category or a model whose writes are disabled.
- `422` — Validation Error
- `429` — Rate limit exceeded.

## Changes

- **2026-08-01** `eb3486b88e55` — 3 info
  - added the non-success response with the status `401`
  - added the non-success response with the status `403`
  - added the non-success response with the status `429`

[Change history](https://skmtc.dev/bindbee/apis/bindbee-apis/changes/api/v1/lookup/models/get.md)

---

[API](https://skmtc.dev/bindbee/apis/bindbee-apis.md) · [All operations](https://skmtc.dev/bindbee/apis/bindbee-apis/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/bindbee/bindbee-apis/revisions/a2669930898c/schema)