---
title: "List Organizations"
method: GET
path: "/organizations"
tags: ["Organizations"]
---

# List Organizations

`GET /organizations`

Returns a list of organizations. You can filter by status or VAT ID to find specific organizations. You can use the `limit`, `page`, `sortBy` and `sortDirection` parameters to filter and sort the results.

## Query parameters

- `status` 'ONBOARDING_STARTED' | 'ONBOARDING_RISK_AND_COMPLIANCE' | 'ONBOARDING_MANDATES_AND_TERMS' | 'ACTIVE' | 'DEACTIVATED' | 'CANCELLED' — The status of the organization, see [our guides](/docs/organization-entity) for more details.
- `vatId` string
- `limit` integer
- `page` integer
- `sortBy` 'id' | 'name' | 'status' | 'createdAt'
- `sortDirection` 'ASC' | 'DESC'

## Response `200`

Ok

- object
  - `data` object[]
    - `organizationId` string, uuid — The id of the organization.
    - `name` string — The name of the organization.
    - `status` Schema — unresolved $ref
    - `vatId` string, nullable — The VAT ID of the organization, if available.
    - `cardAccounts` CardAccounts — unresolved $ref
    - `paymentProgramId` string, uuid — The id of the payment program this organization belongs to.
  - `hasNextPage` boolean — Indicates whether there is a next page available.

## Other responses

- `400` — unresolved $ref
- `401` — unresolved $ref
- `403` — unresolved $ref
- `429` — unresolved $ref
- `500` — unresolved $ref

---

[API](https://skmtc.dev/getpliant/apis/pliant-customer-api.md) · [All operations](https://skmtc.dev/getpliant/apis/pliant-customer-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/getpliant/pliant-customer-api/revisions/f3f589cfa718/schema)