---
title: "List or search all organizations"
method: GET
path: "/organizations/"
tags: ["organizations"]
---

# List or search all organizations

`GET /organizations/`

## Query parameters

- `q` string
- `sort` 'name' | 'reuses' | 'datasets' | 'followers' | 'views' | 'created' | 'last_modified' | '-name' | '-reuses' | '-datasets' | '-followers' | '-views' | '-created' | '-last_modified'
- `page` integer
- `page_size` integer
- `badge` 'public-service' | 'certified' | 'association' | 'company' | 'local-authority'
- `name` string
- `business_number_id` string

## Headers

- `X-Fields` string, mask

## Response `200`

Success

- OrganizationPage
  - `data` OrganizationRead[] — The page data
    - `acronym` string
    - `badges` BadgeRead[]
      - `kind` string, required
    - `business_number_id` string
    - `created_at` string, date-time, required
    - `deleted` string, date-time
    - `description` string, markdown, required
    - `ext` object
    - `extras` object
    - `id` string, required
    - `image_url` string
    - `last_modified` string, date-time, required
    - `logo` string — URL of the image
    - `logo_thumbnail` string — URL of the cropped and squared image (100x100)
    - `members` MemberRead[]
      - `label` string
      - `role` 'admin' | 'editor' | 'partial_editor'
      - `since` string, date-time, required
      - `user` UserReferenceWithEmail
        - `class` string, required — The object class
        - `id` string, required — The object unique identifier
        - `avatar` string — URL of the image
        - `avatar_thumbnail` string — URL of the cropped and squared image (500x500)
        - `first_name` string, required
        - `last_name` string, required
        - `page` string — Link to the udata web page for this user
        - `slug` string, required
        - `uri` string — Link to the API endpoint for this user
        - `email` string — The user email, obfuscated unless the caller may see it
        - `last_login_at` string, date-time
    - `metrics` object
    - `name` string, required
    - `page` string — Link to the udata web page for this organization
    - `permissions` OrganizationPermissions
      - `delete` boolean
      - `edit` boolean
      - `harvest` boolean
      - `members` boolean
      - `private` boolean
    - `presentation_blocs` object[]
    - `presentation_blocs_published_at` string, date-time — Publication date of the organization presentation blocs. Set it to make the blocs publicly visible; leave it empty to keep them hidden (draft). Organization administrators always see the blocs regardless of this date.
    - `slug` string, required
    - `teams` TeamRead[]
    - `uri` string — Link to the API endpoint for this organization
    - `url` string
    - `zone` string
  - `next_page` string — The next page URL if exists
  - `page` integer, required — The current page
  - `page_size` integer, required — The page size used for pagination
  - `previous_page` string — The previous page URL if exists
  - `total` integer, required — The total paginated items

---

[API](https://skmtc.net/data-gouv-fr/apis/udata-api.md) · [All operations](https://skmtc.net/data-gouv-fr/apis/udata-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/data-gouv-fr/udata-api/revisions/c302b208f9a5/schema)