---
title: "Search for organizations"
method: GET
path: "/org/search"
tags: ["Organizations"]
---

# Search for organizations

`GET /org/search`

This endpoint lets you search for organizations using filters. The response is paginated (30 results per page).

## Query parameters

- `org_id` integer
- `query` string
- `alias` string
- `page` integer
- `per_page` integer

## Response `200`

OK

- object — Result object return by the API
  - `page` integer — Current page number
  - `max_page` integer — Last page number
  - `count` integer — Number of resources complying with filters
  - `orgs` Org[] — The organizations complying with filter (30 max per page)
    - `org_id` integer — Unique identifier of an organization in Partoo.
    - `name` string — Organization name
    - `alias` string — Organization alias (should match regex `[a-z0-9_]`)
    - `provider` string — Organization provider
    - `type` 'small_medium_business' | 'enterprise' — Organization type
    - `features` Feature[] — List of organization's available features. Contains the features the organization can subscribe to as well as the ones only some businesses may have subscribed to additionally.
    - `org_features` Feature[] — List of organization's features. Only contains the features the organization has subscribed to.
    - `last_org_api_call` string — Date of the last API call made with one of the API keys linked to the organization
    - `max_businesses` integer, nullable — Maximum number of local businesses the organization can have. It does not include the global (brand) businesses. If null, there is no limit for the organization. This field can only be set by a `PROVIDER` user.

## Other responses

- `400` — Your request is incorrect
- `401` — You are not authenticated
- `403` — You are not allowed to perform this action

---

[API](https://skmtc.net/partoo/apis/partoo-rest-api.md) · [All operations](https://skmtc.net/partoo/apis/partoo-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/partoo/partoo-rest-api/revisions/3652d8b1a8b3/schema)