---
title: "List Onboarding Entities"
method: GET
path: "/entities"
tags: ["Entities"]
---

# List Onboarding Entities

`GET /entities`

## Request

- Base URL: `https://api.meow.com/v1`
- URL: `https://api.meow.com/v1/entities`
- Auth: API key in header `x-api-key`
- TypeScript: <https://skmtc.dev/meow/apis/meow-api/docs/entities/get.ts> (a function with typed inputs; its response is checked against the schema)

Lists the business entities being onboarded by your API key's user.

## Query parameters

- `limit` integer: Maximum number of results to return.
- `offset` string, nullable: Opaque offset identifier for pagination. Use the nextOffset from a previous response.

## Response `200`

Successful Response

- EntityOnboardingListResponse
  - `entities` EntityOnboardingSummary[], required: Business entities being onboarded by your API key's user.
    - `entity_id` string, uuid, required: Public ID of the onboarded business entity, stable across the onboarding lifecycle and matching the `entity_id` used in the Customer API, MCP, and webhook payloads.
    - `status` 'pending_document_upload' | 'pending_user_action' | 'submitted' | 'under_review' | 'approved' | 'rejected', required
    - `business_name` string, nullable, required: Legal business name.
    - `created_at` string, date-time, required: ISO 8601 date-time in the format `YYYY-MM-DDThh:mm:ss.nnn[Z|[+|-]hh:mm]` (per [IETF RFC 3339](https://xml2rfc.tools.ietf.org/public/rfc/html/rfc3339.html#anchor14)).
    - `updated_at` string, date-time, required: ISO 8601 date-time in the format `YYYY-MM-DDThh:mm:ss.nnn[Z|[+|-]hh:mm]` (per [IETF RFC 3339](https://xml2rfc.tools.ietf.org/public/rfc/html/rfc3339.html#anchor14)).
    - `onboarding_type` 'api' | 'smb' | 'mcp' | 'partner', required
  - `page` PageMetadata
    - `nextOffset` string, nullable: Opaque offset identifier.

## Other responses

- `400`: The request could not be processed.
- `401`: Authentication failed.
- `403`: The API key is not authorized for this operation.
- `429`: Too many requests.

---

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