---
title: "Récupérer les organisations"
method: POST
path: "/directory/organizations"
tags: ["Annuaire"]
---

# Récupérer les organisations

`POST /directory/organizations`

Permet de récupérer une liste de toutes les organisations visibles correspondant à tous les filtres de l'annuaire jusqu'à ce qu'il soit synchronisé (en utilisant le continuationToken). Si aucun filtre n'est spécifié, aucun filtre n'est appliqué. Les résultats sont classés par date de mise à jour de la visibilité API en ordre croissant. Une fois la liste synchronisée, seules les organisations avec une date de mise à jour de la visibilité API supérieure à la dernière organisation envoyée sont retournées (toujours en utilisant le continuationToken). Cela concerne les nouvelles organisations à insérer (souhaitant apparaître dans l'annuaire) ainsi que les anciennes à supprimer (ne souhaitant plus apparaître dans l'annuaire). Le nombre total de résultats (ou de pages) n'est pas récupérable, donc les informations de pagination retournées indiqueront toujours -1.<br/><br/><b>Votre clientId doit être autorisé à tous ces privilèges : </b> <br/> OrganizationOpenDirectory<br/><br/>

## Query parameters

- `pageSize` integer
- `continuationToken` string

## Request body

- HelloAssoApiV5CommonModelsDirectoryListOrganizationsRequest
  - `name` string, nullable — Textual search for organization name
  - `description` string, nullable — Textual search for organization description
  - `categories` string[], nullable — The categories of the organizations
  - `types` string[], nullable — The organization types
  - `zipCodes` string[], nullable — The zip codes where the organizations are located
  - `cities` string[], nullable — The cities where the organizations are located
  - `regions` string[], nullable — The regions where the organizations are located
  - `departments` string[], nullable — The departments where the organizations are located
  - `fiscalReceiptEligibility` boolean, nullable — Allow only organization with a fiscal receipt eligibility
  - `internalTags` string[], nullable — Allow only Organization with internal tags this filter is for special operations only
  - `tags` string[], nullable — Allow only Organization with public tags
  - `linkedPartners` string[], nullable — Allow only Organization with linked partners

## Response `200`

Success

- HelloAssoApiV5CommonModelsCommonResultsWithPaginationModelSynchronizableOrganizationModel — ResultsWithPaginationModel class
  - `data` HelloAssoApiV5CommonModelsDirectorySynchronizableOrganizationModel[], nullable — Data property
    - `action` 'Insert' | 'Delete'
    - `record` HelloAssoApiV5CommonModelsOrganizationsOrganizationBasicModel — A basic organization model
      - `url` string, nullable — The organization url
      - `organizationSlug` string, nullable — The organization slug
  - `pagination` HelloAssoApiV5CommonModelsCommonPaginationModel — Pagination model class
    - `pageSize` integer — Page size
    - `totalCount` integer — Total number of results available
    - `pageIndex` integer — Current page index
    - `totalPages` integer — Total number of pages of results with current page size
    - `continuationToken` string, nullable — Continuation Token to get next results

## Other responses

- `401` — Unauthorized, you must add a valid JWT into Authorization Header with the format : `Bearer TOKEN`
- `403` — The JWT token hasn't the privileges or Roles for this action

---

[API](https://skmtc.net/helloasso/apis/api-authentication-access-token.md) · [All operations](https://skmtc.net/helloasso/apis/api-authentication-access-token/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/helloasso/api-authentication-access-token/revisions/b8cd7d9ae24e/schema)